Настройка интеграции GMP DV360/CM (DoubleClick)

Для:
маркетологов
Последнее обновление:

Краткий обзор. Интегрируйте AppsFlyer с Google Платформой для маркетинга DV360/CM (DoubleClick). Обратите внимание, что внутреннее название этой интеграции в AppsFlyer — doubleclick_int.

Настройка GMP в AppsFlyer

Информация в этом разделе относится к:

  • CM360 + медиа-источник
  • Кампании DV360

Активация Google Платформы для маркетинга

Чтобы активировать Google Платформу для маркетинга:

  1. В AppsFlyer перейдите в раздел Настройки > Маркетплейс партнеров. 
  2. Найдите Google Платформу для маркетинга — DV360/CM (DoubleClick) и выберите ее.
  3. Нажмите Настроить интеграцию. Вы будете перенаправлены на страницу настройки интеграции. Проверьте URL, должно быть doubleclick_int.
  4. На вкладке Интеграция включите переключатель Активировать партнера.
    Примечание. Этот переключатель должен быть активирован все время, пока вы работаете с этим партнером.
  5. Нажмите кнопку Save Integration (Сохранить интеграцию). 

Получение параметров для действий Floodlight

Перед настройкой GMP необходимо создать действие Floodlight для событий установки (first_open) и получить его параметры. Подробные сведения см. здесь. Необходимо получить следующие параметры: 

  • cat  — строка тега действия, которую серверы Floodlight используют для определения группы, к которой относится действие.
  • src — идентификатор рекламодателя, который является источником действия Floodlight. Это параметр src= в теге Floodlight, который вы экспортируете с экрана настройки «Pixel», а не идентификатор рекламодателя DBM.
  • type — строка тега группы, идентифицирующего группу действий, с которой связано действие Floodlight.
  • Токен — см. инструкции по получению токена:

Эти параметры необходимы для интеграции с AppsFlyer.

 Примечание

Параметры Floodlight уникальны для каждого приложения. Вам нужно по два набора параметров Floodlight, по одному для каждого приложения.

Интеграция с Google Платформой для маркетинга 

  1. В AppsFlyer перейдите в раздел Настройки > Активные интеграции.
  2. Выберите Google Платформу для маркетинга.
    Доступны вкладки настроек: Integration (Интеграция), Ad Revenue (Доходы от рекламы), Permissions (Разрешения). Задайте необходимые настройки. 

Помимо мобильной атрибуции по кликам, GMP позволяет выполнять атрибуцию по просмотрам и атрибуцию повторного вовлечения, данные которых можно регистрировать с помощью AppsFlyer.

Подробное описание заголовка окна "Partner Configuration" (Настройки партнера) см. здесь.

Вкладка "Интеграция"

На запросы AppsFlyer платформа GMP возвращает параметры, перечисленные в ответе. Они сопоставляются с параметрами и сырыми данными AppsFlyer, как подробно описано в следующей таблице. 

Параметр GMP Имя параметра AppsFlyer Параметр URL-адрес 
Идентификатор размещения Название кампании c
Идентификатор размещения ID кампании af_c_id
ID сайта ID сайта af_siteid
ID рекламы. ID блока рекламы af_adset_id
Идентификатор креатива ID рекламы. af_ad_id

Настройка параметров действий Floodlight

Введите значения параметров действия Floodlight в соответствующие поля на вкладке "Integration" (Интеграция).

Атрибуция установок 

Окно атрибуции установки по клику

  • Установите максимальное время от клика до установки. К GMP атрибутируются только те установки (первые запуски), которые произошли в пределах окна ретроспективного обзора.
  • По умолчанию в GMP используется окно ретроспективного обзора по кликам длительностью 30 дней. Чтобы свести расхождения к минимуму, рекомендуется задавать такие же временные интервалы, как и в GMP.
  • Подробнее об окне ретроспективного обзора по кликам 

Окно атрибуции установки по просмотру

  • Задайте максимальное время от показа до установки. Партнеру атрибутируются только те установки (первые запуски), которые произошли в рамках окна ретроспективного обзора после показа рекламы, при условии отсутствия других нажатий по объявлению, относящихся к этой установке. 
  • Установите переключатель для атрибуции установок просмотрам на GMP в состояние «включено». Это значение можно задать в часах (от 1 до 23) или в днях (от 1 до 7).
  • По умолчанию в GMP используется окно ретроспективного обзора по просмотрам длительностью 7 дней. Чтобы свести расхождения к минимуму, рекомендуется задавать такие же временные интервалы, как и в GMP.

Атрибуция повторного вовлечения

Для измерения ретаргетинговых кампаний:

  1. Включите Re-engagement attribution (Атрибуция повторного вовлечения).
    Если у вас нет активных кампаний по повторному вовлечению на Google Платформе для маркетинга, выключите данную функцию. 
  2. Создайте новое действие Floodlight для ретаргетинговых кампаний (например, app_opens). Затем на дэшборде AppsFlyer введите значения параметров cat, src, token и type для своих ретаргетинговых кампаний.

     Примечание

    Параметр token — это такой же параметр "Токен", который вы получаете при включении отслеживания конверсий в мобильных приложениях с помощью сторонних сервисов.

Окно атрибуции повторного вовлечения по кликам

Установите продолжительность окна атрибуции повторного вовлечения по кликам — максимальный период времени после клика по объявлению, в течение которого пользователя, на которого нацелен ретаргетинг, можно атрибутировать этому объявлению. Это значение можно задать в часах (до 23) или днях (1-30):

reengagement-activate.png

Окно атрибуции повторного вовлечения по просмотрам

Чтобы начать атрибуцию показов рекламных объявлений ретаргетинга, активируйте окно атрибуции повторного вовлечения по просмотрам.

Установите продолжительность окна атрибуции повторного вовлечения по просмотрам — максимальный период времени после показа объявления, в течение которого пользователя, на которого нацелен ретаргетинг, можно атрибутировать этому объявлению. Это значение можно задать в часах (до 23) или днях (1-7):

Окно повторного вовлечения

Установите продолжительность Окно повторного вовлечения — временной интервал, в течение которого внутренние события приложения пользователя будут атрибутироваться медиа-источнику ретаргетинга. Это значение можно задавать в днях (от 1 до 90), часах (до 23) или на весь период использования приложения:

 Примечание

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

Постбэки внутренних событий приложений.

Сначала необходимо создать действие Floodlight для конкретной активности, например покупки или подписки.
Затем необходимо получить параметры действия Floodlight.

    1. Активируйте In-app event postbacks (Постбэки о внутренних событиях приложений).
    2. Чтобы добавить в список событие, определенное в SDK, или межсерверное событие, нажмите Добавить событие. В таблице ниже описаны поля, которые необходимо заполнить:
      Имя параметра Описание
      AppsFlyer event (Событие AppsFlyer)

      Имя события, полученное AppsFlyer из SDK, интегрированного в приложение, или из межсерверного события.
      Совет: Не нашли здесь нужное событие?

      • Убедитесь, что событие активировано на устройстве с неорганической установкой, и повторите поиск.
      • Введите его в поле AppsFlyer event (Событие AppsFlyer) и нажмите Create custom (Добавить другое). Подробнее о сопоставлении пользовательских событий читайте здесь.
      mapped to partner event (сопоставлено с событием партнера)

      Уникальное имя или идентификатор каждого события, определенные партнером. Возможны следующие настройки сопоставления:

      • Текстовое поле. Введите в него соответствующий идентификатор события, полученный от партнера.
      • Раскрывающийся список. Выберите наиболее подходящее предопределенное событие AppsFlyer.
      • Как есть. События отправляются в исходном виде, без сопоставления названий.

      Настройте событие, используя параметры действия Floodlight в следующем формате (см. изображение под таблицей):
      token=123XXX456XXX&type=XXXXXXXX&cat=XXXXX123456&src=58XXX35
      for users from (для пользователей от)

      Выберите вариант отправки для события.

      • Только события партнера: постбэки отправляются только в том случае, когда событие атрибутируется этому партнеру.
      • Все медиа-источники, включая органические: отправляйте постбэки для событий, атрибутированных любому партнеру, а также для органических событий.
      Включая
      • Нет данных (по умолчанию): отправляет только само событие без значения.
      • Значения и доход: отправляет все параметры события, включая значение дохода (если оно есть в событии).
      • Значения без дохода: отправляет все параметры, кроме значения дохода.
    3. [Необязательно] Нажмите на значок Добавить условие add_condition.png , чтобы установить условия для события.
    4. Нажмите Сохранить интеграцию.
Google_Marketing_Platform_in_app_event_postbacks_all_media_sources.JPG

 Примечание

  • Параметры Floodlight уникальны для каждого события. Для каждого события в приложении, которое вы настраиваете в постбэке, вам нужно предоставить уникальные параметры Floodlight.
  • Параметры Floodlight уникальны для каждого приложения. 
  • Значения параметров должны совпадать с теми, которые были введены в поля cat, src, token и type (см. выше).
  • В GMP будут автоматически переданы два дополнительных параметра: Order_ID и af_revenue.

AppsFlyer не может отправлять дополнительные параметры действий Floodlight (параметры "u") с именами выше U26. Эти параметры "u" предварительно сопоставлены и зарегистрированы в AppsFlyer, поэтому необходимо учитывать следующее:

  • Поскольку эти параметры предварительно сопоставлены, то настроить дополнительные пользовательские параметры "u" невозможно.
  • При настройке пользовательских переменных Floodlight в GMP применяйте показанное ниже сопоставление параметров.
  • Если AppsFlyer не может передать какой-либо параметр "u", то этот параметр не отправляется. Например, если отсутствуют данные об операторе, то AppsFlyer не отправляет параметр "u5".

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

Для каждого внутреннего события приложения AppsFlyer отправляет такие параметры действий Floodlight:

  Описание Пример

u1=

идентификатор устройства af

1540995037437-2811776739500410055

u2=

идентификатор клиента

eaf8a5f2.1836.4686

u3=

Android:
ID рекламы
iOS: idfa

9d9d03ab-f211-4e17-994e-d0afdf23ac01

u4=

wifi

true

u5=

carrier

Jio%204G

u6=

код страны

IN

u7=

Регион

HR

u8=

city

Gurgaon

u9=

тип устройства

motorola::Moto G (4)

u10=

версия ОС

7

u11=

версия SDK

v4.8.18

u12=

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

3.31.1

u13=

метка времени установки

1540995041

u14=

время клика

1546441586

u15=

время показа

1546441586

u16=

название кампании*

Appinstall_campaign

u17=

ID кампании

12345ABC

u18=

название группы объявлений*

Appinstall_adset

u19=

ID блока рекламы

12345ABC

u20=

название объявления*

Appinstall_ad

u21=

ID рекламы.

12345ABC

u22=

ID сайта

site_id_123456

u23=

время события

2019-01-04 12:56:35.707

u24=

Имя события

af_purchase

u25=

Значение события

{"af_price":459,"af_content_id":"77147","af_revenue":4.59,"af_currency":"EUR"}

u26=

валюта

EUR

*В таких случаях AppsFlyer не получает это название в ответе от маркетинговой платформы Google  и заполняет поле соответствующим идентификатором (т. е. название группы объявлений становится идентификатором группы объявлений).

Вкладка Attribution Link (Ссылки атрибуции)

Вкладка ссылок атрибуции неактивна для GMP, потому что это сеть с самостоятельной атрибуцией, которая не использует внешние ссылки атрибуции.

Однако ссылки атрибуции нужны для интеграции с GMP:

Ссылки атрибуции для CM360 + медиа-источник

Для запуска кампаний с CM360 и медиа-источником необходимо две ссылки атрибуции:

  • Ссылка измерения для CM360.
  • Ссылка атрибуции AppsFlyer для конкретного медиа-источника (интегрированный партнер или собственный медиа-источник).

См. инструкции по настройке ссылок атрибуции для CM360.

Ссылки атрибуции для DV360 (DBM)

Ссылки атрибуции AppFlyerс можно использовать с DV360 только для регистрации показов и нажатий. Эти ссылки НЕ используются для атрибуции, и любая дополнительная информация, которая в них содержится, не анализируется и не используется для каких-либо целей.

Чтобы измерять с помощью AppsFlyer количество кликов, полученных от сервиса DV360, необходимо добавить URL-адрес ссылки атрибуции AppsFlyer на дэшборд DV360. Убедитесь, что название кампании в URL-адресе ссылки атрибуции совпадает с идентификатором размещения в GMP. Иначе AppsFlyer не сможет получать данные по кликам и добавлять их к соответствующим кампаниям.

 Важно!

Использовать ссылки атрибуции для GMP DV360 (DBM) необязательно.


Чтобы вести в AppsFlyer учет кликов, используйте эту ссылку:

https://app.appsflyer.com/ADD-APP-ID?pid=doubleclick_int&af_siteid=${UNIVERSAL_SITE_ID}
&af_ad_id=${CREATIVE_ID}&c=${PLACEMENT_ID}&af_c_id=${PLACEMENT_ID}

Чтобы вести в AppsFlyer учет показов , используйте эту ссылку:

https://impression.appsflyer.com/ADD-APP-ID?pid=doubleclick_int&af_siteid=%24{UNIVERSAL_SITE_ID}
&af_ad_id=${CREATIVE_ID}&c=${PLACEMENT_ID}&af_c_id=${PLACEMENT_ID}

Вкладка "Cost" (Затраты)

Данные о затратах для GMP недоступны.

Вкладка "Ad Revenue" (Доходы от рекламы)

  • Вы можете подключить несколько аккаунтов GMP к одному приложению.
  • Если у вас больше одного аккаунта GMP, повторите следующую процедуру для каждого аккаунта. Внимание! В пользовательском интерфейсе не указывается, что вы подключили более одного аккаунта. 

Чтобы включить API доходов от рекламы:

Вкладка Permissions (Разрешения)

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