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

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

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

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

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

Настройте свое приложение

Чтобы добавить и настроить приложение Nintendo, выполните следующие действия:

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

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

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

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

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

    1. Выберите Консоль > Nintendo .
    2. Введите идентификатор приложения или выберите пункт У меня еще нет идентификатора приложения , чтобы ввести его позже. Простой способ узнать App ID — посмотреть URL-адрес магазина игры. Например: https://www.nintendo.com/store/products/{APP_ID}.
    3. (Дополнительно) Включите параметр Перенаправить все клики на настраиваемый URL и введите Настраиваемый URL , чтобы перенаправить пользователей на настраиваемый веб-сайт вместо My Nintendo Store. Мы рекомендуем сделать это, если у вашего приложения нет идентификатора App ID.
    4. Нажмите Сохранить .
  1. Чтобы измерять активность пользователей в игре, перейдите на вкладку События и добавьте название события в приложении.

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

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

  4. На вкладке Защита настройте Защиту S2S запросов, поскольку токен понадобится при настройке API S2S.

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

<Draft or missing fragment>

ПараметрТип данныхРасположениеОписание
s2s*СтрокаЗапросВсегда должно быть отправлено значение «1».
Межсерверный режим позволяет серверам Adjust распознавать активность на стороне сервера.
app_token*СтрокаЗапросУникальный токен аутентификации для вашего приложения
os_name*СтрокаЗапросИспользуйте nintendo
`ip_address*СтрокаЗапросIP-адрес устройства
created_at*Временная отметкаЗапросВременная метка локального устройства, создающего пакет, включая часовой пояс.
external_device_id*СтрокаЗапросУникальный идентификатор платформы. Используйте switch_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-код и токен ссылки. Если вы настроили обмен данными, эта функция также будет активирована при создании ссылки.