Конфигурация кампании Yahoo Japan Search Ads

Кратко: Yahoo Japan Search Ads — партнер по сети с самоотчетностью (SRN), который сочетает рекламу и аналитику.

15 декабря 2021 года прежняя интеграция с Yahoo Japan Search Ads, yahoojapansearch_int, была заменена новой интеграцией, yjsearch_int. Узнайте, как начать работать с новым API.

Принципы интеграции Yahoo Japan Search Ads

Интеграция AppsFlyer с Yahoo Japan Search Ads актуальна только для Android-приложений.

Интеграция использует идентификатор ссылки для измерения конверсий и основана на предварительно заданных событиях конверсии в Yahoo Japan Search Ads. Вы можете сопоставить события в приложении, такие как подписки и покупки, с этими событиями. Это позволяет измерять конверсии и обеспечивать отчетность между AppsFlyer и Yahoo Japan Search Ads.

Сравнение прежней и новой интеграции

Поддержка функций API Yahoo Japan Search Ads:

Особенность	Прежняя (yahoojapansearch_int)	Новый (yjsearch_int)
Конверсия установки (только после клика)	Да	Да
Конверсия в приложении	Ни один	Да

Особенность

Прежняя (yahoojapansearch_int)

Новый

(yjsearch_int)

Конверсия установки (только после клика)

Да

Конверсия в приложении

Ни один

Да

Интеграция с новым API

Чтобы включить интеграцию с новым API:

В дэшборде Yahoo Japan Search Ads сгенерируйте идентификатор ссылки. Необходимо выбрать AppsFlyer в качестве MMP.
В AppsFlyer настройте интеграцию с Yahoo Japan Search Ads.
Сопоставьте события в приложении, которые вы хотите измерять, и создайте новую аналитику конверсий в Campaign Management Tool в Yahoo Japan Search Ads.

Обмен данными между AppsFlyer и Yahoo Japan Search Ads

Отправляйте постбэки в Yahoo Japan Search Ads, связанные с конверсиями и событиями в приложении. События в приложении сопоставляются с предопределенными событиями конверсии, которые Yahoo Japan Search Ads использует для оптимизации и обновления отчетов об эффективности. Сопоставление выполняется в настройках интеграции.

См. следующую таблицу сопоставления для событий в приложении AppsFlyer (вашего приложения) и предопределенного сопоставления событий Yahoo Japan Search Ads.

AppsFlyer in-app событие	Тип события в приложении Yahoo Japan Search Ads
af_purchase	in_app_purchase
af_app_opened	session_start
af_search	просмотр_результатов_поиска
af_content_view	view_item
af_list_view	view_item_list
af_add_to_cart	добавить в корзину
af_travel_booking	ecommerce_purchase
Любое событие в приложении	Если у вас есть дополнительные события, сопоставьте их с настраиваемым событием.

Данные, предоставляемые AppsFlyer сервисом Yahoo Japan Search Ads

Когда Yahoo Japan Search Ads регистрирует конверсию, сервис передает нам параметры медиаисточника, указанные в таблице. Эти параметры используются для заполнения аналитических отчетов и отчетов по необработанным данным. В следующей таблице приведено сопоставление параметров Yahoo Japan Search Ads и AppsFlyer.

Сопоставление медиаисточников Yahoo Japan Search Ads и AppsFlyer

Поисковая реклама Yahoo! Япония	AppsFlyer:
временная метка	attributed_touch_time
campaign_tracking_id	campaign_id (идентификатор кампании)
ad_group_tracking_id	adset_id (идентификатор группы объявлений)
ad_tracking_id	ad_id (идентификатор объявления)
keyword	keywords (ключевые слова)
Местоположение устройства	keyword_match_type
account_id	network_account_id

Процедуры интеграции

Вы можете интегрироваться с Yahoo Japan Search Ads как с одной сущностью: напрямую как рекламодатель или через агентство.
Заполните разделы следующим образом:

[Заполняется один раз — обязательно] Интеграция рекламодателя с Yahoo Japan Search Ads.
[Необязательно для каждого агентства] Интеграция агентства.

Разделы вкладки интеграции Yahoo Japan Search Ads

Step

Раздел

Description(Описание)

Активация партнера

Необходимые условия:

Получите сID сылки Yahoo Japan Search Ads.

Чтобы активировать интеграцию атрибуции приложения Yahoo Japan Search Ads:

В AppsFlyer в боковом меню выберите Сотрудничество > Партнерские интеграции > Маркетплейс партнеров.
Найдите Yahoo! Search Ads (Yahoo! JAPAN Sponsored Search) - Новый API, и выберите его.
Убедитесь, что в URL-адресе отображается yjsearch_int . Если это не так, вы выбрали неправильного интегрированного партнера.
На вкладке Интеграция включите Активировать партнёра.
Примечание: Переключатель должен быть включен (активирован) на протяжении всего времени, пока вы работаете с партнером.
В поле Link ID вставьте идентификатор ID ссылки, указанный в предварительных требованиях.
[Необязательно] Изменения настроек по умолчанию для окна ретроспективы по клику для установки click-through lookback window. По умолчанию в Yahoo Japan Search Ads установлено 7 дней. Чтобы свести к минимуму расхождения [практические рекомендации], ориентируйтесь на значение по умолчанию в Yahoo Japan Search Ads.
Нажмите Сохранить интеграцию.
В Yahoo Japan Search Ads задайте для новых настроек конверсии значение "app_first_open". Узнать больше о настройке в Yahoo Japan Search Ads.

Сопоставьте события в приложении AppsFlyer с событиями Yahoo Japan Search Ads

Чтобы сопоставить предопределенные события Yahoo Japan Search Ads с событиями в приложении AppsFlyer:

В AppsFlyer в боковом меню выберите Сотрудничество > Партнерские интеграции > Активные интеграции.
Выберите Yahoo! Найдите Ads (Yahoo! JAPAN Sponsored Search) - Новый API.
Активируйте постбэки внутренних событий приложений.
Чтобы добавить в список событие приложения, нажмите Add event.
Заполните необходимые параметры.
Нажмите Сохранить интеграцию.
В Yahoo Japan Search Ads задайте новые настройки конверсии в соответствии с настроенными событиями в приложении. Узнать больше о настройке в Yahoo Japan Search Ads.

Название параметра	Description(Описание)
Имя события в SDK	Имя события, полученное AppsFlyer из SDK, интегрированного в приложение, или из межсерверных событий.
Идентификатор события партнера	Предопределенные события Yahoo Japan Search Ads. Рекомендуемые стандартные конфигурации сопоставления перечислены в таблице в предыдущем разделе.
Sending option (Вариант отправки)	Выберите вариант отправки для события: Только этот партнер: для событий, поступающих только от пользователей, атрибутированных Yahoo Japan Search Ads. Все медиаисточники, включая органические: вся ваша пользовательская база будет доступна для передачи в отчетность Yahoo Japan Search Ads.
Отправить доход	Нет значений & нет дохода: отправляет только само событие без значения. Значения & нет дохода: отправляет все параметры, кроме значения дохода. Значения & доход: отправляет все параметры события, включая значение дохода (если оно есть в событии).

Примечания:

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

Интеграция агентства

Агентства могут запускать кампании в Yahoo Japan Search Ads от вашего имени.

Настройка агентства

Процедура для выполнения	Процедура
Рекламодатели	Убедитесь, что вы завершили интеграцию рекламодателя Yahoo Japan Search Ads. В AppsFlyer в боковом меню выберите Сотрудничество > Партнерские интеграции > Активные интеграции. Выберите агентство. Перейдите на вкладку Разрешения и включите разрешения агентства.
Доступно с Android SDK версии 4.8.5	В AppsFlyer перейдите в Сотрудничество > Партнерские интеграции > Активные интеграции. Выберите Yahoo! Найдите Ads (Yahoo! JAPAN Sponsored Search) - Новый API. Перейдите на вкладку Интеграция. Убедитесь, что переключатель Активировать партнера включен. Если это не так, рекламодатель должен выполнить интеграцию Yahoo Japan Search Ads для рекламодателей. Проверьте правильность остальных настроек, таких как окна атрибуции и сопоставление событий в приложении. При необходимости попросите рекламодателя внести изменения. Введите идентификатор клиента Yahoo Japan Search Ads. Идентификатор доступен в инструменте управления кампаниями. Обратите внимание: можно подключить только один идентификатор клиента. Нажмите Save (Сохранить).

Процедура для выполнения

Процедура

Рекламодатели

Убедитесь, что вы завершили интеграцию рекламодателя Yahoo Japan Search Ads.
В AppsFlyer в боковом меню выберите Сотрудничество > Партнерские интеграции > Активные интеграции.
Выберите агентство.
Перейдите на вкладку Разрешения и включите разрешения агентства.

Доступно с Android SDK версии 4.8.5

В AppsFlyer перейдите в Сотрудничество > Партнерские интеграции > Активные интеграции.
Выберите Yahoo! Найдите Ads (Yahoo! JAPAN Sponsored Search) - Новый API.
Перейдите на вкладку Интеграция.
Убедитесь, что переключатель Активировать партнера включен. Если это не так, рекламодатель должен выполнить интеграцию Yahoo Japan Search Ads для рекламодателей.
Проверьте правильность остальных настроек, таких как окна атрибуции и сопоставление событий в приложении. При необходимости попросите рекламодателя внести изменения.
Введите идентификатор клиента Yahoo Japan Search Ads. Идентификатор доступен в инструменте управления кампаниями. Обратите внимание: можно подключить только один идентификатор клиента.
Нажмите Save (Сохранить).

Дополнительные процедуры

Получите идентификатор ссылки приложения

Чтобы получить идентификатор ссылки Campaign Manager, см. документацию Yahoo Japan Search Ads.

Создайте новое предопределенное событие Yahoo Japan Search Ads

Чтобы создать новое предопределенное событие, см. инструкции Yahoo Japan Search Ads.

Расхождения в Yahoo Japan Search Ads

См. таблицу ниже, чтобы узнать о расхождениях и способах их минимизации.

Различия в моделях атрибуции

Причина	Description(Описание)	Совет AppsFlyer
Неправильное сопоставление событий в приложении	Сопоставление между AppsFlyer и Yahoo Japan Search Ads выполнено неправильно.	Проверьте идентификатор ссылки, Убедитесь, что события в приложении AppsFlyer правильно сопоставлены с событиями Yahoo Japan Search Ads.

Чем мы можем помочь?

Поиск