Эта страница переведена с помощью Cloud Translation API.

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

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

Более подробную информацию о DoubleClick Digital Marketing в целом, а также обзор функций атрибуции в приложении см. на странице справочной информации DoubleClick Digital Marketing .

Рекламодатель настраивает событие «Конверсия» в DDM для представления установки или конверсии (только Bid Manager — пиксель конверсии) (Campaign Manager — действие Floodlight).
Рекламодатель «привязывает» событие конверсии DDM в стороннем интерфейсе и предоставляет ключевые переменные, которые идентифицируют рекламодателя и группу действий конверсии.
- src — идентификатор рекламодателя, который является источником активности Floodlight.
- cat — строка тега активности, которую серверы Floodlight используют для идентификации группы активности, к которой принадлежит активность.
- type — строка тега группы, которая идентифицирует группу действий, с которой связано действие Floodlight.
- u1, u2, ... (если доступно) — это пользовательские переменные Floodlight «ключ-значение».
Рекламодатель добавляет переменные, чтобы обозначить сбор согласия для соблюдения DMA .
- eea используется для идентификации пользователей ЕЭЗ.
  - eea=0 указывает, что пользователь не из ЕЭЗ.
  - eea=1 указывает, что пользователь из ЕЭЗ.
- ad_user_data — флаг согласия на использование данных пользователя в рекламных целях.
  - Необходимо устанавливать только если eea=1
  - ad_user_data=0 указывает, что пользователь отклонил согласие на передачу данных на уровне пользователя в Google для рекламных целей.
  - ad_user_data=1 указывает, что пользователь дал согласие на передачу данных на уровне пользователя в Google для рекламных целей.
- npa используется для персонализации рекламного контента.
  - npa=0 указывает, что пользователь соглашается на персонализацию.
  - npa=1 указывает, что пользователь не дал согласия на персонализацию.
- test_request_reason=dma можно использовать для проверки параметров DMA
  - Проверяет все параметры DMA и возвращает предупреждения.
  - Возвращает множественные ответы с поддельными кликами.
  - Регистрирует конверсии как тестовые конверсии.
Кроме того, рекламодателю необходимо предоставить третьим лицам свой специальный токен авторизации:
token — это специфичная для рекламодателя буквенно-цифровая строка, которая должна передаваться вместе с каждым запросом сервера в DDM.
Рекламодатель запускает рекламную кампанию в приложении с использованием рекламными тегами, обслуживаемыми DBM на биржах торгов в режиме реального времени или обслуживаемыми DCM на напрямую закупаемых носителях.
Конечный пользователь видит и нажимает на рекламу, что регистрируется DDM.
Когда конечный пользователь устанавливает приложение или завершает событие конверсии, например, «игру», сторонние серверы «пингуют» DDM при каждой активности приложения:
Пример URL для пользователя, не находящегося в ЕЭЗ
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0
```
Пример URL для пользователя в ЕЭЗ
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=1;ad_user_data=1;npa=0
```
где:
- src — идентификатор рекламодателя, который является источником активности Floodlight.
- cat — строка тега активности, которую серверы Floodlight используют для идентификации группы активности, к которой принадлежит активность.
- type — строка тега группы, которая идентифицирует группу действий, с которой связано действие Floodlight.
- ord — случайное число, которое используется для того, чтобы сделать тег Floodlight уникальным.
- u1, u2, ... (если доступно) — это пользовательские переменные Floodlight «ключ-значение».
- eea определяет, находится ли пользователь в ЕЭЗ.
- ad_user_data определяет, дает ли пользователь согласие на использование файлов cookie и измерений.
- npa определяет, дает ли пользователь согласие на персонализацию.
с дополнительными параметрами, отправленными через полезную нагрузку JSON в HTTP POST:
```
{
  "app": {
    "bundle": "com.rovio.angrybirds"
  },
  "device": {
    "ua": "Mozilla/5.0 (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, и если «ДА», то дополнительную информацию о событии (последний просмотр или клик):
- Идентификатор объявления
- Идентификатор сайта
- Идентификатор размещения
- Творческий идентификатор
- Метка времени
Пример ответа 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",
  "cps": <cps>,
  "ad_events": [
    <ad event objects>
  ],
  "warnings": [<warning strings>],
  "errors": [<error strings>],
}
```
где:
- attributed — значение 1 (если конверсию можно приписать показу или клику) или 0 (если невозможно приписать).
- last_impression_ad_id (если атрибут = 1) — идентификатор объявления для последнего показа.
- last_impression_site_id (если атрибут = 1) — идентификатор сайта для последнего показа.
- last_impression_placement_id (если attributed = 1) — идентификатор места размещения для последнего показа.
- last_impression_creative_id (если атрибут = 1) — идентификатор креатива для последнего показа.
- last_click_ad_id (если attributed = 1 и клик был атрибутирован) — идентификатор объявления для последнего клика.
- last_click_site_id (если attributed = 1 и клик был атрибутирован) — идентификатор сайта для последнего клика.
- last_click_placement_id (если attributed = 1 и клик был атрибутирован) — идентификатор места размещения для последнего клика.
- last_click_creative_id (если attributed = 1 и клик был атрибутирован) — идентификатор креатива для последнего клика.
- last_click_exclid соответствует уникальному идентификатору клика, заполненному с помощью макроса %eiid!
Начиная с введения DMA в марте 2024 года, также будут доступны следующие поля:
- cps указывает, к какой базовой платформе относится событие
  - a : Реклама
  - m : Карты
  - p : Play Маркет
  - s : Поиск
  - h : Покупки
  - y : YouTube
- ad_events — это массив объектов ad_event , содержащий все события конверсии.
  - Объект ad_event имеет следующие поля:
  - product_type — строка, указывающая продукт, ответственный за конверсию. Это может быть DCM или DBM .
  - interaction_type — тип взаимодействия, приведшего к событию. impression или click .
  - conversion_metric — это метрика конверсии, используемая для атрибуции. Это может быть conversion или view_through_conversion .
  - timestamp — это временная метка UNIX, указывающая на событие, произошедшее с рекламой, с точностью до микросекунды. Это значение следует использовать для атрибуции последнего клика.
  - campaign_type определяет тип кампании, которая привела к рекламному событию.
  - line_item_id (только DBM) — идентификатор позиции DBM, которая создала событие объявления.
  - line_item_name (только DBM) — имя позиции DBM, которая создала рекламное событие.
  - placement_id (только DCM) — идентификатор тега размещения DCM, который создал событие объявления.
  - placement_name (только DCM) — имя тега размещения DCM, который создал событие объявления.
  - external_customer_id — идентификатор рекламодателя, которому принадлежит кампания, создавшая рекламное событие.
    - Если product — DBM, это поле представляет собой идентификатор рекламодателя DBM.
    - Если product — DCM, это поле представляет собой идентификатор рекламодателя DCM.
  - creative_id — идентификатор рекламного блока, создавшего рекламное событие.
    - Если product — DBM, это поле представляет собой идентификатор креатива DBM.
    - Если product — DCM, это поле представляет собой идентификатор креатива DCM.
  - exchange_id (только DBM) — идентификатор биржи, на которой размещена реклама DBM.
  - insertion_order_id (только DBM) — идентификатор заказа на вставку DBM.
  - site_id (только DCM) — идентификатор сайта DCM для рекламного события.
  - cps указывает, к какой базовой платформе относится событие объявления. Подробности см. в полном описании поля cps выше в документации.
- warnings — это массив предупреждений, создаваемых событием конверсии.
- errors — это массив ошибок, создаваемых событием конверсии с кодами ошибок HTTP для следующих сценариев:
  - HTTP 204 если квота запросов превышена.
  - HTTP 400 когда запрос считается недействительным (например, отсутствуют обязательные параметры, и сервер перешел на пиксельное отслеживание).
  - HTTP 401 если токен авторизации недействителен.
  - HTTP 404 для любых плохих запросов.
Рекламодатель сможет просматривать отчеты о кампаниях в вашей системе; рекламодатель также сможет просматривать отчеты о конверсиях в DCM с теми же параметрами.
Дополнительные примеры ответов после вступления в силу закона о доступе к информации (DMA) в марте 2024 г.
Пример ответа отслеживания приписанных конверсий, где конверсия приписывается обоим взаимодействиям рекламы «Поиск» и «YouTube», но согласие на перекрестное использование 5(2)(b) + 5(2)(c) между CPS «Поиск» и «YouTube» отклонено:
```
{
  attributed: 1,
  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: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A",
  cps: "s",
  ad_events: [{
      cps : "s",
      product_type: "DCM",
      interaction_type: "click",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647655.123456,
      site_id: 1408067,
      }, {
      cps : "s",
      product_type:"DCM",
      interaction_type: "impression",
      ad_event_type: "impression",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647607.123456,
      site_id: 1408067
      },{
      cps : "y",
      product_type: "DCM",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616370,
      placement_name: "Placement on Youtube",
      external_customer_id: 7480542,
      creative_id: 6016444,
      timestamp: 14344344.123456,
      site_id: 140806
      },
  ]}
```
Пример утвердительного ответа отслеживания конверсий для кампании DBM:
```
{
  attributed: 1,
  last_click_ad_id: 283641088,
  last_click_site_id: 1408067,
  last_click_placement_id: 107616368,
  last_click_creative_id :60162352,
  last_click_timestamp: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A"
  cps: "y",
  ad_events: [{
    product_type: "DBM",
    interaction_type: "click",
    ad_event_type: "click",
    campaign_type: "Display",
    line_item_id: 123456789,
    line_item_name: "TEST LINE ITEM NAME",
    external_customer_id: 2550,
    creative_id: 512333,
    exchange_id: 132,
    insertion_order_id: 523423,
    timestamp: 1432681913.123456
    cps: "y"
  },
  {
    product_type: "DCM",
    interaction_type: "click",
    campaign_type: "Display",
    placement_id: 9342323,
    placement_name: "TEST PLACEMENT NAME",
    external_customer_id: 7480542,
    creative_id: 8234234,
    timestamp: 1432681913.123456,
    cps: "y"
  }
]}
```

Интеграция DDM для отслеживания сторонних приложений Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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