Интеграция DDM для отслеживания сторонних приложений

Следующий сквозной процесс описывает как настройку рекламодателя, так и стороннюю реализацию, необходимую для запуска кампании в продуктах DoubleClick для покупателей с использованием стороннего решения для отслеживания приложений. Дополнительные сведения о DoubleClick Digital Marketing в целом, а также обзор функций атрибуции в приложении см. на справочной странице DoubleClick Digital Marketing .

  1. Рекламодатель настраивает событие "Конверсия" в DDM для представления установки/конверсии (только Bid Manager – пиксель конверсии) (Менеджер кампаний – действие Floodlight).

  2. Рекламодатель «связывает» событие-конверсию DDM со сторонним интерфейсом и предоставляет ключевые переменные, которые идентифицируют рекламодателя и группу конверсионных действий.

    • src — это идентификатор рекламодателя, который является источником действия Floodlight.
    • cat — это строка тега действия, которую серверы Floodlight используют для определения группы действий, к которой принадлежит действие.
    • type – это строка тега группы, определяющая группу действий, с которой связано действие Floodlight.
    • u1, u2, ... (если доступно) — это пары "ключ-значение" пользовательских переменных Floodlight.

  3. Кроме того, рекламодатель должен предоставить третьим сторонам свой специальный токен авторизации: token — это характерная для рекламодателя буквенно-цифровая строка, которая должна передаваться вместе с каждым запросом сервера в DDM.

  4. Рекламодатель запускает рекламную кампанию в приложении с рекламными тегами, обслуживаемыми DBM на биржах с назначением ставок в реальном времени или обслуживаемыми DCM на носителях, приобретаемых напрямую.

  5. Конечный пользователь видит и/или нажимает на объявления, которые регистрируются DDM.

  6. Когда конечный пользователь устанавливает приложение и/или завершает событие конверсии ("игра" и т. д.), сторонние серверы "пингуют" DDM при каждом действии приложения.

    https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312

    куда:

    • src — это идентификатор рекламодателя, который является источником действия Floodlight.
    • cat — это строка тега действия, которую серверы Floodlight используют для определения группы действий, к которой принадлежит действие.
    • type – это строка тега группы, определяющая группу действий, с которой связано действие Floodlight.
    • ord — это случайное число, которое делает тег Floodlight уникальным.
    • u1, u2, ... (если доступно) — это пары "ключ-значение" пользовательских переменных Floodlight.

    с дополнительными параметрами, отправляемыми через полезную нагрузку JSON в HTTP POST:

    {
  "app": {
    "bundle": "com.rovio.angrybirds"
  },
  "device": {
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25",
    "ip": "108.176.57.230",
    "didmd5": "A2D2DA47AC2DE1BCA16883BD5CAA6F2F",
    "lmt": 1
  }
}

    и токен авторизации рекламодателя передается в заголовке авторизации HTTP:

    Authorization: Token token="[advertiser authorization token string]"

    куда:

    • app (обязательно) — это объект JSON, представляющий приложение, в котором произошло действие преобразования. Использовать app: {} , если приложение, в котором произошла конверсия, недоступно.
    • bundle (если доступно) — это поле объекта приложения, содержащее строковое значение имени пакета Play Store или идентификатора App Store.
    • device — это объект JSON, представляющий устройство, на котором произошло действие преобразования.
    • ua — поле объекта устройства, представляющее строку пользовательского агента приложения, в котором было записано действие. Этот параметр является обязательным.
    • ip (если доступно) — это IPv4-адрес устройства, назначенный устройству. Этот параметр является обязательным.
    • didmd5 — это хеш-строка MD5 значения IDFA или рекламного идентификатора Google Play в верхнем регистре.
    • lmt — это целое число со значением 1, если пользователь включил параметр «Ограничить отслеживание рекламы» с помощью IDFA/AdID, или 0, если он не установлен.

    DDM отправит ответ в формате JSON о том, связано ли событие-конверсия с просмотром или кликом, выполненным DCM, и если "ДА", то с дополнительной информацией о событии (последний просмотр или клик):

    - Ad ID
- Site ID
- Placement ID
- Creative ID
- Timestamp

    Пример ответа JSON может выглядеть так:

    {"attributed": 1,  // Whether the conversion can be attributed to a DCM event.
 "last_impression_ad_id":283641088,
 "last_impression_site_id":1408067,
 "last_impression_placement_id":107616368,
 "last_impression_creative_id":60162352,
 "last_impression_timestamp":1415647607,
 "last_click_ad_id":283641088,
 "last_click_site_id":1408067,
 "last_click_placement_id":107616368,
 "last_click_creative_id":60162352,
 "last_click_timestamp":1415647657,
 "last_click_exclid":"CKm0nLKhyssCFceH2wod8l4I4A"}

    куда:

    • attributed имеет значение 1 (если конверсию можно связать с показом или кликом) или 0 (если не связать).
    • last_impression_ad_id (если атрибут = 1) — это идентификатор объявления для последнего показа.
    • last_impression_site_id (при атрибуте = 1) — идентификатор сайта для последнего показа.
    • last_impression_placement_id (если атрибут = 1) — это идентификатор места размещения для последнего показа.
    • last_impression_creative_id (если атрибут = 1) — это идентификатор креатива для последнего показа.
    • last_click_ad_id (если атрибут = 1 и клик был атрибутирован) — это идентификатор объявления для последнего клика.
    • last_click_site_id (если атрибут = 1 и клик был атрибутирован) — это идентификатор сайта для последнего клика.
    • last_click_placement_id (если атрибут = 1 и клик был атрибутирован) — идентификатор места размещения для последнего клика.
    • last_click_creative_id (если атрибут = 1 и клик был атрибутирован) — это идентификатор креатива для последнего клика.
    • last_click_exclid соответствует уникальному идентификатору клика, который заполняется через %eiid! макрос

    с кодами ошибок HTTP для следующих сценариев:

    • HTTP 204 , если превышена квота запросов.
    • HTTP 400 , когда запрос считается недействительным (например, отсутствуют обязательные параметры) и сервер вернулся к отслеживанию пикселей.
    • HTTP 401 , если токен авторизации недействителен.
    • HTTP 404 для любых плохих запросов.

    Рекламодатель сможет видеть отчеты кампании в вашей системе; рекламодатель также сможет просматривать отчеты о конверсиях в DCM с теми же параметрами, что и выше.