Мы постоянно публикуем обновления документации, которые могут быть недоступны на вашем языке. Наиболее актуальные сведения содержатся в версии на английском языке.

Настройте измерения для игр Microsoft Store и нативных игр для ПК

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

В данном руководстве описывается процесс создания нового игрового приложения, установления безопасного межсерверного API-соединения (S2S) и эффективного управления ссылками для успешного измерения атрибуции.

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

  1. Настройте новое приложение с помощью AppView.
  2. Настройте API S2S Adjust, чтобы начать запись сессий.
  3. Настройте ссылки с помощью Campaign Lab.

Настройте свое приложение для ПК

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

  1. В разделе AppView выберите Все приложения .

  2. Нажмите Новое приложение .

  3. В разделе Укажите сведения о приложении укажите название приложения, выберите валюту отчетности и проверьте:

    • условие о соответствии требованиям COPPA (распространяется только на компании, осуществляющие свою деятельность на территории США; подробнее о соответствии требованиям COPPA см. здесь);
    • условие о соблюдении Google закона DMA распространяется только на приложения, пользовательская база которых находится за пределами Европейской экономической зоны (ЕЭЗ); подробнее о соблюдении Google закона DMA см. здесь).
  4. Нажмите Добавить приложение .

  5. Чтобы добавить платформу для игры, выберите Добавить платформу .

    1. Нажмите ПК > Windows .

    2. Подключитесь к платформе, используя один из двух вариантов:

      • Если ваша игра доступна в Microsoft Store, выберите Microsoft Store и введите идентификатор приложения или выберите пункт У меня еще нет идентификатора приложения , чтобы ввести его позже.
      • Если ваша игра доступна в пользовательском магазине для Windows или Mac, выберите Native PC , включите Перенаправить все клики на настраиваемый URL и введите URL.
    3. Нажмите Сохранить .

  1. В разделе Информация о приложении можно настроить показ ссылок на игру при отправке ссылок через приложения социальных сетей.

  2. Чтобы измерять активность пользователей в игре, перейдите на вкладку События и добавьте название события в приложении.

  3. На вкладке Настройки атрибуции настройте параметры атрибуции (сопоставление устройства, вероятностное моделирование и временная атрибуция) и реатрибуции.

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

  5. На вкладке Защита настройте Защиту 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
ip_address*СтрокаЗапросIP-адрес устройства
created_at*Временная отметкаЗапросВременная метка локального устройства, создающего пакет, включая часовой пояс.
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.

  1. В разделе Campaign Lab выберите Партнеры.

  2. Нажмите Новый партнер .

  3. На экране Выбор партнера выберите рекламную сеть, которую вы хотите настроить.

  4. На экране Выбор приложения выберите приложение, для которого требуется создать ссылку.

  5. (Необязательно) На экране Обмен данными настройте интеграцию между вашей сетью и Adjust и параметры обмена данными.

  6. На экране Структура ссылки проверьте параметры структуры ссылки по умолчанию, предоставленные сетью, и при необходимости измените значения.

  7. (Дополнительно) На экране Места назначения пользователя настройте диплинк или добавьте данные для перенаправления и фолбэка для ссылки.

    • Если вы хотите перенаправить пользователей на определенный магазин игр, обязательно укажите его URL в качестве дополнительного параметра перенаправления.
  8. (Дополнительно) На экране Настройки атрибуции настройте собственные параметры атрибуции для новых и существующих пользователей. Настройки доступны только для кликов и показов. Если пропустить этот шаг, будут применены параметры атрибуции, заданные при настройке приложения.

    • Убедитесь, что вероятностное моделирование включено как для кликов, так и для показов. Настоятельно рекомендуется установить окно атрибуции для вероятностного моделирования равным 24 часам, однако можно задать любое значение до 90 дней. 90-дневное окно атрибуции доступно только для ПК и консольных платформ.
  9. На экране Проверка конфигурации проверьте значения параметров и внесите необходимые изменения.

  10. Нажмите Создать ссылку , чтобы создать URL клика, URL показа, QR-код и токен ссылки. Если вы настроили обмен данными, эта функция также будет активирована при создании ссылки.