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

Атрибуция приложения, соответствующего политике конфиденциальности

Краткое содержание

Потребители API, использующие API отслеживания конверсий и ремаркетинга приложений Google Ads для прямой передачи конверсий в приложениях, должны следовать следующим рекомендациям для Android и iOS . Это позволит гарантировать, что клики пользователей, отказавшихся от отслеживания или персонализации рекламы, будут атрибутироваться только с использованием рабочих процессов, соответствующих требованиям конфиденциальности. Дополнительную информацию об определениях параметров и ожидаемых значениях см. в разделе «Обзор спецификаций запросов и ответов».

Приложения для Android

Объем

Установка приложения и вовлеченность в приложение через все кампании Google Ads

Фон

В настоящее время пользователи Android, отказавшиеся от персонализации рекламы, не могут отслеживаться с помощью рекламного идентификатора Android (согласно политике Google). Вместо этого Google использует gclid — параметр URL клика, который не сохраняется на устройстве. Кроме того, Google может использовать gbraid — агрегированный параметр URL клика, в других сценариях, где согласие пользователя не было предоставлено.

Руководство

Потребители API отслеживания конверсий и ремаркетинга приложений должны убедиться, что gclid и gbraid правильно хранятся и передаются.

Поддерживаемые сценарии

Поддерживаемый сценарий: установка (пользователь ранее не устанавливал приложение)

Если установка приложения инициирована глубокой ссылкой, перенаправляющей в магазин Google Play, и пользователь впервые открывает приложение, проанализируйте значение gclid из поля install_referrer API Play Install Referrer и сохраните его на устройстве или сервере, используя идентификатор 1st-party. Каждое значение должно храниться в течение 180 дней или до тех пор, пока не будет заменено другим, более новым значением. Значение gclid должно передаваться через поле запроса конверсии market_referrer_gclid .

Рекламный идентификатор доступен

Если доступен рекламный идентификатор Android , market_referrer_gclid необходимо отправлять вместе с соответствующим событием first_open и ВСЕМИ последующими сеансами и событиями приложения (например, session_start , add_to_cart , in_app_purchase и т. д.).

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

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u

Пример: сеанс и события приложения

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=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u

Рекламный идентификатор НЕДОСТУПЕН

Если рекламный идентификатор Android НЕДОСТУПЕН , необходимо отправить market_referrer_gclid вместе с соответствующим событием first_open и ВСЕМИ последующими сеансами и событиями приложения (например, session_start , add_to_cart , in_app_purchase и т. д.), а также дополнительное поле/значение gclid_only_request=1 . Примечание: значение rdid должно быть равно нулю (поскольку пользователь не дал согласия).

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

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

Пример: события сеанса и приложения

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
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

Поддерживаемый сценарий: взаимодействие с приложением (пользователь уже установил приложение)

Если сеанс приложения инициирован глубокой ссылкой, проанализируйте значения gclid и gbraid из ссылающегося URL и сохраните их либо на устройстве, либо на сервере, используя идентификатор 1st-party. Каждое значение должно храниться в течение 180 дней или до замены другим, более новым значением. Значение gclid для глубокой ссылки должно передаваться через поле запроса конверсии gclid , а значение gbraid для глубокой ссылки — через поле запроса конверсии gbraid .

Рекламный идентификатор доступен

Если доступен рекламный идентификатор Android , gclid и gbraid должны быть отправлены вместе с соответствующим событием session_start и ВСЕМИ последующими сеансами и событиями приложения (например, session_start , add_to_cart , in_app_purchase и т. д.).

Пример: сеанс Deeplink

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=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Пример: События приложения

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=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Пример: Последующий/Органический сеанс

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=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Рекламный идентификатор НЕДОСТУПЕН

Если рекламный идентификатор Android НЕДОСТУПЕН , необходимо отправить gclid вместе с соответствующим событием session_start и ВСЕМИ последующими сеансами и событиями приложения (например, session_start , add_to_cart , in_app_purchase и т. д.). Примечание: значение rdid должно быть равно нулю (поскольку пользователь отказался от персонализации рекламы).

Пример: сеанс Deeplink

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Пример: События приложения

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
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Пример: Последующий/Органический сеанс

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Поддерживаемый сценарий: установка + взаимодействие

Если установка приложения инициирована глубокой ссылкой на магазин Google Play, а затем сеансом приложения, инициированным глубокой ссылкой на приложение, необходимо проанализировать значение gclid из поля install_referrer API реферера установки Play , а также значения gclid и gbraid из ссылающегося URL и сохранить их либо на устройстве, либо на сервере, закодированные с помощью идентификатора 1st-party. Каждое значение должно храниться в течение 180 дней или до замены другим, более новым значением. Значение gclid реферера установки должно передаваться через поле запроса конверсии market_referrer_gclid , значение gclid для deeplink — через поле запроса конверсии gclid , а значение gbraid для deeplink — через поле запроса конверсии gbraid .

Рекламный идентификатор доступен

При наличии рекламного идентификатора Android , как market_referrer_gclid , так и gclid должны быть отправлены вместе с соответствующим событием session_start и событиями приложения (например, add_to_cart , in_app_purchase и т. д.). Для последующих событий session_start передайте market_referrer_gclid , но gclid (deeplink) НЕ следует передавать.

Пример: сеанс Deeplink

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=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Пример: События приложения

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=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Пример: Последующий/Органический сеанс

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=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       <&gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Рекламный идентификатор НЕДОСТУПЕН

Если рекламный идентификатор Android НЕДОСТУПЕН , необходимо отправлять как market_referrer_gclid , так и gclid вместе с соответствующим событием session_start , а также ВСЕМИ последующими событиями сеанса и приложения (например, session_start , add_to_cart , in_app_purchase и т. д.). Примечание: значение rdid должно быть равно нулю (поскольку пользователь отказался от персонализации рекламы).

Пример: сеанс Deeplink

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Пример: События приложения

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
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Пример: Последующий/Органический сеанс

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Важно: значения gclid API Play Install Referrer (передаются как market_referrer_gclid ) и deeplink gclid (передаются как gclid ) — это два отдельных источника значений gclid , которые не должны использоваться взаимозаменяемо. Напоминаем, что эти значения gclid следует хранить в течение 180 дней или до тех пор, пока другой, более новый deeplink gclid не заменит существующий deeplink gclid или пока Play Install Referrer API gclid не заменит существующий Play Install Referrer API gclid . И наоборот, самое последнее значение gbraid всегда следует передавать как gbraid , независимо от того, получено ли оно с помощью API Play Install Referrer или URL-адреса deeplink.

Приложения для iOS

Объем

Вовлечение в приложения через поиск Google Ads, покупки и iOS ACi + Deeplinks

Фон

Пользователей iOS 14.5+, не согласившихся на отслеживание приложений, невозможно отслеживать с помощью IDFA (согласно политике Apple ATT ). Вместо этого Google использует gbraid — агрегированный параметр URL клика. Кроме того, Google может использовать gbraid в других сценариях, где согласие пользователя не предоставлено.

Руководство

Потребители API отслеживания конверсий и ремаркетинга приложений должны убедиться, что все параметры клика передаются правильно, включая gclid и gbraid .

Поддерживаемые сценарии

Поддерживаемый сценарий: взаимодействие с приложением (пользователь уже установил приложение)

Если сеанс приложения инициирован глубокой ссылкой, проанализируйте значения gclid и gbraid из ссылающегося URL и сохраните их либо на устройстве, либо на сервере, используя идентификатор 1st-party. Каждое значение должно храниться в течение 180 дней или до замены другим, более новым значением. Значение gclid должно передаваться через поле запроса конверсии gclid , а значение gbraid — через поле запроса конверсии gbraid .

IDFA доступен

При наличии IDFA необходимо отправлять как gclid, так gclid gbraid с соответствующим событием session_start, а также дополнительное поле/значение app_open_source=ad_click . gclid и gbraid также необходимо отправлять с последующими сеансами и событиями приложения (например, session_start , add_to_cart , in_app_purchase и т. д.). Для последующих последующих сеансов необходимо добавить дополнительное поле/значение app_open_source=organic .

Пример: сеанс Deeplink

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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=ad_click

Пример: событие приложения

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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Пример: Последующий/Органический сеанс

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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic

IDFA НЕДОСТУПЕН

Если IDFA НЕДОСТУПЕН , необходимо отправить gbraid вместе с соответствующим событием session_start вместе с дополнительным полем/значением app_open_source=ad_click и ВСЕМИ нижестоящими событиями приложения (например, add_to_cart , in_app_purchase и т. д.). Примечание : поле gclid следует опустить, а значение rdid должно быть нулевым (поскольку пользователь не дал согласия). gbraid ТАКЖЕ необходимо отправлять с нижестоящими сеансами и соответствующими событиями приложения (например, session_start , add_to_cart , in_app_purchase и т. д.). Для последующих нижестоящих сеансов необходимо добавить дополнительное поле/значение app_open_source=organic .

Пример: сеанс Deeplink

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=ad_click

Пример: событие приложения

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=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Пример: Последующий/Органический сеанс

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic

Примечание: gbraid нельзя использовать в сценариях установки, поскольку пользователи сначала перенаправляются в iTunes.