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

Настройка Treasure Data

Treasure Data — партнёр по аналитике, интегрированный с Adjust. Интеграция с нашей системой позволяет Treasure Data получать данные, отслеживаемые в Adjust, посредством автоматических колбэков. Обрабатывая эти данные при помощи своих инструментов, партнеры предоставляют вам более подробные сведения и аналитику.

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

Перед началом работы

Требования

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Учетные данные

API KEY, DB ID и TABLE ID

  • Чтобы узнать, как найти ваши учетные данные, обратитесь к своему представителю Treasure Data.

Выберите Treasure Data и свое приложение в Campaign Lab

  1. В разделе Campaign Lab выберите Партнеры .
  2. Выберите Новый партнер > Treasure Data . Выберите Далее , чтобы перейти к следующему экрану.
  3. На экране Выбор приложения выберите приложение, для которого вы хотите создать ссылку и включите интеграцию, чтобы поделиться данными с Treasure Data.
  4. Нажмите Далее .

Включение обмена данными

Включите обмен данными, чтобы активировать интеграцию с Treasure Data. Чтобы включить обмен данными

  1. Введите API KEY, DB ID и TABLE ID.

После включения обмена данными с Treasure Data, Adjust автоматически отправляет Treasure Data следующие данные (по умолчанию).

  • клик / click
  • установка
  • сеанс
  • реатрибуция
  • событие

Настройте параметры обмена данными

При работе с мультиплатформенными приложениями с возможностью совместного использования данных для нескольких платформ вы можете:

  1. Разделить параметры обмена данными на уровне платформы, выбрав Использовать настройки для определенной платформы .
  2. Установить одинаковые настройки обмена данными для нескольких платформ, выбрав Использовать глобальные настройки .

В разделе К чему будет предоставлен доступ? отметьте действия, которые Adjust будет передавать Treasure Data по умолчанию:

  • клик / click
  • установка
  • сеанс
  • реатрибуция
  • событие

Отправка дополнительных данных

Выберите объем и тип данных для передачи Treasure Data посредством колбэков. Treasure Data может использовать эту информацию для оптимизации производительности.

Для отправки дополнительных данных можно просмотреть и настроить следующие параметры:

Сессии

Adjust не отправляет автоматически колбэки сессий из-за большого количества сессий. Передача данных о сессиях позволяет Treasure Data получать данные о сессиях в вашем приложении.

Сопоставьте события

Сопоставьте события, которые хотите передавать, со значениями, которые Treasure Data может получать. Данные событий, которые вы не сопоставили, не могут быть переданы Treasure Data.

Составить отдельные события

Если у вас мультиплатформенное приложение, вы можете выбрать разные события для каждой платформы и поделиться ими Treasure Data. Это позволяет вам:

  • настроить отдельные события для управления стратегиями кампаний для каждой платформы;
  • настроить обмен данными для каждой платформы.

В разделе Сопоставление событий выполните следующие действия, чтобы выбрать события в приложении, данные о которых следует передавать Treasure Data:

  1. Выберите Сопоставить событие .

  2. В списке Событие Adjust выберите событие Adjust, которым вы хотите поделиться с Treasure Data.

  3. В разделе Событие партнера необходимо выбрать событие Treasure Data, соответствующее событию Adjust.

    1. Для одноплатформенных и мультиплатформенных приложений, в которых обмен данными включен только для одной платформы, выполняется сопоставление событий только для этой платформы. Для мультиплатформенных приложений с возможностью совместного использования данных для нескольких платформ вы можете:

      • нажать Использовать сопоставление конкретной платформы , чтобы сопоставить отдельные события на уровне платформы или не сопоставлять события для определенных платформ;
      • нажать Использовать глобальное сопоставление , чтобы отобразить одни и те же события для всех платформ.
    2. В списке Событие партнера выберите или введите имя настраиваемого события, которое нужно сопоставить с событием Adjust.

  4. Нажмите Применить .

Теперь Treasure Data будет получать данные о событии в приложении по каждому связанному событию.

Сопоставить все события

Если Treasure Data поддерживает автоматическое сопоставление всех событий, в разделе Сопоставление событий нажмите Сопоставить все события . Это экономит время при сопоставлении отдельных событий.

Теперь Treasure Data будет получать данные о событии в приложении по каждому из ваших связанных событий.

Сопоставление параметров

Чтобы делиться настраиваемыми данными с Treasure Data, обычно требуется сопоставить параметры.

Параметры партнера (доступно в Adjust SDK версии 4.0+) позволяют Adjust собирать настраиваемые наборы данных в вашем приложении и перенаправлять их непосредственно Treasure Data. Таким образом Treasure Data будет получать указанные сведения по каждому связанному событию.

Прежде чем добавлять новые параметры партнера в Adjust SDK, убедитесь, что ни один из ранее введенных параметров партнера не соответствует вашим требованиям.

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

  1. Настройте параметры партнера в Adjust SDK.

    • Проверьте раздел Начало работы для всех ссылок на платформу разработки SDK.
  2. В разделе Выберите параметры обмена данными нажмите Параметры .

  3. В разделе Сопоставить параметры можно указать способ отправки в сеть параметров партнера, заданных в SDK:

    1. Выберите Сопоставить параметр .
    2. В поле Параметр SDK укажите имя параметра SDK, который следует отправить в сеть.
    3. В поле Параметр партнера укажите параметр сети, соответствующий параметру SDK.
Примечание:

Примечание. Если параметры партнера настроены в Adjust SDK без настройки передачи параметров на панели управления, Adjust будет передавать эти параметры с тем же названием, что и в Adjust SDK.

Включите Treasure Data для своего приложения

На экране Проверка настройки вы можете просмотреть выбранные варианты. Вы можете вернуться и внести изменения в следующие настройки:

  • Выбранное приложение
  • Параметры обмена данными

Выберите Включить партнера , чтобы включить Treasure Data для вашего приложения. Партнеры по аналитике не работают со ссылками для кампаний. После включения наша интеграция передает данные об атрибуции и событиях в приложении посредством автоматических колбэков.

Инструкции по настройке для конкретных партнеров

Сервис Treasure Data доступен в ряде регионов. Выберите соответствующий регион в выпадающем меню, чтобы передавать данные в конечную точку, соответствующую вашему региону.

Список всех параметров, передаваемых Treasure Data

Treasure Data требует от Adjust отправлять следующие параметры (точки данных) вместе с колбэками:

ПлейсхолдерИнформация
{android_id}Android ID (только для Android)
{country}Код страны устройства из двух символов
{device_name}Номер модели устройства
{gps_adid}Рекламный идентификатор магазина Google Play
{idfa}Идентификатор IDFA (только для iOS)
{idfa||gps_adid}Идентификатор IDFA или GPS ADID ID, если IDFA пуст
{idfv}Идентификатор поставщика iOS, в верхнем регистре
{ip_address}IP-адрес устройства
{language}Код языка устройства из двух символов
{os_name}Операционная система устройства
{os_version}Номер версии операционной системы
{partner_parameters}Пользовательские параметры партнера, собираемые запросом Adjust SDK или S2S и передаваемые сторонним поставщикам с помощью постбэков
{user_agent}Входящий необработанный user agent
{adgroup_name}Название группы объявлений (как прописано в трекере)
{app_version}Номер версии приложения (Android), номер версии сборки пакета (iOS)
{campaign_name}Название кампании (как прописано в трекере)
{click_time}Временная отметка атрибутированного клика
{created_at}Временная отметка действия
{creative_name}Название креатива, как прописано в трекере
{network_name}Название сети (как прописано в трекере)