Cette page a été traduite par l'API Cloud Translation.

Application respectant la confidentialité

Synthèse

Les utilisateurs de l'API qui utilisent le suivi des conversions d'applications et l'API de remarketing Google Ads pour transmettre directement des conversions d'application doivent suivre les consignes Android et iOS suivantes. Ainsi, les clics des utilisateurs qui désactivent le suivi des annonces ou la personnalisation des annonces seront uniquement attribués via des processus conformes à la confidentialité. Pour en savoir plus sur les définitions et les valeurs attendues des paramètres, veuillez consulter la section Présentation des spécifications de réponse et des requêtes.

Applications Android

Portée

Engagement avec l'installation d'une application et toutes les campagnes Google Ads

Contexte

Actuellement, les utilisateurs Android ayant désactivé la personnalisation des annonces ne peuvent pas être suivis à l'aide de l'identifiant publicitaire Android (conformément au règlement Google). Google utilise à la place gclid, un paramètre d'URL de suivi des clics qui n'est pas conservé avec l'appareil.

Conseils

Les utilisateurs de l'API App Tracking et de remarketing doivent s'assurer que gclid est correctement stocké et transmis.

Scénarios compatibles

Scénario compatible: installation (l'utilisateur n'a jamais installé l'application)

Lorsqu'une installation d'application est pilotée par un lien profond redirigeant vers le Google Play Store et que l'utilisateur ouvre l'application pour la première fois, analysez la valeur gclid du champ install_referrer de l'API Play Install Referrer, puis stockez-la sur l'appareil ou sur le serveur à l'aide d'un identifiant propriétaire. Ce gclid doit être stocké pendant 180 jours, ou jusqu'à ce qu'un autre site référent plus récent (Play Installer) gclid le remplace.Ce gclid peut être transmis via le champ de requête de conversion market_referrer_gclid.

Identifiant publicitaire disponible

Lorsque l'identifiant publicitaire Android est disponible, market_referrer_gclid doit être envoyé avec l'événement first_open correspondant. Le market_referrer_gclid peut être envoyé avec des sessions en aval et des événements d'application (par exemple, session_start, add_to_cart, in_app_purchase, etc.).

Exemple: Première ouverture

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

Exemple: Événements de session et d'application

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

L'identifiant publicitaire n'est PAS disponible

Lorsque l'identifiant publicitaire Android n'est PAS disponible, le market_referrer_gclid est obligatoire pour être envoyé avec l'événement first_open correspondant, TOUS les sessions en aval et les événements d'application (session_start, add_to_cart, in_app_purchase, etc.), ainsi que le champ/valeur supplémentaire gclid_only_request=1. Remarque: La valeur rdid doit être égale à zéros (puisque l'utilisateur n'a pas donné son consentement).

Exemple: Première ouverture

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

Exemple : &Événements d'application

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

Scénario compatible: engagement avec une application (l'utilisateur a déjà installé l'application)

Lorsqu'une session d'application est pilotée par un lien profond, analysez la valeur gclid et stockez-la sur l'appareil ou sur le serveur à l'aide d'un identifiant propriétaire.
Le gclid doit être stocké pendant 180 jours ou jusqu'à ce qu'un autre gclid plus récent le remplace. Cette valeur peut ensuite être transmise via le champ de requête de conversion gclid.

Identifiant publicitaire disponible

Lorsque l'identifiant publicitaire Android est disponible, gclid doit être envoyé avec l'événement session_start correspondant. L'élément gclid peut être envoyé avec des événements d'application (par exemple, add_to_cart, in_app_purchase, etc.). Le gclid ne doit PAS être transmis avec les événements session_start en aval.

Exemple: Session sur lien profond

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

Exemple: Événements d'application

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

Exemple: session suivante/naturelle

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

L'identifiant publicitaire n'est PAS disponible

Lorsque l'identifiant publicitaire Android n'est PAS disponible, le gclid est obligatoire pour être envoyé avec l'événement session_start correspondant, ainsi que TOUTES les sessions et tous les événements d'application en aval (session_start, add_to_cart, in_app_purchase, etc.). Remarque: La valeur rdid doit être de zéros (puisque l'utilisateur a désactivé la personnalisation des annonces).

Exemple: Session sur lien profond

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

Exemple: Événements d'application

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

Exemple: session suivante/naturelle

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

Scénario compatible: installation + engagement

Lorsqu'une installation d'application est générée par un lien profond vers le Google Play Store, suivie d'une session d'application générée par un lien profond vers l'application, analysez les valeurs gclid de l'API Play Install Referrer et celles du lien profond gclid, puis stockez-les sur l'appareil ou sur le serveur à l'aide d'un identifiant propriétaire. Ces valeurs gclid doivent être stockées pendant 180 jours, ou jusqu'à ce qu'un autre lien profond gclid plus récent remplace l'hyperlien gclid existant ou que l'API Play Install Referre gclid remplace l'API Play Install Referre gclid existante. L'API Play Install Referrer gclid doit être transmise via market_referrer_gclid field, ET le lien profond gclid doit être transmis via le champ gclid.

Identifiant publicitaire disponible

Lorsque l'identifiant publicitaire Android est disponible, market_referrer_gclid ET gclid doivent tous deux être envoyés avec l'événement session_start et les événements d'application correspondants (par exemple, add_to_cart, in_app_purchase, etc.). Pour les événements session_start en aval, transmettez le market_referrer_gclid, mais le (lien profond) gclid ne doit PAS être transmis.

Exemple: Session sur lien profond

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

Exemple: Événements d'application

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

Exemple: session suivante/naturelle

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

L'identifiant publicitaire n'est PAS disponible

Lorsque l'identifiant publicitaire Android n'est PAS disponible, les objets market_referrer_gclid ET gclid doivent tous deux être envoyés avec l'événement session_start correspondant, ainsi que TOUS les événements de session et d'application en aval (session_start, add_to_cart, in_app_purchase, etc.). Remarque : La valeur rdid doit être égale à zéro (car l'utilisateur a désactivé la personnalisation des annonces).

Exemple: Session sur lien profond

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

Exemple: Événements d'application

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

Exemple: session suivante/naturelle

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

Important:L'API Play Install Referrer gclid (transmise en tant que market_referrer_gclid) et le lien profond gclid (transmis en tant que gclid) sont deux sources distinctes pour gclid et ne doivent pas être utilisées de manière interchangeable. Pour rappel, ces valeurs gclid doivent être stockées pendant 180 jours, ou jusqu'à ce qu'un autre lien profond gclid plus récent remplace le lien profond gclid existant, ou jusqu'à ce qu'une API de référence Play Install Referre gclid remplace l'API Play Install Referre gclid existante.

Applications pour iOS

Portée

Engagement avec une application via la recherche Google Ads, Shopping et les campagnes pour applications axées sur les installations iOS

Contexte

Les utilisateurs d'iOS 14.5 ou version ultérieure qui n'ont pas activé le suivi des applications ne peuvent pas être suivis à l'aide de l'IDFA (conformément au règlement ATT d'Apple). Google utilise à la place gbraid, un paramètre d'URL d'agrégation des clics.

Conseils

Les utilisateurs de l'API de suivi des conversions d'application et de remarketing doivent s'assurer que tous les paramètres de clic sont correctement transmis, y compris gclid et gbraid.

Scénarios compatibles

Scénario compatible: engagement avec une application (l'utilisateur a déjà installé l'application)

Lorsqu'une session d'application est pilotée par un lien profond, analysez les valeurs gclid et gbraid, puis stockez-les sur l'appareil ou sur le serveur à l'aide d'un identifiant propriétaire. Ces valeurs doivent être stockées pendant 180 jours ou jusqu'à ce qu'elles soient remplacées par une valeur plus récente. La valeur gclid peut ensuite être transmise via le champ gclid, puis la valeur gbraid via le champ gbraid.

IDFA disponible

Lorsque l'IDFA est disponible, les champs gclid ET gbraid doivent être envoyés avec l'événement session_start correspondant, ainsi que le champ/valeur supplémentaire app_open_source=ad_click. Les gclid et gbraid peuvent être envoyés avec des sessions en aval et des événements d'application (par exemple, session_start, add_to_cart, in_app_purchase, etc.). Pour les sessions en aval ultérieures, incluez un champ/valeur supplémentaire, app_open_source=organic.

Exemple: Session sur lien profond

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

Exemple: Événement dans l'application

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

Exemple: session suivante/naturelle

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

L'IDFA n'est PAS disponible

Lorsque IDFA n'est PAS disponible, le gbraid doit être envoyé avec l'événement session_start correspondant en plus du champ/valeur supplémentaire app_open_source=ad_click. et TOUS les événements d'application en aval (par exemple, add_to_cart, in_app_purchase, etc.). Remarque: Le champ gclid doit être omis et la valeur rdid doit être égale à zéro (car l'utilisateur n'a pas donné son consentement). Le gbraid est AUSSI requis pour être envoyé avec les sessions en aval et les événements d'application correspondants (par exemple, session_start, add_to_cart, in_app_purchase, etc.). Pour les sessions en aval ultérieures, incluez un champ/valeur supplémentaire, app_open_source=organic.

Exemple: Session sur lien profond

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

Exemple: Événement dans l'application

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

Exemple: session suivante/naturelle

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

Remarque : gbraid ne peut pas être utilisé dans les scénarios d'installation, car les utilisateurs sont d'abord redirigés vers iTunes.