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

Настройка Appreciate DSP by Digital Turbine

Appreciate DSP by Digital Turbine — рекламная сеть, интегрированная с Adjust. Интеграция с нашей системой позволяет передавать в Appreciate DSP by Digital Turbine данные об атрибуции и событиях в приложении посредством автоматических колбэков.

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

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

Требования

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

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

APPRECIATE YID

  • Чтобы узнать, как найти ваши учетные данные, обратитесь к своему представителю Appreciate DSP by Digital Turbine.

Выберите Appreciate DSP by Digital Turbine и свое приложение в Campaign Lab

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

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

Включите обмен данными, чтобы активировать интеграцию с Appreciate DSP by Digital Turbine. Чтобы включить обмен данными:

  1. Введите APPRECIATE YID.

После включения обмена данными с Appreciate DSP by Digital Turbine, Adjust автоматически отправляет Appreciate DSP by Digital Turbine следующие данные (по умолчанию).

  • установка
  • сеанс
  • событие
  • Отклоненная установка

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

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

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

В разделе К чему будет предоставлен доступ? отметьте действия, которые Adjust будет передавать Appreciate DSP by Digital Turbine по умолчанию.

  • установка
  • сеанс
  • событие
  • Отклоненная установка

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

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

  1. В разделе Какими источниками данных вы хотите поделиться? выберите источник атрибуции данных, которые вы хотите передавать Appreciate DSP by Digital Turbine:
  • Данные из всех источников атрибуции
  • Только данные, атрибутированные партнеру Appreciate DSP by Digital Turbine

Расходы на рекламу

Передача данных о расходах на рекламу позволит Appreciate DSP by Digital Turbine получать данные о расходах на рекламу по пользователям. Таким образом Appreciate DSP by Digital Turbine может использовать данные о расходах на рекламу для оптимизации кампаний.

Adjust отправляет Appreciate DSP by Digital Turbine данные о расходах на рекламу, полученные только через колбэки. Эти данные поступают из следующих настроенных вами решений, применимых к Appreciate DSP by Digital Turbine:

Если Appreciate DSP by Digital Turbine необходимо получить полные данные о расходах на рекламу, то можно настроить для Appreciate DSP by Digital Turbine экспорт данных о расходах на рекламу в стороннее хранилище. 

Решение для роста:

Эта функция доступна в рамках пакета SpendWorks от Adjust. По вопросам приобретения пакета SpendWorks свяжитесь с вашим представителем отдела продаж.

Сессии

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

Доход в приложении (от покупок в приложении)

Передача данных о доходе в приложении позволяет Appreciate DSP by Digital Turbine получать данные не только о сумме дохода, но и о событии дохода. Чтобы делиться этими данными, необходимо сопоставить события, генерирующие доход.

Сопоставление событий

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

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

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

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

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

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

  2. В списке Событие Adjust выберите событие Adjust, которым вы хотите поделиться с Appreciate DSP by Digital Turbine.

  3. В разделе «Событие партнера» необходимо выбрать событие Appreciate DSP by Digital Turbine, соответствующее событию Adjust.

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

      • Нажмите «Использовать сопоставление конкретной платформы», чтобы сопоставить отдельные события на уровне платформы или не сопоставлять события для определенных платформ.
      • Нажмите «Использовать глобальное сопоставление», чтобы отобразить одни и те же события для всех платформ.

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

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

Теперь Appreciate DSP by Digital Turbine будет получать данные о событии в приложении по каждому связанному событию.

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

Если Appreciate DSP by Digital Turbine поддерживает автоматическое сопоставление всех событий, в разделе «Сопоставление событий» нажмите «Сопоставить все события». Это экономит время при сопоставлении отдельных событий.

Теперь Appreciate DSP by Digital Turbine будет получать данные о событии в приложении по каждому из ваших связанных событий.

Сопоставьте параметры

Чтобы делиться настраиваемыми данными с Appreciate DSP by Digital Turbine, обычно требуется сопоставить параметры.

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

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

Чтобы передавать Appreciate DSP by Digital Turbine параметры партнера, выполните следующие действия:

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

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

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

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

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

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

Сконфигурируйте ссылки и настройки

Вы можете настроить следующие параметры:

Создайте ссылку и поделитесь ей с Appreciate DSP by Digital Turbine

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

  • Выбранное приложение
  • Параметры обмена данными
  • Параметры структуры ссылки
  • Места назначения пользователей
  • Настройки атрибуции

Нажмите Создать ссылку, чтобы создать URL клика, URL показа, QR-код и токен ссылки. При создании ссылки также включается обмен данными и интеграция с Appreciate DSP by Digital Turbine.

После того как ссылка создана, поделитесь ей с Appreciate DSP by Digital Turbine для размещения в кампании.

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

Appreciate DSP получает подробную информацию с уровня кампании только для данных кампании, атрибутированных через Appreciate DSP.

Список всех параметров, передаваемых Appreciate DSP by Digital Turbine

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

ПлейсхолдерИнформация
{api_level}Уровень API (только Android)
{city}Город, в котором используется устройство
{click_attribution_window}Настройки окна атрибуции для сопоставления устройства (часы)
{cost_amount}Стоимость вовлечения пользователя (доступна только для отслеживания расходов на рекламу)
{cost_currency}Валютный код ISO 4217 для данных о расходах (доступен только для отслеживания расходов на рекламу)
{cost_id_md5}Хэш MD5 идентификатора затрат, предоставленного сетью с использованием нашего API расходов на рекламу (доступно только для отслеживания расходов на рекламу)
{cost_type}Модель ценообразования кампании (доступна только для отслеживания расходов на рекламу)
{country_subdivision}Подраздел устройства по стране, например штат или область
{country}Код страны устройства из двух символов
{currency}Исходный валютный код ISO 4217, отправленный из Adjust SDK
{deeplink}URL-адрес диплинка, добавленный в конец URL-адреса для клика
{device_name}Номер модели устройства
{device_type}Тип устройства
{idfa||gps_adid}Идентификатор IDFA или GPS ADID ID, если IDFA пуст
{impression_attribution_window}Настройки окна атрибуции для сопоставления просмотров (часы)
{ip_address}IP-адрес устройства
{is_reattributed}1 — если пользователь был реатрибутирован хотя бы раз из более раннего источника. 0 — если пользователь никогда не был реатрибутирован
{isp}Поставщик услуг интернета для устройства
{label}Значение параметра «label» Adjust, отправляемое по клику
{language}Код языка устройства из двух символов
{last_time_spent}Длительность последнего сеанса пользователя в секундах
{lifetime_session_count}Количество сеансов, зарегистрированных за весь жизненный цикл пользователя
{match_type}Метод атрибуции
{mcc}Телефонный код страны — трехзначный код, идентифицирующий страну, в которой устройство используется. Добавив код мобильной сети, можно определить оператора устройства.
{mnc}Код мобильной сети — двухзначный код. Добавив телефонный код страны, можно определить оператора устройства.
{os_name}Операционная система устройства
{os_version}Номер версии операционной системы
{partner_parameters}Пользовательские параметры партнера, собираемые запросом Adjust SDK или S2S и передаваемые сторонним поставщикам с помощью постбэков
{postal_code}Почтовый индекс по IP-адресу устройства
{reattribution_attribution_window}Настройки окна атрибуции для реатрибуции (часы)
{reftag}Случайный исходный тег устройства
{region}Региональный код устройства
{revenue_float}Доход в том виде, в котором он отправлен из Adjust SDK, в целых валютных единицах
{revenue_usd_cents}Выручка в центах США
{sdk_version}Версия SDK Adjust (для приложения)
{session_count}Количество сеансов, записанных текущим Adjust SDK
{time_spent}Продолжительность текущего сеанса пользователя в секундах
{timezone}Часовой пояс устройства
{tracking_limited}1 — если отслеживание ограничено, 0 — если нет
{user_agent}Входящий необработанный user agent
{win_adid}Идентификатор рекламы Windows
{activity_kind}Тип действия пользователя
{adgroup_name}Название группы объявлений (как прописано в трекере)
{app_id}Идентификатор App Store или Google Play Store
{campaign_name}Название кампании (как прописано в трекере)
{click_time}Временная отметка атрибутированного клика
{connection_type}Тип интернет-соединения
{conversion_duration}Время между кликом и установкой или реатрибуцией в секундах
{creative_name}Название креатива, как прописано в трекере
{engagement_time}Временная отметка вовлечения
{impression_based}1 — если вовлечение на основе просмотра, 0 — если нет
{impression_time}Временная отметка атрибутированного просмотра
{installed_at}Временная отметка установки (т. е. первого открытия приложения)
{is_organic}1 — если трафик органический, 0 — если неорганический
{last_session_time}Временная отметка последнего сеанса
{last_tracker}Токен трекера Adjust для исходного трекера реатрибуцированного пользователя, состоящий из шести символов
{network_name}Название сети (как прописано в трекере)
{reattributed_at}Временная отметка реатрибуции
{rejection_reason}Причина отклонения атрибуции
{tracker}Токен трекера Adjust, состоящий из шести символов