Настройте измерения для игр в магазине Steam

В данном руководстве описывается процесс создания игрового приложения в Steam, установления безопасного межсерверного подключения посредством API (S2S) и эффективного управления ссылками для успешного измерения атрибуции. Пользователи смогут загрузить игру через магазин Steam или ваш собственный магазин на платформах Windows и Mac.

Чтобы настроить измерение игр в Steam, необходимо выполнить следующие действия.

Настройте свое приложение в магазине Steam

Для того чтобы добавить и настроить приложение для ПК, выполните следующие действия:

В разделе AppView выберите Все приложения.
Нажмите Новое приложение.
В разделе Укажите сведения о приложении укажите название приложения, выберите валюту отчетности и проверьте:
- условие о соответствии требованиям COPPA (распространяется только на компании, осуществляющие свою деятельность на территории США; подробнее о соответствии требованиям COPPA см. здесь);
- условие о соблюдении Google закона DMA (распространяется только на приложения, пользовательская база которых находится за пределами Европейской экономической зоны (ЕЭЗ); подробнее о соблюдении Google закона DMA см. здесь).
Нажмите Добавить приложение.
Чтобы добавить платформу для игры, выберите Добавить платформу.
1. Нажмите ПК > Steam. Работает в магазинах Steam для Windows и Mac.
2. Введите идентификатор приложения или выберите пункт У меня еще нет идентификатора приложения, чтобы ввести его позже.
3. (Дополнительно) Включите параметр Перенаправить все клики на настраиваемый URL и введите Настраиваемый URL, чтобы перенаправить пользователей на настраиваемый веб-сайт вместо Steam. Мы рекомендуем сделать это, если у вашего приложения нет идентификатора App ID.
4. Нажмите Сохранить.

Чтобы измерять активность пользователей в игре, перейдите на вкладку События и добавьте название события в приложении.
На вкладке Настройки атрибуции настройте параметры атрибуции (сопоставление устройства, вероятностное моделирование и временная атрибуция) и реатрибуции.
- Проверьте, что вероятностное моделирование включено как для кликов, так и для показов. Настоятельно рекомендуется устанавливать окно атрибуции для вероятностного моделирования на 24 часа. Если вы хотите превысить 24-часовой лимит, обратитесь в отдел интеграции по адресу wizards@adjust.com.
На вкладке Управление данными можно настроить колбэки сервера или загрузку в облачное хранилище, чтобы получать необработанные данные о пользователях, или воспользоваться тестовой консолью для просмотра данных тестовых устройств.
На вкладке Защита настройте Защиту S2S запросов, поскольку токен понадобится при настройке API S2S.

Настройте API межсерверных сессий (S2S) Adjust

Используйте межсерверный API Adjust для подключения вашего приложения к Adjust и начните измерение сессий и событий пользователей без изменения кода вашего приложения.

Продолжайте процесс настройки, используя следующую конечную точку: session.

Начало работы

Сервер Adjust осуществляет строгую проверку согласованности, которая предотвращает попытки мошенничества или перегрузки системы. Межсерверная атрибуция представляет собой эксклюзивную интеграцию, которую нельзя использовать в сочетании с SDK Adjust.

Обязательно ознакомьтесь с нашим контрольным списком межсерверной атрибуции, чтобы полностью понять ограничения, связанные с использованием S2S вместо интеграции SDK.
Запросы к нашим серверам должны отправляться в том же порядке, в котором они выполнялись на устройстве.

Аутентификация

Функция межсерверной (S2S) безопасности позволяет гарантировать безопасность S2S-сессий и обеспечивает защиту от поддельных запросов. Для этого необходимо, чтобы каждый входящий запрос содержал токен аутентификации, созданный на панели управления Adjust. Запросы, не содержащие действительного токена или содержащие недействительный токен, отклоняются нашим сервером.

Конечная точка

С помощью конечной точки session осуществляется запись сеансов при запуске игры пользователями. Сессия запускается, когда пользователь возобновляет игру из фонового режима или запускает ее, например, открывая другое приложение, не выключая при этом игру, либо запуская ее после предыдущего закрытия. Во избежание излишнего использования ресурсов сервер Adjust принимает новые сессии каждые 30 минут.

https://s2s.adjust.com/session

Заголовок POST

Авторизация. При вызове API Adjust отправляйте значение токена аутентификации Adjust с типом аутентификации Bearer.

Пример: Bearer authentication_token.

Полезная нагрузка POST

Примечание:

Параметры, отмеченные *****, являются обязательными.

Параметр	Тип данных	Расположение	Описание
`s2s`*	Строка	Запрос	Межсерверный параметр: позволяет серверам Adjust распознавать активность на стороне сервера. Всегда должно быть отправлено значение «1».
`app_token`*	Строка	Запрос	Уникальный токен аутентификации для вашего приложения
`os_name`*	Строка	Запрос	Используйте один из доступных параметров в зависимости от ОС вашего приложения: `windows` `Mac OS` `steamos`
`ip_address`*	Строка	Запрос	IP-адрес устройства
`created_at`*	Временная отметка	Запрос	Временная метка локального устройства, создающего пакет, включая часовой пояс.
`external_device_id`*	Строка	Запрос	Уникальный идентификатор пользователя, пример: идентификатор аккаунта пользователя или зашифрованный адрес электронной почты

Совет:

Вы можете передать steam_id пользователя в Adjust с помощью параметра external_device_id.

Пример запроса

cURL

curl -X 'POST' -d 's2s=1&app_token=a1234b2x3a4o&ip_address=0.0.0.0&created_at=2018-03-23T09:46:47.288Z-0400&sent_at=2018-03-23T09:46:47.288Z-0400&external_device_id=099aa0bc' -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' -H 'User-Agent: Adjust Streaming Job (akka-http)' 'https://s2s.adjust.com/session'

Подробнее о том, как записывать события с помощью S2S API, см. раздел Межсерверные события (S2S).

Настройте ссылки

После настройки и тестирования интеграции API S2S между сервером вашего приложения и Adjust необходимо подключить Adjust к рекламной сети, в которой проводится кампания.

При использовании ссылок вы можете фиксировать атрибуцию при взаимодействии пользователей с вашей рекламой на других устройствах, например при просмотре рекламы на мобильном телефоне или на CTV-устройствах, а затем при установке игры на ПК. Ниже приведены два примера сетей для веб-кампаний.

Выполните приведенные далее шаги по настройке на вкладке Campaign Lab.

В разделе Campaign Lab выберите Партнеры.
Нажмите Новый партнер .
На экране Выбор партнера выберите рекламную сеть, которую вы хотите настроить.
На экране Выбор приложения выберите приложение, для которого требуется создать ссылку.
(Необязательно) На экране Обмен данными настройте интеграцию между вашей сетью и Adjust и параметры обмена данными.
На экране Структура ссылки проверьте параметры структуры ссылки по умолчанию, предоставленные сетью, и при необходимости измените значения.
(Дополнительно) На экране Места назначения пользователя настройте диплинк или добавьте данные для перенаправления и фолбэка для ссылки.
- Если вы хотите перенаправить пользователей на определенный магазин игр, обязательно укажите его URL в качестве дополнительного параметра перенаправления.
(Дополнительно) На экране Настройки атрибуции настройте собственные параметры атрибуции для новых и существующих пользователей. Настройки доступны только для кликов и показов. Если пропустить этот шаг, будут применены параметры атрибуции, заданные при настройке приложения.
- Убедитесь, что вероятностное моделирование включено как для кликов, так и для показов. Настоятельно рекомендуется установить окно атрибуции для вероятностного моделирования равным 24 часам, однако можно задать любое значение до 90 дней. 90-дневное окно атрибуции доступно только для ПК и консольных платформ.
На экране Проверка конфигурации проверьте значения параметров и внесите необходимые изменения.
Нажмите Создать ссылку , чтобы создать URL клика, URL показа, QR-код и токен ссылки. Если вы настроили обмен данными, эта функция также будет активирована при создании ссылки.