Настройка Cognant
Cognant — рекламная сеть, интегрированная с Adjust. Интеграция с нашей системой позволяет передавать в Cognant данные об атрибуции и событиях в приложении посредством автоматических колбэков.
Из этой статьи вы узнаете, как настроить измерение с помощью Cognant для вашего приложения. Речь пойдет об активации интеграции, создании ссылки на кампанию и выборе данных, которые Adjust может передавать Cognant.
Перед началом работы
Требования
- Доступ к администрированию, редактированию или настраиваемый доступ к редактированию в Adjust.
- Adjust SDK версии 4.0.0 и более поздних версий для сопоставления параметров SDK с параметрами Cognant. Для использования этой функции следуйте приведенным ниже инструкциям.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Учетные данные
MZ CODE
- Чтобы узнать, как найти ваши учетные данные, обратитесь к своему представителю Cognant.
Выберите Cognant и свое приложение в Campaign Lab
- В разделе Campaign Lab выберите Партнеры.
- Выберите Новый партнер > Cognant. Выберите Далее, чтобы перейти к следующему экрану.
- На экране Выбор приложения выберите приложение, для которого вы хотите создать ссылку и включите интеграцию, чтобы поделиться данными с Cognant.
- Нажмите Далее.
Включение обмена данными
Включите обмен данными, чтобы активировать интеграцию с Cognant. Чтобы включить обмен данными:
- Введите MZ CODE.
После включения обмена данными с Cognant, Adjust автоматически отправляет Cognant следующие данные (по умолчанию).
- клик / click
- установка
- сеанс
- реатрибуция
- событие
Настройте параметры обмена данными
При работе с мультиплатформенными приложениями с возможностью совместного использования данных для нескольких платформ вы можете:
- Разделить параметры обмена данными на уровне платформы, выбрав Использовать настройки для определенной платформы.
- Установить одинаковые настройки обмена данными для нескольких платформ, выбрав Использовать глобальные настройки.
В разделе К чему будет предоставлен доступ? отметьте действия, которые Adjust будет передавать Cognant по умолчанию.
- клик / click
- установка
- сеанс
- реатрибуция
- событие
Отправка дополнительных данных
Выберите объем и тип данных для передачи Cognant посредством колбэков. Cognant может использовать эту информацию для оптимизации производительности.
- В разделе Какими источниками данных вы хотите поделиться? выберите источник атрибуции данных, которые вы хотите передавать Cognant:
- Данные из всех источников атрибуции
- Только данные, атрибутированные партнеру Cognant
Сессии
Adjust не отправляет автоматически колбэки сессий из-за большого количества сессий. Передача данных о сессиях позволяет Cognant получать данные о сессиях в вашем приложении.
Доход в приложении (от покупок в приложении)
Передача данных о доходе в приложении позволяет Cognant получать данные не только о сумме дохода, но и о событии дохода. Чтобы делиться этими данными, необходимо сопоставить события, генерирующие доход.
Сопоставление событий
Сопоставьте события, которые хотите передавать, со значениями, которые Cognant может получать. Данные событий, которые вы не сопоставили, не могут быть переданы Cognant.
Составить отдельные события
Если у вас мультиплатформенное приложение, вы можете выбрать разные события для каждой платформы и поделиться ими Cognant. Это позволяет вам:
- настроить отдельные события для управления стратегиями кампаний для каждой платформы;
- настроить обмен данными для каждой платформы.
В разделе Сопоставление событий выполните следующие действия, чтобы выбрать события в приложении, данные о которых следует передавать Cognant:
Выберите Сопоставить событие.
В списке Событие Adjust выберите событие Adjust, которым вы хотите поделиться с Cognant.
В разделе «Событие партнера» необходимо выбрать событие Cognant, соответствующее событию Adjust.
Для одноплатформенных и многоплатформенных приложений, в которых обмен данными включен только для одной платформы, выполняется сопоставление событий только для этой платформы. Для мультиплатформенных приложений с возможностью совместного использования данных для нескольких платформ вы можете:
- Нажмите «Использовать сопоставление конкретной платформы», чтобы сопоставить отдельные события на уровне платформы или не сопоставлять события для определенных платформ.
- Нажмите «Использовать глобальное сопоставление», чтобы отобразить одни и те же события для всех платформ.
В списке Событие партнера выберите или введите имя настраиваемого события, которое нужно сопоставить с событием Adjust.
Нажмите Применить.
Теперь Cognant будет получать данные о событии в приложении по каждому связанному событию.
Сопоставить все события
Если Cognant поддерживает автоматическое сопоставление всех событий, в разделе «Сопоставление событий» нажмите «Сопоставить все события». Это экономит время при сопоставлении отдельных событий.
Теперь Cognant будет получать данные о событии в приложении по каждому из ваших связанных событий.
Сопоставьте параметры
Чтобы делиться настраиваемыми данными с Cognant, обычно требуется сопоставить параметры.
Параметры партнера (доступно в Adjust SDK версии 4.0+) позволяют Adjust собирать настраиваемые наборы данных в вашем приложении и перенаправлять их непосредственно Cognant. Таким образом Cognant будет получать указанные сведения по каждому связанному событию.
Прежде чем добавлять новые параметры партнера в Adjust SDK, убедитесь, что ни один из ранее введенных параметров партнера не соответствует вашим требованиям.
Чтобы передавать Cognant параметры партнера, выполните следующие действия:
Настройте параметры партнера в Adjust SDK.
- Проверьте раздел Начало работы для всех ссылок на платформу разработки SDK.
В разделе Выберите параметры обмена данными нажмите Параметры.
В разделе Сопоставить параметры можно указать способ отправки в сеть параметров партнера, заданных в SDK:
- Выберите Сопоставить параметр.
- В поле Параметр SDK укажите имя параметра SDK, который следует отправить в сеть.
- В поле Параметр партнера укажите параметр сети, соответствующий параметру SDK.
Примечание. Если параметры партнера настроены в Adjust SDK без настройки передачи параметров на панели управления, Adjust будет передавать эти параметры с тем же названием, что и в Adjust SDK.
Сконфигурируйте ссылки и настройки
Вы можете настроить следующие параметры:
Создайте ссылку и поделитесь ей с Cognant
На экране Проверка настройки вы можете просмотреть выбранные варианты. Вы можете вернуться и внести изменения в следующие настройки:
- Выбранное приложение
- Параметры обмена данными
- Параметры структуры ссылки
- Места назначения пользователей
- Настройки атрибуции
Нажмите Создать ссылку, чтобы создать URL клика, URL показа, QR-код и токен ссылки. При создании ссылки также включается обмен данными и интеграция с Cognant.
После того как ссылка создана, поделитесь ей с Cognant для размещения в кампании.
Инструкции по настройке для конкретных партнеров
При активации модуля вы сможете выбрать конечную точку передачи колбэков. Перед вами появятся переключатели «Только конечная точка подготовки» и «Только конечная точка продакшна».
Можно включить сразу оба переключателя или выбрать один из них. Обратите внимание, что, если оба переключателя ОТКЛЮЧЕНЫ, никакие колбэки передаваться НЕ БУДУТ.
Список всех параметров, передаваемых Cognant
Cognant требует от Adjust отправлять следующие параметры (точки данных) вместе с колбэками:
Плейсхолдер | Информация |
{adid} | Идентификатор устройства Adjust (все платформы) |
{android_id_md5} | Android ID в нижнем регистре, шестнадцатеричное MD5 хеширование |
{android_id} | Android ID (только для Android) |
{api_level} | Уровень API (только Android) |
{city} | Город, в котором используется устройство |
{click_attribution_window} | Настройки окна атрибуции для сопоставления устройства (часы) |
{country_subdivision} | Подраздел устройства по стране, например штат или область |
{country} | Код страны устройства из двух символов |
{currency} | Исходный валютный код ISO 4217, отправленный из Adjust SDK |
{deeplink} | URL-адрес диплинка, добавленный в конец URL-адреса для клика |
{device_name} | Номер модели устройства |
{device_type} | Тип устройства |
{environment} | Текущая настройка среды Adjust SDK |
{gclid} | Идентификатор клика Google |
{gps_adid_md5} | Шестнадцатеричный хэш MD5 рекламного идентификатора Google Play Store в нижнем регистре |
{gps_adid} | Рекламный идентификатор магазина Google Play |
{idfa_md5_hex} | IDFA с шестнадцатеричным MD5 хешированием |
{idfa_md5} | IDFA с MD5 хешированием base64 |
{idfa_upper} | Верхний регистр, IDFA |
{idfa} | Идентификатор IDFA (только для iOS) |
{idfv} | Идентификатор поставщика iOS, в верхнем регистре |
{impression_attribution_window} | Настройки окна атрибуции для сопоставления просмотров (часы) |
{inactive_user_definition} | Период бездействия, требуемый для реатрибуции (часы) |
{ip_address} | IP-адрес устройства |
{isp} | Поставщик услуг интернета для устройства |
{label} | Значение параметра «label» Adjust, отправляемое по клику |
{language} | Код языка устройства из двух символов |
{last_time_spent} | Длительность последнего сеанса пользователя в секундах |
{mac_md5} | Хэш верхнего регистра MAC MD5 |
{mac_sha1} | Хэш верхнего регистра MAC SHA-1 |
{match_type} | Метод атрибуции |
{nonce} | Случайная буквенно-цифровая строка в нижнем регистре (уникальная для каждого колбэка) |
{partner_parameters} | Пользовательские параметры партнера, собираемые запросом Adjust SDK или S2S и передаваемые сторонним поставщикам с помощью постбэков |
{postal_code} | Почтовый индекс по IP-адресу устройства |
{publisher_parameters} | Индивидуальные параметры издателя, собранные через Adjust SDK (не отображаются на панели управления Adjust) |
{random} | Случайное число (уникальное для каждого колбэка) |
{reattribution_attribution_window} | Настройки окна атрибуции для реатрибуции (часы) |
{referrer} | Источник ссылки на магазин Google Play (только для Android) |
{reftag} | Случайный исходный тег устройства |
{region} | Региональный код устройства |
{reporting_currency} | Код валюты отчетности панели управления по ISO 4217 |
{reporting_revenue} | Доход по данным панели управления Adjust, в целых валютных единицах |
{revenue_usd_cents} | Выручка в центах США |
{revenue_usd} | Доход в долларах США |
{revenue} | Доход в том виде, в котором он отправлен из Adjust SDK, в центах |
{sdk_version} | Версия SDK Adjust (для приложения) |
{search_term} | Запрос органического поиска Google |
{time_spent} | Продолжительность текущего сеанса пользователя в секундах |
{timezone} | Часовой пояс устройства |
{tracking_enabled} | 1 — если отслеживание включено, 0 — если нет |
{tracking_limited} | 1 — если отслеживание ограничено, 0 — если нет |
{tweet_id} | Уникальный идентификатор твита |
{twitter_line_item_id} | Идентификатор строки в Twitter |
{user_agent} | Входящий необработанный user agent |
{win_hwid} | ID аппаратного обеспечения Windows Store |
{win_udid} | Уникальный идентификатор устройства на Windows Phone |
{activity_kind} | Тип действия пользователя |
{adgroup_name} | Название группы объявлений (как прописано в трекере) |
{app_id} | Идентификатор App Store или Google Play Store |
{app_name_dashboard} | Имя приложения на панели Adjust |
{app_name} | Имя приложения |
{app_version_raw} | Номер версии приложения (Android), номер версии сборки пакета (iOS) |
{app_version_short} | Номер версии приложения (Android), номер конечной версии пакета (iOS) |
{app_version} | Номер версии приложения (Android), номер версии сборки пакета (iOS) |
{campaign_name} | Название кампании (как прописано в трекере) |
{click_referer} | Заголовок источника ссылки из клика |
{click_time_hour} | Временная отметка атрибуцированного клика с округлением до ближайшего часа |
{click_time} | Временная отметка атрибутированного клика |
{connection_type} | Тип интернет-соединения |
{conversion_duration} | Время между кликом и установкой или реатрибуцией в секундах |
{created_at_hour} | Временная метка активности с округлением до ближайшего часа в меньшую сторону |
{created_at} | Временная отметка действия |
{creative_name} | Название креатива, как прописано в трекере |
{engagement_time_hour} | Временная отметка вовлечения с округлением до ближайшего часа |
{engagement_time} | Временная отметка вовлечения |
{impression_based} | 1 — если вовлечение на основе просмотра, 0 — если нет |
{installed_at_hour} | Временная отметка установки (т. е. первого открытия приложения) с округлением до ближайшего часа |
{installed_at} | Временная отметка установки (т. е. первого открытия приложения) |
{is_organic} | 1 — если трафик органический, 0 — если неорганический |
{last_tracker_name} | Предыдущее название трекера реатрибуцированного пользователя |
{last_tracker} | Токен трекера Adjust для исходного трекера реатрибуцированного пользователя, состоящий из шести символов |
{network_name} | Название сети (как прописано в трекере) |
{reattributed_at_hour} | Временная метка реатрибуции с округлением до ближайшего часа |
{reattributed_at} | Временная отметка реатрибуции |
{rejection_reason} | Причина отклонения атрибуции |
{store} | Целевой магазин клика |
{tracker_name} | Текущее название трекера |
{tracker} | Токен трекера Adjust, состоящий из шести символов |
{google_ads_adgroup_id} | Идентификатор группы объявлений Google Ads |
{google_ads_campaign_id} | Идентификатор кампании Google Ads |
{google_ads_campaign_name} | Название кампании Google Ads |
{google_ads_campaign_type} | Тип кампании Google Ads |
{google_ads_creative_id} | Идентификатор креатива Google Ads |
{google_ads_keyword} | Ключевое слово для поиска Google Ads |
{google_ads_matchtype} | Тип соответствия ключевых слов Google Ads и ключевое слово для поиска |
{google_ads_network_subtype} | Подтип сети Google Ads |
{google_ads_network_type} | Тип сети Google Ads |
{google_ads_placement} | Размещение рекламы в Google Ads |
{google_ads_video_id} | Идентификатор видео в Google Ads |