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

Атрибуция приложений, совместимых с конфиденциальностью

Резюме

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

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

Сфера

Установка приложения и взаимодействие с приложением во всех кампаниях Google Ads

Фон

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

Руководство

Пользователи App Conversion Tracking and Remarketing API должны убедиться, что gclid правильно хранится и передается.

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

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

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

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

При наличии рекламного идентификатора Android необходимо отправить market_referrer_gclid с соответствующим событием first_open. market_referrer_gclid может быть отправлен с последующими сеансами и событиями приложения (например, 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
       &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
       &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
       &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
       &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 и сохраните его либо на устройстве, либо на стороне сервера с ключом стороннего идентификатора.
gclid должен храниться в течение 180 дней или до тех пор, пока его не заменит более новый gclid . Затем это значение можно передать через поле запроса на преобразование gclid .

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

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

Пример: сеанс 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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

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

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

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

Когда рекламный идентификатор 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
       &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

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

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
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1

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

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
       &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

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

Когда установка приложения управляется прямой ссылкой на магазин Google Play, за которой следует сеанс приложения, управляемый прямой ссылкой на приложение, анализируйте значения gclid API Play Install Referrer API и gclid gclid и сохраняйте их либо на устройстве, либо на стороне сервера. вводится сторонним идентификатором. Эти значения gclid должны храниться в течение 180 дней или до тех пор, пока другой более новый gclid gclid заменит существующий gclid gclid или gclid Play Install Referrer API не заменит существующий gclid Play Install gclid API. gclid Play Install Referrer API должен быть передан через market_referrer_gclid field , И gclid gclid должен быть передан через поле gclid .

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

Когда Android Advertising ID доступен , как market_referrer_gclid , так и gclid должны быть отправлены с соответствующим событием session_start и событиями приложения (например, add_to_cart , in_app_purchase и т. д.). Для нисходящих событий session_start передайте market_referrer_gclid , но gclid (глубокой ссылки) gclid НЕЛЬЗЯ .

Пример: сеанс 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
       &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

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

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
       &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

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

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
       &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

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

Когда рекламный идентификатор 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
       &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

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

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
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &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=session_start
       &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
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

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

iOS-приложения

Сфера

Взаимодействие с приложением через Google Ads Search, Shopping и iOS ACi + Deeplinks

Фон

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

Руководство

Пользователи App Conversion Tracking and Remarketing API должны убедиться, что все параметры кликов переданы правильно, включая gclid и gbraid .

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

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

Когда сеанс приложения управляется диплинком, проанализируйте значения gclid и gbraid и сохраните их либо на устройстве, либо на стороне сервера с ключом стороннего идентификатора. Эти значения следует хранить в течение 180 дней или до тех пор, пока они не будут заменены более свежим значением. Затем значение gclid можно передать через поле запроса на преобразование gclid , а значение gbraid — через поле запроса на преобразование gbraid .

IDFA доступен

Когда IDFA доступен , необходимо отправить gclid gbraid , так и 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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u

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

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

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

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

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