Прежде чем начать
Чтобы интегрироваться с рекламодателем на AppsFlyer, зарегистрируйтесь в качестве партнера Ad Integrated.
Если у вас уже есть интеграция с AppsFlyer, свяжитесь с их командой по адресу [email protected].
Общие сведения об интеграции
Чтобы начать интеграцию, вам необходимо отправить AppsFlyer URL для отслеживания и Postback URL для отчетности.
URL-адрес отслеживания AppsFlyer
В AppsFlyer перейдите в раздел Конфигурация > Активные интеграции > Ссылка на атрибуцию.
Подготовьте URL-адрес отслеживания AppsFlyer для интеграции, используя обязательные параметры.
Обязательные параметры ссылки отслеживания:
clickid | {clickid} | Уникальный идентификатор клика |
af_siteid | {pid} | Уникальный идентификатор, идентифицирующий издателя |
af_c_id | {offer_id} | Идентификатор предложения |
c | {offer_name} | Название предложения |
⚠️ Вам не нужно заполнять pid=medianame_int, это делает команда AppsFlyer.
Пример URL-адреса отслеживания AppsFlyer:
http://app.appsflyer.com/com.appsflyer?pid=mediaName_int&clickid={clickid}&af_siteid={pid}&af_c_id={offer_id}&c={offer_name}
2. В Affise вставьте ссылку в поле URL отслеживания в разделе Offers > a certain Offer > Tracking.
Зашифрованный ключ
Бывают случаи, когда вам необходимо передать доход рекламодателю в URL отслеживания AppsFlyer. Вы указываете этот доход в разделе Предложения > определенное предложение > Выплаты.
Если вы не хотите раскрывать фактическое значение стоимости, вы можете зашифровать его в URL-адресе отслеживания AppsFlyer с помощью параметра af_cost_value={max_income}.
🔎 Система Affise подсчитывает все выплаты в предложении: как общие, так и персональные.
Чтобы сделать параметр доступным, сделайте следующее:
Возьмите ключ шифрования из AppsFlyer.
В панели администратора Affise > Настройки > Appsflyer вставьте этот ключ шифрования в поле Ключ шифрования.
После выполнения интеграции шифрования затрат с AppsFlyer вы попадете в список рекламных сетей, поддерживающих затраты.
Когда интеграция затрат будет готова, обновите URL-адрес отслеживания в AppsFlyer, добавив af_cost_value={max_income}, и используйте его в своем предложении Affise.
URL выглядит следующим образом:
https://app.appsflyer.com/id554782625?&clickid={clickid}&af_siteid={pid}&af_c_id={offer_id}&af_cost_model=CPI&af_cost_value={max_income}&af_cost_currency=USD🔎 Подробнее о зашифрованной стоимости читайте здесь.
URL-адрес постбэка Affise
Чтобы получать конверсии на Affise, вам нужно получить ссылку на постбэк на Affise и настроить ее на AppsFlyer.
Вы можете настроить два типа URL Affise для постбэка в зависимости от ваших потребностей: глобальный постбэк для установки и постбэк для событий в приложении.
В AppsFlyer перейдите в раздел Профиль > Управление постбэками > Постбэки по умолчанию.
Настройте свой постбэк в полях Install postback URL и In-app event postback URL.
Добавьте необходимые поля. Вам необходимо использовать параметры постбэка Affise и макросы AppsFlyer.
Обязательными параметрами и макросами являются:
pid | {af_siteid} | ID издателя. Проверяется при установке и в приложении. |
offer_id | {af_c_id} | Идентификатор предложения на Affise. Проверяйте как в Install, так и в In-app. |
clickid | {clickid} | Идентификатор клика. Проверяйте как при установке, так и в приложении. |
цель | {partner_event_id} | Значение цели Affise, сопоставленное с названием события AppsFlyer. Отметьте только In-app. |
4. Необязательно. При необходимости добавьте пользовательские поля для передачи дополнительной информации.
Ссылка на постбэк Affise для примера AppsFlyer:
https://offers-rocketcompany.affise.com/postback?pid={af_siteid}&offer_id={af_c_id}&clickid={clickid}&goal={partner_event_id}&custom_field1={oaid}5. Необязательно. Если вы работаете с кампаниями в iOS-приложениях, необходимо выполнить аналогичную настройку в разделе Профиль > Управление возвратом > Расширенная конфиденциальность. Единственное отличие заключается в том, что вам не нужно использовать идентификатор клика и требуется больше дополнительных параметров для лучшего сопоставления кликов и конверсий.
🔎 Подробнее о вероятностной атрибуции читайте здесь.
Постбэк событий в приложении
Чтобы получать постбэк с событий в приложении, настройте цели в разделе Предложения > Определенное предложение > Выплаты.
⚠️ Значение цели"1" в системе Affise всегда относится к событию установки . Если цель не указана в URL-адресе постбэка, конверсия по умолчанию имеет значение цели"1".
Значение цели относится к значению события AppsFlyer:
Fraud install postback
Когда вы получаете постбэки из AppsFlyer, система Affise автоматически не отличает настоящие постбэки от мошеннических. В результате вы получаете все конверсии, зарегистрированные как реальные, и должны платить за них.
Чтобы решить эту проблему, вы можете установить нулевые платежи и отдельный постбэк, чтобы отклонить мошеннические конверсии.
Чтобы настроить нулевые выплаты, сделайте следующее:
В разделе Предложения > Определенное предложение > Выплаты добавьте новую выплату.
Установите доход и выплаты на 0.
Добавьте новую цель для этой выплаты.
Чтобы отклонять конверсии на основе мошеннических постбеков, необходимо настроить отдельный URL-адрес постбека для мошеннических конверсий:
Добавьте параметр comment с макросами AppsFlyer {blocked-reason}, {blocked-reason-value}, {blocked-sub-reason} для определения данных о мошенничестве в URL постбэка Affise.
Добавьте параметр status=3 в URL-адрес постбэка Affise, чтобы автоматически отклонять конверсии, связанные с мошенничеством.
Добавьте цель, которую вы установили для нулевых выплат.
Пример URL-адреса постбэка установки мошенничества:
http://offers.rocketcompany.affise.com/postback?clickid={clickid}&custom_field1={af_siteid}&comment={blocked-reason}_{blocked-reason-value}_{blocked-sub-reason}_blockedbyAF&status=3&goal=4Вероятностная атрибуция
При работе с вероятностной атрибуцией вы не можете передавать значение идентификатора клика. URL-адреса для интеграции требуют других обязательных параметров и макросов.
URL-адрес вероятностного отслеживания AppsFlyer
Обновите URL-адрес отслеживания AppsFlyer с обязательными макросами {pid} и {offer_id} .
Пример URL-адреса отслеживания AppsFlyer:
https://app.appsflyer.com/com.appsflyer?pid=mediaName_int&af_siteid={pid}&af_c_id={offer_id}.Данные User-Agent для браузеров на базе Chrome 110
Существует особенность настройки вероятностной атрибуции (как для кликов, так и для показов) для Android или десктопных устройств, инициированных из браузеров на базе хрома (Chrome, Edge, Opera и др.). Такой трафик содержит уменьшенные данные заголовка user-agent. В связи с этим вместе с данными user-agent необходимо передавать информацию о версии ОС и модели устройства.
Для корректной передачи данных, помимо обязательных макросов {pid} и {offer_id} для кликов и макросов {oid} и {aid} для показов, используйте следующие макросы Affise:
{device_ua} для передачи данных пользовательского агента.
{os_version} для передачи данных о версии ОС.
{device_model} для передачи данных о модели устройства.
🔎 Найти параметры AppsFlyer можно здесь.
Пример URL-адреса отслеживания AppsFlyer:
https://app.appsflyer.com/com.appsflyer?pid=mediaName_int&af_siteid={pid}&af_c_id={offer_id}&af_ua={device_ua}&af_os_version={os_version}&af_model={device_model}Affise probabilistic postback URL
Рекомендуемый образец ссылки вероятностного постбэка для Appsflyer:
https://offers-rocketcompany.affise.com/probattribution?action_id={postback_id}&goal={partner_event_id}&offer_id={af_c_id}&pid={af_siteid}&country={country_code}×tamp={attributed_touch_hour}&sub2={af_sub_siteid}&action_timestamp={event_hour}&platform={platform}🔎 Найти другие параметры можно здесь.
Если вы хотите использовать опции Click&Impression session lifespan или Minimal click&Impression session lifespan, добавьте параметры timestamp и action_timestamp к вашей ссылке на постбэк. Более подробная информация здесь.
⚠️ Appsflyer отправляет постбэк с задержкой до 24 часов. Например, конверсия произошла в 14:30, а постбэк пришел в 19:45. Время отправки постбэка является случайным.
Такая задержка приводит к нескольким ограничениям:
Нет возможности использовать отчет Time to Action (CTIT) в Affise.
Нет возможности использовать CR, Click и KPI Automation в течение периода менее 24 часов.
Пожалуйста, свяжитесь с командой поддержки клиентов Affise по всем возникшим вопросам по электронной почте: [email protected].