Application respectant la confidentialité

Résumé

Les consommateurs d'API qui utilisent l'API de remarketing et de suivi des conversions d'applications Google Ads pour transmettre directement les conversions d'applications doivent suivre les instructions pour Android et iOS. Vous vous assurerez ainsi que les clics des utilisateurs qui désactivent le suivi des annonces ou la personnalisation des annonces ne sont attribués qu'à l'aide de workflows respectueux de la confidentialité. Pour en savoir plus sur les définitions des paramètres et les valeurs attendues, veuillez consulter la présentation des spécifications des requêtes et des réponses.

Applications Android

Champ d'application

Installation et engagement avec une application via toutes les campagnes Google Ads

Arrière-plan

Actuellement, les utilisateurs Android qui ont désactivé la personnalisation des annonces ne peuvent pas être suivis à l'aide de l'identifiant publicitaire Android (conformément au règlement de Google). Google utilise plutôt gclid, un paramètre d'URL de suivi des clics qui ne persiste pas sur l'appareil. De plus, Google peut utiliser le gbraid, un paramètre d'URL de clic agrégé, dans d'autres scénarios où le consentement au niveau de l'utilisateur n'a pas été accordé.

Conseils

Les consommateurs de l'API de suivi des conversions et de remarketing pour les applications doivent s'assurer que gclid et gbraid sont correctement stockés et transmis.

Scénarios compatibles

Scénario pris en charge : installation (l'utilisateur n'a jamais installé l'application)

Lorsqu'une installation d'application est générée par un lien profond qui redirige 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 et stockez-la sur l'appareil ou côté serveur, en l'associant à un identifiant first party. Chaque valeur doit être stockée pendant 180 jours ou jusqu'à ce qu'elle soit remplacée par une valeur plus récente. La valeur gclid doit être transmise via le champ de requête de conversion market_referrer_gclid.

L'identifiant publicitaire est disponible

Lorsque l'identifiant publicitaire Android est disponible, le paramètre market_referrer_gclid doit être envoyé avec l'événement first_open correspondant et TOUTES les sessions et événements d'application en aval (c'est-à-dire 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
       &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
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
       &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
L'identifiant publicitaire N'EST PAS disponible

Lorsque l'identifiant publicitaire Android n'est PAS disponible, le market_referrer_gclid doit obligatoirement être envoyé avec l'événement first_open correspondant, ainsi que TOUTES les sessions et événements d'application en aval (c'est-à-dire session_start, add_to_cart, in_app_purchase, etc.), ainsi que le champ/la valeur supplémentaires gclid_only_request=1. Remarque : La valeur rdid doit être composée de 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
       &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
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=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

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

Lorsqu'une session d'application est générée par un lien profond, analysez les valeurs gclid et gbraid de l'URL de provenance et stockez-les sur l'appareil ou côté serveur, en les associant à un identifiant first party. Chaque valeur doit être stockée pendant 180 jours ou jusqu'à ce qu'elle soit remplacée par une valeur plus récente. La valeur du lien profond gclid doit être transmise via le champ de la demande de conversion gclid, et la valeur du lien profond gbraid doit être transmise via le champ de la demande de conversion gbraid.

L'identifiant publicitaire est disponible

Lorsque l'identifiant publicitaire Android est disponible, les paramètres gclid et gbraid doivent être envoyés avec l'événement session_start correspondant et TOUTES les sessions et événements d'application en aval (c'est-à-dire session_start,add_to_cart, in_app_purchase, etc.).

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
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
       &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
Exemple : Session ultérieure/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
       &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
L'identifiant publicitaire N'EST PAS disponible

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

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
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
       &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
Exemple : Session ultérieure/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
       &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

Scénario pris en charge : installation et 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 à la fois la valeur gclid du champ install_referrer de l'API Play Install Referrer et les valeurs gclid et gbraid de l'URL de provenance, puis stockez-les sur l'appareil ou côté serveur, en les associant à un identifiant propriétaire. Chaque valeur doit être stockée pendant 180 jours ou jusqu'à ce qu'elle soit remplacée par une valeur plus récente. La valeur gclid du référent d'installation doit ensuite être transmise via le champ de la demande de conversion market_referrer_gclid, la valeur gclid du lien profond doit être transmise via le champ de la demande de conversion gclid et la valeur gbraid du lien profond doit être transmise via le champ de la demande de conversion gbraid.

L'identifiant publicitaire est disponible

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

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
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
       &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
Exemple : Session ultérieure/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
       &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
L'identifiant publicitaire N'EST PAS disponible

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

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
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
       &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
Exemple : Session ultérieure/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
       &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

Applications pour iOS

Champ d'application

Engagement dans les applications via le Réseau de Recherche, Shopping et les CAi iOS + liens profonds Google Ads

Arrière-plan

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 plutôt gbraid, un paramètre d'URL de suivi des clics agrégé. De plus, Google peut utiliser le gbraid dans d'autres scénarios où le consentement au niveau de l'utilisateur n'a pas été accordé.

Conseils

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

Scénarios compatibles

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

Lorsqu'une session d'application est générée par un lien profond, analysez les valeurs gclid et gbraid de l'URL de provenance, puis stockez-les sur l'appareil ou côté serveur, en les associant à un identifiant first party. Chaque valeur doit être stockée pendant 180 jours ou jusqu'à ce qu'elle soit remplacée par une valeur plus récente. La valeur gclid doit être transmise via le champ de requête de conversion gclid, et la valeur gbraid doit être transmise via le champ de requête de conversion gbraid.

IDFA est disponible

Lorsque l'IDFA est disponible, les paramètres gclid ET gbraid doivent être envoyés avec l'événement session_start correspondant, ainsi que le champ/la valeur supplémentaires app_open_source=ad_click. Les gclid et gbraid doivent également être envoyés avec les sessions en aval et les événements d'application (c'est-à-dire session_start, add_to_cart, in_app_purchase, etc.). Pour les sessions en aval suivantes, incluez le champ/la valeur supplémentaire app_open_source=organic.

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
Exemple : Événement 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=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
Exemple : Session ultérieure/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
       &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
L'IDFA N'EST PAS disponible

Lorsque l'IDFA n'est PAS disponible, le gbraid doit être envoyé avec l'événement session_start correspondant, ainsi que le champ/la valeur supplémentaire app_open_source=ad_click. et TOUS les événements d'application en aval (c'est-à-dire add_to_cart, in_app_purchase, etc.). Remarque : Le champ gclid doit être omis et la valeur rdid doit être composée de zéros (puisque l'utilisateur n'a pas donné son consentement). Le gbraid est ÉGALEMENT requis pour être envoyé avec les sessions en aval et les événements d'application correspondants (c'est-à-dire session_start, add_to_cart, in_app_purchase, etc.). Pour les sessions en aval suivantes, incluez le champ/la valeur supplémentaire app_open_source=organic.

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
Exemple : Événement 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=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
Exemple : Session ultérieure/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
       &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