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

Настройка Precog for App

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

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

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

Требования

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

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

API KEY, DATABASE NAME и TABLE NAME

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

Выберите Precog for App и свое приложение в Campaign Lab

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

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

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

  1. Введите API KEY, DATABASE NAME и TABLE NAME.

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

  • клик / click
  • Показ
  • Установка
  • Сессия
  • Удаление приложения
  • Переустановка
  • повторная атрибуция переустановки
  • реатрибуция

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

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

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

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

  • клик / click
  • Показ
  • Установка
  • Сессия
  • Удаление приложения
  • Переустановка
  • повторная атрибуция переустановки
  • реатрибуция

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

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

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

Сессии

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

Удаления или повторные установки

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

Примечание:

Для приложений под управлением iOS можно ожидать небольшого количества удалений и/или переустановок. Дополнительные сведения см. в разделе Оценка удалений и переустановок.

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

Передача данных о доходе в приложении позволяет Precog for App получать данные не только о сумме дохода, но и о событии дохода. Чтобы делиться этими данными, необходимо сопоставить события, генерирующие доход.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Включите Precog for App для своего приложения

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

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

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

Список всех параметров, передаваемых Precog for App

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

ПлейсхолдерИнформация
{city}Город, в котором используется устройство
{click_attribution_window}Настройки окна атрибуции для сопоставления устройства (часы)
{country_subdivision}Подраздел устройства по стране, например штат или область
{country}Двузначный код страны устройства
{currency}Исходный код валюты по ISO 4217, отправленный из Adjust SDK
{deeplink}URL-адрес диплинка, добавленный в конец URL-адреса для клика
{device_name}Номер модели устройства
{device_type}типа устройства
{environment}Текущая настройка среды Adjust SDK
{event_name}Имя события, как задано на панели управления
{gclid}Идентификатор клика Google
{idfa||android_id}IDFA или Android ID, если IDFA пуст
{idfa||gps_adid}IDFA или GPS ADID, если IDFA пуст
{idfv}Идентификатор поставщика iOS, в верхнем регистре
{impression_attribution_window}Настройки окна атрибуции для сопоставления просмотров (часы)
{inactive_user_definition}Период бездействия, требуемый для реатрибуции (часы)
{ip_address}IP-адрес устройства
{language}Код языка устройства из двух символов
{last_time_spent}Длительность последнего сеанса пользователя в секундах
{match_type}метод атрибуции
{mnc}Код мобильной сети — двухзначный код. Добавив телефонный код страны, можно определить оператора устройства.
{nonce}Случайная буквенно-цифровая строка в нижнем регистре (уникальная для каждого колбэка)
{os_name}Операционная система устройства
{os_version}Номер версии операционной системы
{partner_parameters}Пользовательские параметры партнера, собираемые запросом Adjust SDK или S2S и передаваемые сторонним поставщикам с помощью постбэков
{postal_code}Почтовый индекс по IP-адресу устройства
{random_user_id}Случайный идентификатор пользователя (для устройства)
{random}Случайное число (уникальное для каждого колбэка)
{reattribution_attribution_window}Настройки окна атрибуции для реатрибуции (часы)
{reftag}Случайный исходный тег устройства
{region}Региональный код устройства
{revenue_float}Доход в том виде, в котором он отправлен из Adjust SDK, в целых валютных единицах
{revenue_usd_cents}Выручка в центах США
{revenue}Доход в том виде, в котором он отправлен из Adjust SDK, в центах
{search_term}Запрос органического поиска Google
{session_count}Количество сеансов, записанных текущим Adjust SDK
{time_spent}Продолжительность текущего сеанса пользователя в секундах
{timezone}Часовой пояс устройства
{tracking_enabled}1 — если отслеживание включено, 0 — если нет
{tracking_limited}1 — если отслеживание ограничено, 0 — если нет
{user_agent}Входящий необработанный user agent
{activity_kind}Тип действия пользователя
{adgroup_name}Название группы объявлений (как прописано в трекере)
{app_id}Идентификатор App Store или Google Play
{app_name}Имя приложения
{campaign_name}Название кампании (как прописано в трекере)
{click_referer}Заголовок источника ссылки из клика
{click_time}Временная отметка атрибутированного клика
{connection_type}Тип интернет-соединения
{conversion_duration}Время между кликом и установкой или реатрибуцией в секундах
{created_at}Временная отметка действия
{creative_name}Название креатива (как прописано в трекере)
{engagement_time}Временная отметка вовлечения
{installed_at}Временная отметка установки (т. е. первого открытия приложения)
{is_organic}1 – если трафик органический, 0 – если неорганический
{last_tracker_name}Предыдущее название трекера реатрибуцированного пользователя
{last_tracker}Токен трекера Adjust для исходного трекера реатрибуцированного пользователя, состоящий из шести символов
{network_name}Название сети (как прописано в трекере)
{reattributed_at}Временная отметка реатрибуции
{store}Целевой магазин клика
{tracker_name}Текущее название трекера
{tracker}Токен трекера Adjust, состоящий из шести символов