Кратко: Sojern for Advertisers — интегрированный партнер AppsFlyer в категории рекламных сетей, специализирующийся на программатик-закупках для туристического рынка.
Чтобы настроить ваши кампании в Sojern for Advertisers, выполните следующие действия.
Настройка Sojern for Advertisers для рекламодателей
Необходимые условия. Перед настройкой интеграции необходимо связаться с партнером и открыть у него аккаунт.
Чтобы активировать интеграцию:
-
Чтобы активировать: В AppsFlyer в боковом меню выберите Сотрудничество > Маркетплейс партнеров.
Чтобы изменить: В боковом меню AppsFlyer выберите Сотрудничество > Активные интеграции. - Выберите соответствующее приложение.
- На вкладке Интеграция выберите приложение для интеграции и нажмите Активировать партнера.
- При первом посещении здесь нужно включить переключатель Активировать партнера, чтобы настроить параметры интеграции. Этот переключатель обязательно должен быть включен все время, пока вы работаете с партнером.
Дополнительная информация по активации партнеров: нажмите здесь. - Завершите настройку, используя соответствующие вкладки, как описано ниже. Подробное описание заголовка окна настройки параметров партнера см. здесь.
Вкладка «Интеграция»
На вкладке «Интеграция» есть несколько разделов, которые описаны ниже.
Активация партнера
При первом посещении вам нужно включить переключатель Активировать партнера, чтобы открыть возможность настройки параметров интеграции. Этот переключатель должен быть активирован все время, пока вы работаете с этим партнером.
Дополнительная информация по активации партнеров доступна здесь.
Примечание:
Как сеть, ориентированная на все установки, Sojern for Advertisers предпочитает получать постбэки обо всех новых установках вашего приложения из любого источника, включая органические установки. Чтобы отправлять в Sojern for Advertisers постбэки по всем установкам, выберите События, атрибутированные любому партнеру.
Общие настройки
Partner ID (Идентификатор партнера)
Sojern for Advertisers подключается к AppsFlyer через уникальный идентификатор партнера ID. Если у вас еще нет идентификатора партнера, чтобы продолжить интеграцию, его нужно получить в Sojern for Advertisers.
Постбэки по умолчанию
Автоматически отправляйте в Sojern for Advertisers постбэки после установок и повторных вовлечений пользователей. В этом разделе можно определить источник пользователей, который позволяет отправлять постбэки.
Выберите Только события, атрибутируемые этому партнеру для событий, которые поступают только от пользователей, атрибутированных Sojern for Advertisers.
Выберите События, атрибутируемые любому партнеру или органические, чтобы вся ваша база пользователей была доступна для отчетности в Sojern for Advertisers.
In-App Events Settings (Настройки внутренних событий приложения)
В этом разделе вы можете сопоставить события AppsFlyer с событиями Sojern for Advertisers с помощью постбэков.
- Снова введите идентификатор партнера Sojern for Advertisers.
- Включите переключатель «Постбэки по внутренним событиям приложения».
- В поле «Вариант отправки» выберите значение, которое будет использоваться для всех событий, определенных в SDK.
- Только события, атрибутированные этому партнеру: партнер будет получать сведения о событиях только тех пользователей, которые ему атрибутированы.
- События, атрибутированные любому партнеру или органические: партнер будет получать сведения о событиях всех пользователей, которые есть в вашей базе. - Чтобы добавить в список событие SDK, нажмите Добавить событие.
Подробнее о событиях в приложении Sojern for Advertisers читайте здесь. - Введите следующие параметры:
| Имя параметра | Description(Описание) |
|---|---|
| Имя события в SDK | Имя события, полученное AppsFlyer либо из SDK, интегрированного в ваше приложение, либо из межсерверных событий. Совет. Если в списке нет нужного вам события, убедитесь, что оно активировано на устройстве с неорганической установкой, и повторите поиск. |
| Идентификатор события партнера | Уникальное имя или идентификатор ID каждого события, определенные на стороне Sojern for Advertisers. Получите соответствующий идентификатор события в Sojern for Advertisers и введите его в текстовое поле. |
| Отправка данных о доходе |
Флажок не установлен — партнеру отправляются все параметры насыщенного внутреннего события приложения, за исключением параметра дохода (параметр af_revenue). Флажок установлен — отправляются все параметры, в том числе значение дохода (если применимо к событию). |
Типы событий
Для Sojern for Advertisers требуется реализовать следующие события:
Отель
| Тип события | События Sojern for Advertisers | SDK-событие | Description(Описание) |
|---|---|---|---|
Домашняя страница |
ГЛАВНАЯ_СТРАНИЦА |
af_app_opened |
Открытие приложения/вывод на передний план |
Результат поиска |
ПОИСК_ОТЕЛЕЙ |
af_list_view |
Страница результатов поиска со списком вариантов |
Продукт |
ПРОДУКТ_ОТЕЛЯ |
af_content_view |
Просмотр конкретного продукта/варианта из результатов поиска |
Подтверждение |
ПОДТВЕРЖДЕНИЕ_ОТЕЛЯ |
af_purchase |
Покупка товара(-ов) |
Рейс
| Тип события | События Sojern для рекламодателей | SDK-событие | Description(Описание) |
|---|---|---|---|
Домашняя страница |
ГЛАВНАЯ_СТРАНИЦА |
af_app_opened |
Открытие приложения/вывод на передний план |
Результат поиска |
ПОИСК_РЕЙСОВ |
af_list_view |
Страница результатов поиска со списком вариантов |
Продукт |
ПРОДУКТ_РЕЙСА |
af_content_view |
Просмотр конкретного продукта/варианта из результатов поиска |
Подтверждение |
ПОИСК_ОТЕЛЕЙ |
af_purchase |
Покупка товара(-ов) |
Круиз
| Тип события | События Sojern для рекламодателей | SDK-событие | Description(Описание) |
|---|---|---|---|
Домашняя страница |
HOME_PAGE |
af_app_opened |
Открытие приложения/вывод на передний план |
Результат поиска |
CRUISE_SEARCH |
af_list_view |
Страница результатов поиска со списком вариантов |
Продукт |
CRUISE_PRODUCT |
af_content_view |
Просмотр конкретного продукта/варианта из результатов поиска |
Подтверждение |
CRUISE_CONFIRMATION |
af_purchase |
Покупка товара (товаров) |
Автомобиль
| Тип события | События Sojern для рекламодателей | SDK-событие | Description(Описание) |
|---|---|---|---|
Домашняя страница |
HOME_PAGE |
af_app_opened |
Открытие приложения/вывод на передний план |
Результат поиска |
CAR_SEARCH |
af_list_view |
Страница результатов поиска со списком вариантов |
Продукт |
CAR_PRODUCT |
af_content_view |
Просмотр конкретного продукта/варианта из результатов поиска |
Подтверждение |
CAR_CONFIRMATION |
af_purchase |
Покупка товара(-ов) |
Развлечения
| Тип события | События Sojern для рекламодателей | SDK-событие | Description(Описание) |
|---|---|---|---|
Домашняя страница |
HOME_PAGE |
af_app_opened |
Открытие приложения/вывод на передний план |
Результат поиска |
ENTERTAINMENT_SEARCH |
af_list_view |
Страница результатов поиска со списком вариантов |
Продукт |
ENTERTAINMENT_PRODUCT |
af_content_view |
Просмотр определенного продукта/варианта из результатов поиска |
Подтверждение |
ENTERTAINMENT_CONFIRMATION |
af_purchase |
Покупка товара(-ов) |
Поезд
| Тип события | События Sojern для рекламодателей | SDK-событие | Description(Описание) |
|---|---|---|---|
Домашняя страница |
HOME_PAGE |
af_app_opened |
Открытие приложения/вывод на передний план |
Результат поиска |
RAIL_SEARCH |
af_list_view |
Страница результатов поиска со списком вариантов |
Продукт |
RAIL_PRODUCT |
af_content_view |
Просмотр определенного продукта/варианта из результатов поиска |
Подтверждение |
RAIL_CONFIRMATION |
af_purchase |
Покупка товара(ов) |
Отпуск
| Тип события | События Sojern for Advertisers для рекламодателей | SDK-событие | Description(Описание) |
|---|---|---|---|
Домашняя страница |
HOME_PAGE |
af_app_opened |
Открытие приложения/вывод на передний план |
Результат поиска |
VACATION_SEARCH |
af_list_view |
Страница результатов поиска со списком вариантов |
Продукт |
VACATION_PRODUCT |
af_content_view |
Просмотр определенного продукта/варианта из результатов поиска |
Подтверждение |
VACATION_CONFIRMATION |
af_purchase |
Покупка товара(ов) |
Правильная настройка событий в приложении
При настройке кампании в Sojern for Advertisers важно правильно настроить определенные события в приложении.
Если соглашение об именовании AppsFlyer недоступно, используйте ключ Param в Sojern for Advertisers.
В Sojern for Advertisers есть четыре типа событий в приложении:
- Подтверждение
- Продукт
- Поиск
- Корзина
Ниже приведен пример поиска и подтверждения для сегмента отелей и авиаперелетов:
| YouTube video player | Ключ параметра | Название насыщенного in-app события AppsFlyer | |
|---|---|---|---|
| Поиск рейсов | Тип события | et | значение 'fs' |
| Количество путешественников | t | af_num_adults + af_num_children + af_num_infants | |
| Количество взрослых | tad | af_num_adults | |
| Количество детей | tch | af_num_children | |
| Класс обслуживания | fc | af_класс | |
| В одну сторону | fow | Н/Д | |
| Сложный маршрут | fmc | Н/Д | |
| домен сайта для страны | dctry | Н/Д | |
| Домен сайта | домен | Н/Д | |
| Аэропорт отправления | fa1 | af_destination_a | |
| Аэропорт назначения | fa2 | af_destination_b | |
| Город назначения | fc1 | af_city | |
| Город отправления | fc2 | Н/Д | |
| Дата отправления | fd1 | af_departing_departure_date | |
| Дата возвращения | fd2 | af_дата_отправления_обратного | |
| Подтверждение рейса | YouTube video player | ParamKey | |
| Тип события | et | значение "fc" | |
| Количество путешественников | t | af_num_adults + af_num_children + af_num_infants | |
| Количество взрослых | tad | af_num_adults | |
| Количество детей | tch | af_num_children + af_num_infants | |
| Класс обслуживания | fc | af_класс | |
| домен страны сайта | dctry | Н/Д | |
| Домен сайта | домен | Н/Д | |
| Аэропорт отправления | fa1 | af_destination_a | |
| Аэропорт назначения | fa2 | af_destination_b | |
| Город назначения | fc1 | af_city | |
| Город отправления | fc2 | Н/Д | |
| Дата отправления | fd1 | af_departing_departure_date | |
| Дата обратного вылета | fd2 | af_дата_отправления_обратного | |
| Валюта покупки | fcu | af_currency | |
| Цена покупки | fp | af_выручка | |
| Поиск отеля | YouTube video player | ParamKey | |
| Тип события | et | значение «hs» | |
| Домен страны веб-сайта | dctry | af_country | |
| Город назначения | hc1 | af_city | |
| Дата регистрации заезда | hd1 | af_date_a | |
| Дата регистрации выезда | hd2 | af_date_b | |
| Количество путешественников | t | af_num_adults + af_num_children + af_num_infants | |
| Количество взрослых | tad | af_num_adults | |
| Количество детей | tch | af_num_children + af_num_infants | |
| Домен сайта | домен | Н/Д | |
| Подтверждение бронирования отеля | YouTube video player | ParamKey | |
| Тип события | et | значение «hc» | |
| Домен страны веб-сайта | dctry | Н/Д | |
| Город назначения | hc1 | af_city | |
| Дата приезда | hd1 | af_date_a | |
| Дата отъезда | hd2 | af_date_b | |
| Количество путешественников | t | af_num_adults + af_num_children + af_num_infants | |
| Количество взрослых | tad | af_num_adults | |
| Количество детей | tch | af_num_children + af_num_infants | |
| Домен сайта | домен | Н/Д | |
| Страна назначения | hn1 | af_country | |
| Цена покупки | hp | af_выручка | |
| Валюта покупки | hcu | af_currency |
Пример
Значения события поиска авиарейсов:
Событие в приложении: af_list_view; значения события в приложении: et=‘fs’&af_num_adults={number of adults}&af_num_children={number of children}&af_class={service class}&fow={one way}&fmc={multi city}&dctry={website country domain}&af_destination_a={departure airport code}&af_destination_b={arrival airport code}&af_city={destination city}&fc2={origin city}&af_departing_departure_date={YYYY-MM-DD}&af_returning_departure_date={YYYY-MM-DD}
Вкладка «Ссылки атрибуции»
На этой вкладке можно создавать ссылки атрибуции, которые вы хотите отправить в Sojern for Advertisers для атрибуции кампаний, групп объявлений или даже отдельных объявлений. Обратите внимание, что AppsFlyer НЕ сохраняет ссылки атрибуции, созданные для вашего партнера.
На этой вкладке есть несколько разделов:
Параметры ссылки атрибуции
В этом разделе можно выбрать параметры для добавления в ссылку атрибуции.
Здесь можно задавать дополнительные параметры ссылки атрибуции, чтобы затем использовать их для детального анализа. Параметры, уже заданные в ссылке атрибуции, можно редактировать, добавляя их и их новые значения здесь.
-
Кампания — добавьте этот параметр, чтобы сравнивать разные кампании, запущенные в Sojern for Advertisers.
Параметр ссылки атрибуции: c -
Adset — задайте названия групп объявлений, чтобы сравнивать разные группы объявлений в рамках определенных кампаний Sojern for Advertisers.
Параметр ссылки атрибуции: af_adset -
Название объявления — задайте названия объявлений, чтобы сравнивать разные креативы в определенных группах объявлений в рамках определенных кампаний Sojern for Advertisers.
Параметр ссылки атрибуции: af_ad -
Site ID и Sub Site ID — задайте параметр Site ID, чтобы атрибутировать установки определенным паблишерам. При наличии большого количества паблишеров рекомендуется ограничить количество используемых идентификаторов сайтов и использовать параметр идентификатора подсайта, чтобы не превысить допустимое количество идентификаторов сайтов.
Параметры ссылки атрибуции: af_siteid и af_sub_siteid -
Параметры подписчика — используйте любой из 5 параметров подписчика, чтобы вставить полезные значения. Обратите внимание, что эти параметры анализируются и отображаются в отчете о сырых данных, что делает их очень удобными для агрегации или фильтрации данных.
Параметры ссылки атрибуции: af_sub1, af_sub2, af_sub3, af_sub4, af_sub5
Если нужно добавить в ссылку атрибуции другой параметр, просто введите его в поле нового параметра. Дополнительные сведения см. в статье Структура и параметры ссылки атрибуции AppsFlyer.
Атрибуция по кликам
Этот ползунок позволяет задать максимальное время от клика до установки. Только установки (первые запуски), выполненные в пределах окна атрибуции, могут быть атрибутированы Sojern for Advertisers.
Параметр ссылки атрибуции: af_click_lookback
Подробнее об окне атрибуции по кликам читайте здесь.
Ссылка атрибуции для клика
Это ссылка атрибуции, которая содержит все заданные для нее настройки. Отправьте это в Sojern for Advertisers, чтобы активировать, когда лиды кликают по соответствующей рекламе.
Вкладка «Стоимость»
Интеграция затрат недоступна для Sojern for Advertisers.
Вкладка «Доходы от рекламы»
Интеграция вкладки «Ad Revenue» недоступна для Sojern for Advertisers.
Вкладка Permissions (Разрешения)
Настройка разрешений для Sojern for Advertisers недоступна.