Отслеживание конверсий и ремаркетинг в приложениях — Спецификации запроса/ответа

Пользовательский агент приложения

В рамках наших более широких усилий по борьбе со спамом мы разработали стандартизированную спецификацию для заголовка User-Agent, отправляемого аналитическим/рекламным продуктом от имени пользователя приложения. Пользовательский агент приложения может быть получен из собственного кода, чтобы соответствовать следующей спецификации:

name version (os_and_version; locale; device; build; Proxy)

Определение этих полей следующее:

Компоненты User-Agent
name

Название продукта аналитики/рекламы. ( Google AdMob )

Обратите внимание, что если пользовательский агент создается на стороне клиента, name вместо этого должно быть идентификатором пакета клиентского приложения.

Андроид
// Specified by API consumer.
iOS
// Specified by API consumer.
version

Версия продукта аналитики/рекламы. ( 7.10.1 )

Андроид
// Specified by API consumer.
iOS
// Specified by API consumer.
os_and_version

Операционная система и версия операционной системы, в которой работает приложение. ( Android 6.0 )

Андроид
String osAndVersion =
    "Android " + Build.VERSION.RELEASE;
iOS
UIDevice *uid =
  [UIDevice currentDevice];
NSString *osAndVersion =
  [NSString
    stringWithFormat:@"%@ %@",
    [uid systemName],
    [uid systemVersion]];
locale

Тег локали IETF для устройства с использованием двухбуквенного языка и кода страны, разделенных символом подчеркивания. ( en_US )

Андроид
String locale = Locale.getDefault();
iOS
NSString *locale =
  [[NSLocale currentLocale]
    localeIdentifier]
device

Имя физического устройства, на котором запущен продукт аналитики/рекламы. ( iPhone9,1 )

Андроид
String device = Build.MODEL;
iOS
@import Darwin.sys.sysctl;

NSString *device(void) {
  size_t bufferSize = 64;
  NSMutableData *buffer =
    [[NSMutableData alloc]
      initWithLength:bufferSize];
  int status =
    sysctlbyname("hw.machine",
      buffer.mutableBytes,
      &bufferSize, NULL, 0);
  if (status != 0) {
    return nil;
  }
  return [[NSString alloc]
    initWithCString:buffer.mutableBytes
    encoding:NSUTF8StringEncoding];
}
build

«Сборка/», за которым следует номер сборки операционной системы. ( Build/13D15 )

Андроид
String build = "Build/" + Build.ID;
iOS
@import Darwin.sys.sysctl;

NSString *build(void) {
  size_t bufferSize = 64;
  NSMutableData *buffer =
    [[NSMutableData alloc]
      initWithLength:bufferSize];
  int status =
    sysctlbyname("kern.osversion",
      buffer.mutableBytes,
      &bufferSize, NULL, 0);
  if (status != 0) {
    return nil;
  }
  return [[NSString alloc]
    initWithCString:buffer.mutableBytes
    encoding:NSUTF8StringEncoding];
}

Включить только ; Proxy в конце пользовательского агента приложения при создании серверной части пользовательского агента приложения. Если User-Agent приложения полностью создан на стороне клиента, исключить ; Proxy . Таким образом, User-Agent приложения может быть:

  • Android: AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M; Proxy)
  • iOS: AdMob/7.10.1 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)

Запрос на отслеживание конверсий

Цель запросов на отслеживание конверсий – уведомить Google Реклама о событии в приложении, которое должно отслеживаться как конверсия и/или использоваться для заполнения списка ремаркетинга, а также для получения метаданных, описывающих любой клик, предшествовавший этому событию.

Все вызовы API выполняются в домене www.googleadservices.com . Запросы на конверсию — это POST -запросы через HTTPS по следующему пути:

/pagead/conversion/app/version
, где version — предполагаемая версия API отслеживания конверсий. В настоящее время единственная действующая версия — 1.0 .

Стандартный запрос на преобразование приложения будет содержать следующие параметры.

Запрос на отслеживание конверсий
dev_token

Необходимый

Местонахождение: Запрос

Уникальный статический токен разработчика, выдаваемый потребителю API.

Z_eErE4DkvcKjDM1OVE4c4
link_id

Необходимый

Местонахождение: Запрос

Идентификатор ссылки, связывающий токен разработчика потребителя API с конкретным приложением.

31FF8D67E5BB5DD5029DCC2734C2F884
app_event_type

Необходимый

Местонахождение: Запрос

Имя произошедшего события приложения. Это поле является перечислением и может принимать только следующие значения:

 • first_open
 • session_start
 • in_app_purchase
 • view_item_list
 • view_item
 • view_search_results
 • add_to_cart
 • ecommerce_purchase
 • custom

Событие first_open всегда должно отправляться для атрибуции установок, а событие session_start всегда должно отправляться для повторной атрибуции сеансов. Используйте in_app_purchase для покупок в собственном магазине приложений; используйте ecommerce_purchase для всех остальных покупок.

app_event_name

Требуется при определенных условиях

Местонахождение: Запрос

Имя любого пользовательского события приложения, которое не принимается в поле app_event_type . Это поле должно содержать от 1 до 64 символов Юникода (с использованием кодировки UTF-8). Это поле обязательно, если app_event_type является настраиваемым .

level_achieved
Level Achieved

Это поле не должно содержать никаких значений, зарезервированных для app_event_type . Если используется зарезервированное имя события, API вернет ошибку APP_EVENT_NAME_RESERVED_VALUE .

app_event_data

По желанию

Местонахождение: Тело

Пересылайте любые дополнительные расширенные данные о событиях в виде простого объекта JSON, сопоставляющего строковые ключи со значениями. Допустимыми значениями являются строки и массивы строк.

{"level": 5, "attempts": 20}
rdid

Необходимый

Местонахождение: Запрос

Допустимая строка UUID, представляющая необработанный идентификатор устройства.

f10e1de2-e237-4f50-b6aa-843c45cc63d6

В случае, если этот идентификатор устройства отсутствует, например, идентификатор устройства от несогласного пользователя ATT, установите его равным нулю.

00000000-0000-0000-0000-000000000000
id_type

Необходимый

Местонахождение: Запрос

Тип идентификатора, хранящегося в поле rdid . Мы можем принять здесь больше значений в будущем, но для начала мы будем поддерживать следующее.

Андроид

advertisingid

iOS

idfa
lat

Необходимый

Местонахождение: Запрос

Статус ограничения отслеживания рекламы для устройства.

  • 0 : Пользователь не ограничивал отслеживание рекламы.
  • 1 : Пользователь решил ограничить отслеживание рекламы.

app_version

Необходимый

Местонахождение: Запрос

Текущая версия приложения. Это должно быть стандартизировано следующим образом.

Андроид

packageManager.getPackageInfo(packageName(),
  PackageManager.GET_META_DATA).versionName

iOS

[[[NSBundle mainBundle] infoDictionary]
  objectForKey:@"CFBundleShortVersionString"]

1.2.4
os_version

Необходимый

Местонахождение: Запрос

Текущая версия хост-ОС приложения. Это должно быть стандартизировано следующим образом.

Андроид

android.os.Build.VERSION.RELEASE

iOS

[[UIDevice currentDevice] systemVersion]
sdk_version

Необходимый

Местонахождение: Запрос

Версия SDK, в которой измерялось событие. Поскольку это в основном используется для отладки, оно должно точно отражать версию выпуска, опубликованную с вашими выпусками SDK. Если приложение не использует SDK, укажите то же значение, что и app_version .

1.9.5r6
timestamp

Необходимый

Местонахождение: Запрос

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

1432681913.123456
value

По желанию

Местонахождение: Запрос

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

1.99
currency_code

Требуется при определенных условиях

Местонахождение: Запрос

Код валюты ISO 4217 для параметра value . Это поле является обязательным, если указан параметр value и не является пустым .

USD
gclid

Требуется при определенных условиях

Местонахождение: Запрос

Значение параметра запроса gclid из URL-адреса ссылки на контент, которая открыла приложение.

Cj0KEQjw0dy4BRCuuL_e5M
market_referrer_gclid

Требуется при определенных условиях

Местонахождение: Запрос

Значение параметра запроса gclid из URL-адреса ссылки на контент, полученное из значения install_referrer через API Play Install Referrer .

BX3QojHp4mY5MrJtFM_d1u
gclid_only_request

Требуется при определенных условиях

Местонахождение: Запрос

Идентификатор для атрибуции на основе gclid в сценариях, где rdid (advertisingid) not или содержит все zeroes И присутствует либо gclid , либо market_referrer_gclid .

1
gbraid

Требуется при определенных условиях

Местонахождение: Запрос

Последнее увиденное значение gbraid , отправленное через URL-адрес глубокой ссылки, которая открыла приложение. Обратите внимание, что это должно быть кэшировано в приложении, чтобы его можно было отправить с будущими конверсиями, которые происходят в приложении.

ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
app_open_source

Требуется при определенных условиях

Местонахождение: Запрос

Значение для идентификации переходов по ссылкам на объявления или обычных сеансов приложений.

ad_click or organic
User-Agent

Необходимый

Местонахождение: Заголовок

Пользовательский агент приложения, как определено в предыдущем разделе.

AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M)
X-Forwarded-For

Необходимый

Местонахождение: Заголовок

Общедоступный IPv4- или IPv6-адрес устройства, на котором было измерено событие.

216.58.194.174

Все запросы должны быть отправлены через HTTPS. Пинги, полученные через HTTP, будут отклонены.

Обратите внимание, что если тело запроса пусто (в случаях, когда в полезной нагрузке app_event_data не передаются расширенные данные о событии), наш сервер требует, чтобы вы явно установили заголовок Content-Length: 0 в своем запросе.

Пример запроса

Пример допустимого запроса на отслеживание конверсий с нестандартным типом события и информацией о доходе :

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8
{"app_event_data":{"item_id":["Crayons","Markers"]}}

Пример допустимого запроса на отслеживание конверсий с нестандартным типом события и информацией о доходах с недоступным rdid (advertisingid) :

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; Android,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8
{"app_event_data":{"item_id":["Crayons","Markers"]}}

Пример допустимого запроса на запуск сеанса :

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

Пример действительного запроса повторной атрибуции начала сеанса для сеанса, который начался с глубокой ссылки example://product/123?gclid=Cj0KEQjw0dy4BRCuuL_e5M :

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

Кодирование данных события

Для параметра тела app_event_data используйте следующие соглашения для примитивных типов данных:

  • Плавать

    • Используйте символ точки в качестве десятичного разделителя независимо от локализации приложения.
    • Используйте двузначную десятичную точность для представления денежных значений. например 2,99
    • Не используйте экспоненциальное представление, например 2E+9.
    • Не используйте запятую для разделения групп цифр, например 1 000 000.
    • Допустимые примеры:
      • -0.5
      • 2.99
      • 1000000.123

  • Целое число

    • Отправлять только целые целые значения без десятичных цифр
    • Не используйте запятую для разделения групп цифр, например 1 000 000.
    • Допустимые примеры:
      • 1000
      • -11
      • 0

  • Свидание

    • Формат даты: гггг-мм-дд
      • yyyy = год из четырех цифр, например, 2016
      • mm = месяц из двух цифр, например, 09 для сентября
      • dd = день из двух цифр, например 23 для 23-го числа месяца
    • Всегда отправляйте указанное выше количество цифр, например, если вы отправляете значение dd для 5-го числа месяца, отправьте 05 .
    • Допустимые примеры:
      • "2016-09-23"
      • "1990-12-31"

  • Отметка времени

    • Формат времени: временная метка Unix/Epoch , определенная в часовом поясе UTC с точностью до микросекунд.
    • Допустимые примеры:
      • 1478713087 на ср, 09 ноября 2016 г., 17:38:07 по Гринвичу
      • 1073513982.123000 для среды, 07 января 2004 г., 22:19:42.123 по Гринвичу

  • Массивы

    • Отправлять только массивы примитивных значений (строки, числа и логические значения)
    • Допустимые примеры:
      • [123, 456, 789]
      • ["abc"]

Ответ на отслеживание конверсий

Ответ отслеживания переходов имеет следующий формат:

{
  "ad_events": [<ad event objects>],
  "errors": [<error strings>],
  "attributed": true|false
}

И массивы ad_events, и массивы ошибок могут быть пустыми.

Мы ожидаем, что ошибки будут машиночитаемыми кодами ошибок, например, invalid_timestamp .

Рекламные события являются основными объектами атрибуции приложений и будут содержать следующие свойства.

Ответ на отслеживание конверсий
ad_event_id

Всегда присутствует

нить

ad_event_id служит уникальным идентификатором рекламных событий. Он повторно используется в запросе на межсетевую атрибуцию и должен быть зарегистрирован/сохранен для целей отладки.

Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
conversion_metric

Всегда присутствует

нить

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

conversion
timestamp

Всегда присутствует

количество

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

1432681913.123456
campaign_type

Всегда присутствует

нить

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

ACI
ACE
Search
Display
Video
Shopping
Hotel
Performance_Max
Other

ACI — это сокращение от App Campaign for Install. ACE — это сокращение от App Campaigns for Engagement.

campaign_id

Всегда присутствует

количество

Числовой идентификатор кампании, вызвавшей рекламное событие. Уникальность этого значения гарантирована.

123456789
campaign_name

Всегда присутствует

нить

Определенное рекламодателем название кампании, которая произвела рекламное событие. Уникальность этого значения не гарантируется.

Occasional Gamers (Video)
ad_type

Всегда присутствует

нить

Тип рекламы, которая привела к рекламному событию. Это значение можно использовать для различения различных типов запасов следующим образом.

Продвижение приложения
ClickToDownload
Взаимодействие с приложением
AppDeepLink
Взаимодействие с приложением — процесс установки и продолжения
AppDeepLinkContinue
Улавливание всех других значений
Unknown
external_customer_id

Всегда присутствует

количество

Идентификатор рекламодателя, которому принадлежит кампания, вызвавшая рекламное событие. Это значение можно использовать для дифференциации аккаунтов Google Рекламы.

123456789
location

Всегда присутствует

количество

Идентификационный код местоположения для географического местоположения рекламного события. Обратитесь к справке по Google Ads API , чтобы узнать, как интерпретировать коды местоположений.

network_type

Всегда присутствует

нить

В этом поле будет указана рекламная сеть Google Ads, в которой произошло рекламное событие. Возможные значения следующие.

Search
Display
YouTube
network_subtype

Будет null , если для типа campaign_type задано значение ACI или ACE , а network_type Display .

нить

В этом поле будет указан «подтип» рекламной сети Google Ads, в которой произошло рекламное событие. Возможные значения зависят от типа основной сети.

Обычный поиск Google
GoogleSearch
Поисковые партнеры Google
SearchPartners

Отображать

Мобильные веб-издатели
mGDN
Издатели приложений
Google AdMob

YouTube

Сеть YouTube Videos
YouTubeVideos
Поисковая сеть YouTube
YouTubeSearch
VideoPartners
video_id

Предоставляется только в том случае, если network_type – это YouTube , а campaign_type – не ACI и ACE .

нить

Идентификатор видео YouTube, связанный с рекламным событием.

dQw4w9WgXcQ
keyword

Предоставляется только в том случае, если network_type — это Search , а campaign_type — это не ACI и ACE .

нить

Ключевое слово для поиска, связанное с рекламным событием.

+food +delivery
match_type

Предоставляется только в том случае, если network_type — это Search , а campaign_type — это не ACI и ACE .

нить

Тип соответствия для ключевых слов поиска.

Точный
e
Фраза
p
Широкий
b
placement

Предоставляется только в том случае, если network_type — Display , а campaign_type — не ACI и ACE .

нить

Место размещения, связанное с рекламным событием.

mobileapp::1-343200656
ad_group_id

Всегда присутствует

количество

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

123456789
ad_group_name

Предоставляется, только если для типа campaign_type задано значение ACI , ACE или ACPRE .

нить

Определенное рекламодателем название группы объявлений, создавшей рекламное событие. Уникальность этого значения не гарантируется.

My App AdGroup
creative_id

Предоставляется только в том случае, если для типа campaign_type не указано ACI и ACE .

количество

Числовой идентификатор креативного рекламного блока, создавшего рекламное событие. Уникальность этого значения гарантирована.

123456789
interaction_type

Это поле всегда будет вовлеченным.

нить

Примеры ответов

Пример ответа отслеживания переходов, когда запрос содержит ошибки:

{
  "ad_events": [],
  "errors": ["INVALID_CURRENCY_CODE"],
  "attributed": false
}

Пример отрицательного ответа на отслеживание конверсий:

{
  "ad_events": [],
  "errors": [],
  "attributed": false
}

Ответ на отслеживание конверсий будет возвращен для всех запросов на отслеживание конверсий.

Пример положительного ответа на отслеживание конверсий для универсальной кампании для приложений:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

Пример положительного ответа на отслеживание конверсий для кампании в поисковой сети:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Search",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": "+space +birds",
    "match_type": "b",
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

Пример положительного ответа на отслеживание конверсий для кампании в контекстно-медийной сети:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Display",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "mGDN",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": "mobile-app::2-343200656",
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

Пример положительного ответа на отслеживание конверсий для кампании на YouTube:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Video",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "YouTube",
    "network_subtype": "YouTubeVideos",
    "video_id": "dQw4w9WgXcQ",
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

Межсетевой запрос атрибуции

Когда Google Ads отвечает на запрос отслеживания конверсий утвердительно, потребитель API должен уведомить Google Ads о своем решении по межсетевой атрибуции после определения последнего клика.

Запрос на кросс-сетевую атрибуцию идентичен исходному запросу на отслеживание конверсий, но с путем запроса:

/pagead/conversion/app/1.0/cross_network

и добавление двух обязательных параметров:

Межсетевой запрос атрибуции
ad_event_id

Необходимый

Местонахождение: Запрос

Идентификатор ad_event_id из рекламного события, связанного с атрибуцией в предыдущем запросе.

attributed

Необходимый

Местонахождение: Запрос

Получил ли Google Реклама признание за конверсию потребителем API. Либо 0 , либо 1 .

Пример допустимого межсетевого запроса атрибуции:

POST /pagead/conversion/app/1.0/cross_network
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=custom
       &app_event_name=level_achieved
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &ad_event_id=Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
       &attributed=1
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

Действительный запрос межсетевой атрибуции всегда будет получать общий ответ 200 без тела ответа.