La mise en correspondance des cookies est une fonctionnalité qui vous permet d'associer un cookie (par exemple, l'identifiant d'un utilisateur ayant consulté votre site Web) à un ID utilisateur Google spécifique à l'enchérisseur correspondant, puis de créer des listes d'utilisateurs qui vous aident à prendre des décisions d'enchères plus efficaces. Ce guide décrit les concepts utilisés dans la mise en correspondance des cookies, ainsi que les différents workflows de mise en correspondance des cookies et leurs variantes pour certains cas d'utilisation.
Concepts
Qu'est-ce que la mise en correspondance des cookies ?
Les propriétaires de domaine définissent généralement le contenu des cookies pour les utilisateurs qui consultent leur site. Ces cookies permettent d'identifier les utilisateurs de ce domaine. Même si deux propriétaires de domaine acceptent d'échanger ces données, le modèle de sécurité des navigateurs Internet l'empêche de lire un cookie défini par un autre domaine.
Dans le contexte de la publicité numérique, Google identifie les utilisateurs dont les cookies appartiennent au domaine doubleclick.net
. Les enchérisseurs participant aux enchères en temps réel peuvent disposer de leur propre domaine, dans lequel ils identifient un ensemble d'utilisateurs auprès desquels ils souhaitent diffuser des annonces. La mise en correspondance des cookies permet à l'enchérisseur de faire correspondre ses cookies à ceux de Google. Il peut ainsi déterminer si une impression envoyée dans une demande d'enchère est associée à l'un des utilisateurs ciblés, et recevoir soit ses propres données de cookie, soit un ID utilisateur Google spécifique à l'enchérisseur qui est une forme chiffrée du cookie doubleclick.net
dans la demande d'enchère.
Le service de mise en correspondance des cookies décrit dans ce guide facilite la création et la maintenance de l'association entre le cookie d'un enchérisseur et l'ID utilisateur Google. Il permet également de renseigner des listes d'utilisateurs.
Tableaux de correspondance
Une table des correspondances permet de mapper un ID ou d'autres données d'un domaine à un autre. Les enchérisseurs peuvent utiliser le service de lecture des cookies pour renseigner leurs propres tableaux de correspondance en mappant leur cookie d'un utilisateur donné avec l'ID utilisateur Google de l'utilisateur ou pour renseigner une table des correspondances hébergée par Google. Les tableaux de correspondance sont nécessaires pour que l'application d'enchères d'un enchérisseur puisse accéder aux données des cookies de l'utilisateur qui voit l'impression.
Tableaux de correspondance hébergés par Google
Pour faciliter la maintenance, l'amélioration de la latence et l'accès aux données de correspondance pour les utilisateurs de certaines régions, nous vous recommandons d'autoriser Google à héberger votre table des correspondances. Cela vous permet de spécifier une chaîne encodée en base64 adaptée au Web, appelée ci-après "données de correspondance hébergées", qui sera mappée à l'ID utilisateur Google d'un utilisateur donné. Une fois qu'une correspondance a été établie, elle peut être utilisée des manières suivantes:
Enchères en temps réel: dans les demandes d'enchères ultérieures pour les impressions associées à l'utilisateur, Google vous enverra les données de correspondance hébergées que vous avez mises en correspondance avec son ID utilisateur Google. Si votre point de terminaison d'enchères est configuré pour utiliser le protocole RTB de Google, vous recevrez ces données sous forme d'octets décodés via le champ
BidRequest.hosted_match_data
. Dans l'implémentation OpenRTB de Google,BidRequest.user.buyeruid
renvoie ces données sous la forme d'une chaîne en base64 adaptée au Web.Listes d'utilisateurs: les listes d'utilisateurs peuvent être renseignées avec des ID utilisateur Google ou des données de correspondance hébergées.
- Préciblage : vous pouvez configurer votre préciblage de manière à ne recevoir que les demandes d'enchères contenant des données de correspondance hébergées. Cela permet d'éliminer les impressions moins pertinentes pour les utilisateurs qui ne se trouvent pas dans votre espace de cookie.
Listes d'utilisateurs
Vous pouvez créer et gérer des listes d'utilisateurs avec l'API Real-Time Bidding. Une fois les listes créées, vous pouvez les renseigner à l'aide des workflows de mise en correspondance des cookies décrits ci-dessous ou via le service d'importation groupée.
Getting Started
Pour commencer à utiliser la mise en correspondance des cookies, vous devez contacter votre responsable de compte technique, qui peut activer des workflows spécifiques et vous aider à configurer les éléments suivants:
- ID du réseau de mise en correspondance des cookies (NID): ID de chaîne identifiant de manière unique un compte d'enchérisseur pour la mise en correspondance des cookies et d'autres opérations associées.
- URL de mise en correspondance des cookies: URL de base d'un point de terminaison qui accepte et gère les requêtes entrantes dans le cadre des workflows de mise en correspondance des cookies. Les enchérisseurs peuvent intégrer des macros à cette URL pour contrôler l'ordre des paramètres qui lui sont transmis dans les workflows de mise en correspondance des cookies.
- Balise de correspondance: balise que vous devez placer dans le navigateur d'un utilisateur pour le workflow de mise en correspondance des cookies initié par l'enchérisseur. Celle-ci peut être diffusée avec des annonces ou sur des propriétés Web en dehors des annonces.
- URL du rapport de lecture des cookies (facultatif): dans le workflow unidirectionnel de mise en correspondance des cookies, il s'agit d'une URL facultative qui peut être fournie pour spécifier un point de terminaison qui recevra les détails de l'erreur en cas d'échec de la mise en correspondance des cookies via une redirection HTTP 302. Par défaut, les réponses ne sont envoyées à cette URL qu'en cas d'erreur lors de la mise en correspondance des cookies. Toutefois, l'enchérisseur peut demander que la redirection soit toujours envoyée.
- URL de l'assistant de mise en correspondance des cookies: pour les places de marché qui implémentent le workflow de mise en correspondance des cookies, il s'agit de l'URL de base du point de terminaison destinée à répondre aux requêtes entrantes.
- Quota de l'assistance pour la mise en correspondance des cookies: pour les places de marché qui implémentent le workflow de mise en correspondance des cookies, il s'agit du nombre maximal de demandes que leur URL de mise en correspondance des cookies peut recevoir chaque seconde. Cela permet d'éviter que les requêtes CMA ne surchargent les serveurs de la place de marché avec des requêtes.
Macros de mise en correspondance des cookies
Dans tous les workflows de mise en correspondance des cookies compatibles, l'URL de mise en correspondance des cookies d'un enchérisseur comporte généralement des paramètres ajoutés dans un ordre non garanti. Les enchérisseurs avec des intégrations nécessitant un ordre cohérent des paramètres peuvent placer des macros dans leur URL de mise en correspondance des cookies pour en garantir l'emplacement.
Macros prises en charge
Les enchérisseurs peuvent éventuellement configurer leur URL de mise en correspondance des cookies pour inclure une ou plusieurs macros sous la forme %%GOOGLE_<PARAM_NAME>%%
ou %%GOOGLE_<PARAM_NAME>_PAIR%%
. Les macros acceptées et leurs valeurs étendues sont les suivantes:
Macro | Valeur développée |
---|---|
GOOGLE_GID | GOOGLE_USER_ID |
GOOGLE_GID_PAIR | &google_gid=GOOGLE_USER_ID |
GOOGLE_CVER | COOKIE_VERSION_NUMBER |
GOOGLE_CVER_PAIR | &cver=COOKIE_VERSION_NUMBER |
GOOGLE_ERROR | ERROR_ID |
GOOGLE_ERROR_PAIR | &google_error=ERROR_ID |
GOOGLE_PUSH | PIXEL_MATCH_DATA |
GOOGLE_PUSH_PAIR | &google_push=PIXEL_MATCH_DATA |
GOOGLE_ALL_PARAMS | google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&google_error=ERROR_ID |
Exemple de macro
Un enchérisseur intègre une mise en correspondance des cookies avec un point de terminaison hébergé sur https://user.bidder.com.cookies
. Son implémentation nécessite des paramètres prédéfinis définis par l'enchérisseur en plus des paramètres de mise en correspondance des pixels, dans l'ordre suivant: google_push
, google_gid
, google_cver
et google_error
. Pour ce faire, l'enchérisseur peut définir son URL de mise en correspondance des cookies sur:
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
Lorsque Google enverra ultérieurement une demande de mise en correspondance à cet enchérisseur, celle-ci sera étendue de la manière suivante:
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
Workflows du service de lecture des cookies
Le service de lecture des cookies de Google accepte actuellement trois workflows pour différents cas d'utilisation décrits ci-dessous.
Initiée par l'enchérisseur: mise en correspondance bidirectionnelle des cookies
La mise en correspondance des cookies bidirectionnelle fait référence à un flux de travail initié par l'enchérisseur, au cours duquel il place une balise de correspondance dans le navigateur de l'utilisateur qui la redirige vers Google. Ce workflow permet à Google et à l'enchérisseur de renseigner les tableaux de correspondance. Vous trouverez ci-dessous un exemple simple de ce workflow.
Étape 1: Placez la balise de correspondance
Pour lancer ce flux, l'enchérisseur doit placer sa balise de correspondance de sorte qu'elle s'affiche dans le navigateur de l'utilisateur. Une balise de correspondance simple qui ne renvoie que l'ID utilisateur Google à l'enchérisseur peut être structurée comme suit:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
Vous pouvez inclure des paramètres supplémentaires dans la balise de correspondance pour répondre à différents cas d'utilisation. Pour en savoir plus sur ces paramètres, consultez Utiliser les paramètres d'URL de la balise de correspondance.
Étape 2: Google fournit une redirection incluant les données de correspondance
En effet, le service de lecture des cookies de Google reçoit une demande du navigateur de l'utilisateur, qui envoie une redirection HTTP 302
vers l'URL de mise en correspondance des cookies de l'enchérisseur. La redirection inclura des paramètres de requête spécifiant l'ID utilisateur Google et son numéro de version dans l'URL. L'enchérisseur recevra également son cookie inclus dans les en-têtes de requête. En pratique, pour une URL de mise en correspondance des cookies spécifiée en tant que https://ad.network.com/pixel
, l'URL de redirection de la balise de correspondance simple, telle qu'illustrée ci-dessus, peut se présenter comme suit:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
L'ID utilisateur Google transmis via le paramètre google_gid
est une chaîne encodée en base64 adaptée au Web sans remplissage. Il est recommandé aux enchérisseurs qui choisissent d'héberger une table des correspondances de stocker la chaîne exacte renvoyée par le service de lecture des cookies. Dans les demandes d'enchères ultérieures, il correspondra aux valeurs spécifiées via BidRequest.google_user_id
dans le protocole RTB de Google ou BidRequest.user.id
dans l'implémentation OpenRTB de Google.
La version spécifiée dans google_cver
indique le numéro de version numérique de l'ID utilisateur Google. L'ID utilisateur Google d'un utilisateur donné change rarement, puis est incrémenté.
Si Google rencontre une erreur lors du traitement de votre demande de mise en correspondance, un paramètre google_error
sera spécifié à la place.
Étape 3: L'enchérisseur traite la redirection et répond avec un pixel
L'enchérisseur reçoit une redirection vers son URL de mise en correspondance des cookies, y compris les paramètres qu'il a spécifiés à la première étape et ceux fournis par Google à la deuxième étape. De plus, ils recevront également leur cookie dans les en-têtes HTTP. Si l'opération réussit, un enchérisseur hébergeant sa propre table des correspondances peut faire correspondre son cookie à l'ID utilisateur Google inclus dans la réponse. Il est recommandé aux enchérisseurs de stocker la chaîne exacte renvoyée par le service de lecture des cookies.
Si l'opération a échoué, l'enchérisseur reçoit un paramètre google_error
dans la redirection. Il s'agit d'une valeur numérique correspondant à différents états d'erreur qui identifient l'erreur particulière qui s'est produite. Pour en savoir plus sur les valeurs d'erreur possibles, cliquez ici.
Si vous recevez un message d'erreur, vous pouvez tenter d'établir une correspondance avec cet utilisateur en plaçant une nouvelle balise de correspondance.
L'enchérisseur doit toujours répondre en diffusant une image de pixel invisible 1 x 1 ou renvoyer une réponse HTTP 204
No Content (Aucun contenu).
Schéma du workflow de mise en correspondance des cookies
Ce workflow est illustré par le schéma ci-dessous, dans lequel les requêtes et les réponses sont représentées par une flèche, et les éléments de données qui les accompagnent sont indiqués entre parenthèses.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=5&hl=fr)
Paramètres d'URL de la balise de correspondance
Paramètres | Description |
---|---|
google_nid |
ID de réseau du compte de l'enchérisseur. Cet ID peut être récupéré via la ressource Enchérisseurs. |
google_cm |
Indique au service de lecture des cookies de Google qu'il doit mettre en correspondance les cookies. La valeur du paramètre est ignorée et peut être omise. |
google_sc |
Ce paramètre est obsolète. Définit le cookie Google pour l'utilisateur s'il est absent. La valeur du paramètre est ignorée et peut être omise. L'omission de ce paramètre génère une erreur si aucun cookie n'existe. |
google_no_sc |
Ce paramètre est obsolète. Cela indique au service de lecture des cookies de Google qu'il ne doit pas définir de cookie pour l'utilisateur s'il n'en contient pas. La valeur du paramètre est ignorée et peut être omise. |
google_hm |
Données que l'enchérisseur souhaite stocker dans une table des correspondances hébergée par Google.
Cette valeur est une chaîne au format base64 adaptée au Web (avec marge intérieure facultative). La taille des données brutes ne doit pas dépasser 40 octets. Par exemple, |
google_redir |
Chaîne encodée au format URL qu'un enchérisseur peut spécifier s'il souhaite demander à Google d'envoyer la redirection HTTP 302 vers l'URL encodée pour cette balise de correspondance. Cela permet à Google d'être placé en tête dans un appel enchaîné aux partenaires. Cela entraîne une erreur si spécifiée sans google_hm ou avec google_cm . |
google_ula |
Chaîne utilisée pour ajouter l'utilisateur à une liste existante. Le format attendu de cette valeur est userlistid[,timestamp] :
Ce paramètre d'URL peut être répété pour ajouter l'utilisateur à plusieurs listes. |
gdpr |
Indique que la demande est soumise aux restrictions sur l'utilisation des données du RGPD. Pour en savoir plus, consultez
Exigences relatives au consentement de l'utilisateur dans l'UE ci-dessous ou Impact sur l'éligibilité de la mise en correspondance des cookies dans la
documentation de la version 2.0 du TCF de l'IAB Authorized Buyers.
Exemple : |
gdpr_consent |
Chaîne TC représentant le consentement de l'utilisateur final. Pour en savoir plus, consultez la section Exigences relatives au consentement de l'utilisateur dans l'UE ci-dessous ou la section Comment la chaîne TC sera-t-elle transmise ? dans la documentation de la version 2.0 du TCF d'Authorized Buyers de l'IAB. |
process_consent |
Indique que l'enchérisseur a obtenu le consentement de l'utilisateur final pour les utilisations de données spécifiées dans les
Règles de Google relatives au consentement de l'utilisateur dans l'UE.
Si la demande n'est pas soumise aux règles relatives au consentement de l'utilisateur dans l'UE ou si d'autres paramètres de consentement sont disponibles ( Exemple : |
En plus des paramètres ci-dessus, les enchérisseurs peuvent spécifier les leurs, qui seront ajoutés en tant que paramètres à l'URL de redirection. Notez que les paramètres définis par l'enchérisseur et nommés avec le préfixe google_
seront ignorés, car ils sont réservés par Google pour un développement futur. La conservation de l'ordre des paramètres n'est donc pas garantie. Voici à quoi peut ressembler un tag de correspondance incluant des paramètres définis par l'enchérisseur:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
Paramètres d'URL de redirection
L'URL de redirection est créée à partir de l'URL de lecture des cookies de base configurée pour le compte d'un enchérisseur, incluant google_
et les paramètres définis par l'enchérisseur en fonction de ceux spécifiés dans la balise de correspondance. Les paramètres de réponse google_
suivants sont définis:
Paramètres | Description |
---|---|
google_gid |
ID utilisateur Google. Défini si google_cm est spécifié dans la requête et que celle-ci a abouti. |
google_cver |
Version du cookie Défini si google_cm est spécifié dans la requête et que celle-ci a abouti. |
google_error |
Valeur entière indiquant l'erreur globale de la requête. Une fois reçu, il indique qu'aucune opération n'a été effectuée et qu'aucun autre paramètre de réponse
|
google_hm |
Ne s'affiche qu'en cas d'échec de la tentative d'écriture dans la table des correspondances hébergée par Google. Dans ce cas, sa valeur correspond à l'un des codes d'état suivants:
|
google_ula |
État de l'opération d'ajout à la liste d'utilisateurs, répété si plusieurs Ex. : L'opération
|
Exemples de scénarios de mise en correspondance des cookies
Les scénarios suivants décrivent à quoi peut ressembler la mise en correspondance des cookies pour un utilisateur type navigant sur une page Web.
Scénario 1: L'utilisateur efface ses cookies et consulte un site
Jane vide le cache de tous les cookies. Il accède ensuite à la page d'accueil de ExampleNews.com.
Conséquences :
- ExampleNews.com s'affiche et appelle les annonces de Google (Ad Manager).
- Étant donné que le bloc d'annonces est éligible pour l'allocation dynamique, Google envoie des demandes d'enchères à FinestDSP et à d'autres enchérisseurs via le service d'enchères en temps réel.
- L'application d'enchères de FinestDSP reçoit et traite la demande d'enchère, puis envoie sa réponse.
- Google reçoit les réponses aux enchères des enchérisseurs, y compris la réponse de FinestDSP, qui spécifie une annonce avec une balise de correspondance (pixel).
- FinestDSP remporte l'enchère. Google diffuse l'annonce de FinestDSP et met en correspondance la balise avec Jane.
- La balise de correspondance appelle le service de lecture des cookies de Google, en spécifiant les paramètres
google_nid
etgoogle_cm
. - Celui-ci lit le cookie Google de Jane et envoie au navigateur de Jane une redirection vers l'URL de mise en correspondance des cookies de FinestDSP avec les paramètres
google_user_id
etgoogle_cver
définis. - Le navigateur de Jeanne charge la redirection vers l'URL de mise en correspondance des cookies de FinestDSP.
- Le point de terminaison de mise en correspondance des cookies de FinestDSP traite la requête de redirection, qui inclut les paramètres d'URL définis par Google, ainsi que le cookie associé à Jane dans les en-têtes HTTP. FinestDSP peut désormais stocker le mappage de son cookie avec le
google_user_id
dans sa table des correspondances. - FinestDSP répond à la redirection avec un pixel 1x1 invisible.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=5&hl=fr)
Scénario 2: Utilisateur avec un mappage existant
Une semaine après le scénario 1, Jeanne accède de nouveau au site ExampleNews.com. Maintenant que Jane dispose à la fois de cookies d'enchérisseur et d'Ad Manager sur sa machine, voici comment fonctionne la mise en correspondance.
- La page Web s'affiche, puis Google (Ad Manager) demande des annonces à afficher sur la page.
- Lors des enchères publicitaires, Google envoie une demande d'enchère aux enchérisseurs applicables, y compris FinestDSP.
- FinestDSP reçoit la demande d'enchère, y compris des signaux tels que
google_user_id
. - FinestDSP recherche le
google_user_id
dans sa table des correspondances et trouve le cookie associé à Jane, créé une semaine plus tôt (dans le scénario 1). - Sur la base des informations associées au cookie, la logique d'enchères de FinestDSP place une enchère sur l'impression et remporte l'enchère.
- Jeanne peut ainsi voir une annonce adaptée à ses centres d'intérêt, en fonction des informations détenues par FinestDSP.
Initiée par l'enchérisseur: mise en correspondance des cookies unidirectionnelle
La mise en correspondance des cookies unidirectionnelle est semblable au workflow bidirectionnel, sauf qu'elle est modifiée de sorte que seul Google héberge et insère une table des correspondances. Cela peut être utilisé dans les cas où l'enchérisseur n'est pas autorisé à héberger des ID utilisateur Google dans sa propre table des correspondances. Pour utiliser ce flux, les enchérisseurs doivent autoriser Google à héberger la table des correspondances, ne peuvent plus spécifier google_cm
dans les demandes adressées au service de lecture des cookies de Google et ne recevront donc pas google_gid
pour renseigner leur propre table de correspondance. Une fois que Google a établi une correspondance pour un utilisateur, les enchérisseurs peuvent l'ajouter aux listes d'utilisateurs en utilisant leurs propres données de cookie. De même, les demandes d'enchères ciblant ces utilisateurs excluent l'ID utilisateur Google, mais incluent les données de correspondance hébergées. Un exemple simple du workflow révisé est résumé dans les étapes ci-dessous.
Étape 1: Insérez la balise de correspondance redirigée vers l'URL de mise en correspondance des cookies de l'enchérisseur
Pour lancer ce flux, un enchérisseur doit placer un tag de correspondance de sorte qu'il s'affiche dans le navigateur de l'utilisateur. Contrairement au workflow pour les utilisateurs qui ne se trouvent pas dans un État américain soumis à des restrictions de confidentialité, la balise de correspondance doit rediriger le navigateur de l'utilisateur vers votre URL de mise en correspondance des cookies. Par exemple, avec une URL de mise en correspondance des cookies configurée comme https://ad.network.com/pixel
, elle se présente comme suit:
<img src="https://ad.network.com/pixel" />
Lors du chargement dans le navigateur de l'utilisateur, celui-ci demande un pixel à l'URL de mise en correspondance des cookies de l'enchérisseur. Cette requête contiendra son cookie dans l'en-tête HTTP, qui devra être extrait pour l'étape suivante.
Étape 2: Redirigez les utilisateurs vers le service de lecture des cookies de Google
Le point de terminaison de mise en correspondance des cookies de l'enchérisseur doit rediriger vers le service de mise en correspondance des cookies de Google, y compris le paramètre google_hm
renseigné avec ses données de cookies encodées en base64 compatibles avec le Web. L'URL de redirection peut se présenter comme suit:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
Étape 3: Le navigateur de l'utilisateur est redirigé vers le service de lecture des cookies de Google
Google recevra une redirection contenant les paramètres que vous avez spécifiés, en plus de son cookie dans les en-têtes HTTP.
Étape 4: Google diffuse un pixel en cas de redirection d'erreur ou de réussite, si l'URL du rapport est spécifiée
Si la mise en correspondance des cookies réussit ou si aucune URL de rapport de mise en correspondance des cookies n'a été spécifiée pour le compte de l'enchérisseur, Google diffuse par défaut un pixel transparent de 1 x 1, et le flux de travail se termine ici.
Les impressions enregistrées par cet utilisateur dans les demandes d'enchères suivantes incluront les données de correspondance hébergées par l'enchérisseur dans BidRequest.hosted_match_data
pour le protocole Google ou BidRequest.user.buyeruid
pour l'implémentation OpenRTB de Google. Les enchérisseurs peuvent également renseigner les listes d'utilisateurs à l'aide des données de correspondance hébergées qu'ils ont spécifiées.
Sinon, si une erreur s'est produite, Google envoie une redirection à l'URL du rapport de lecture des cookies de l'enchérisseur, indiquant la cause de l'erreur spécifiée dans le paramètre google_error
. Si l'URL du rapport de lecture des cookies de l'enchérisseur était https://ad.network.com/report
, l'URL de redirection se présenterait comme suit:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
Étape 5: Le navigateur de l'utilisateur redirige vers l'URL du rapport de lecture des cookies de l'enchérisseur
Le navigateur de l'utilisateur redirigera vers l'URL du rapport de lecture des cookies de l'enchérisseur, en incluant le motif de l'erreur (le cas échéant) spécifié par Google dans le paramètre google_error
. Pour en savoir plus sur l'interprétation du code d'erreur, consultez la description des paramètres.
Étape 6: L'enchérisseur diffuse un pixel transparent de 1 x 1
L'enchérisseur doit répondre en diffusant un pixel transparent de 1 x 1 sur le navigateur de l'utilisateur.
Schéma du workflow de mise en correspondance des cookies pour les utilisateurs situés dans les États américains soumis à des restrictions de confidentialité
Le workflow par défaut pour les utilisateurs situés dans les États américains soumis à des restrictions de confidentialité est illustré par le schéma ci-dessous. Les requêtes et les réponses sont représentées par une flèche, et les éléments de données qui les accompagnent sont indiqués entre parenthèses.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=5&hl=fr)
Les paramètres d'URL de l'enchérisseur redirigent vers le service de lecture des cookies de Google
Paramètres | Description |
---|---|
google_nid |
ID de réseau du compte de l'enchérisseur. Cet ID peut être récupéré via la ressource Enchérisseurs. |
google_sc |
Ce paramètre est obsolète. Définit le cookie Google pour l'utilisateur s'il est absent. La valeur du paramètre est ignorée et peut être omise. L'omission de ce paramètre génère une erreur si aucun cookie n'existe. |
google_no_sc |
Ce paramètre est obsolète. Cela indique au service de lecture des cookies de Google qu'il ne doit pas définir de cookie pour l'utilisateur s'il n'en contient pas. La valeur du paramètre est ignorée et peut être omise. |
google_hm |
Contient les données que l'enchérisseur souhaite stocker dans une table des correspondances hébergée par Google. |
google_redir |
URL encodée dont vous souhaitez que Google envoie une redirection HTTP 302. L'URL spécifiée recevra des redirections avec le paramètre google_error pour les erreurs et les opérations réussies. |
google_ula |
Chaîne utilisée pour ajouter l'utilisateur à une liste existante. Le format attendu de cette valeur est userlistid[,timestamp] :
Ce paramètre d'URL peut être répété pour ajouter l'utilisateur à plusieurs listes. |
gdpr |
Indique que la demande est soumise aux restrictions sur l'utilisation des données du RGPD. Pour en savoir plus, consultez
Exigences relatives au consentement de l'utilisateur dans l'UE ci-dessous ou Impact sur l'éligibilité de la mise en correspondance des cookies dans la
documentation de la version 2.0 du TCF de l'IAB Authorized Buyers.
Exemple : |
gdpr_consent |
Chaîne TC représentant le consentement de l'utilisateur final. Pour en savoir plus, consultez la section Exigences relatives au consentement de l'utilisateur dans l'UE ci-dessous ou la section Comment la chaîne TC sera-t-elle transmise ? dans la documentation de la version 2.0 du TCF d'Authorized Buyers de l'IAB. |
process_consent |
Indique que l'enchérisseur a obtenu le consentement de l'utilisateur final pour les utilisations de données spécifiées dans les
Règles de Google relatives au consentement de l'utilisateur dans l'UE.
Si la demande n'est pas soumise aux règles relatives au consentement de l'utilisateur dans l'UE ou si d'autres paramètres de consentement sont disponibles ( Exemple : |
Les paramètres d'URL pour Google redirigent l'utilisateur vers l'URL du rapport sur la mise en correspondance des cookies de l'enchérisseur
Paramètres | Description |
---|---|
google_error |
Valeur entière indiquant l'erreur globale de la requête. Une fois reçu, il indique qu'aucune opération n'a été effectuée et qu'aucun autre paramètre de réponse
|
Initiée par Google: mise en correspondance de pixels bidirectionnelle
La mise en correspondance bidirectionnelle de pixels est un flux de travail du service de lecture des cookies de Google dans lequel Google tente de faire correspondre un ID utilisateur Google à un enchérisseur sélectionné via un algorithme autre que le gagnant des enchères en temps réel. Lorsqu'une annonce est insérée, Google place une balise de correspondance demandant au navigateur de l'utilisateur de charger un pixel transparent à partir de l'URL de mise en correspondance des cookies de l'enchérisseur sélectionné. Cela permettra à Google et à l'enchérisseur de renseigner une table des correspondances avec un utilisateur donné. Vous trouverez ci-dessous un exemple simple de ce workflow.
Étape 1: Google place une balise de correspondance
Lorsque la page d'un éditeur participant se charge dans le navigateur de l'utilisateur et qu'un espace publicitaire de cette page est rempli par Google, une balise de correspondance peut être placée et demander un pixel à un enchérisseur sélectionné via un algorithme. La balise de mise en correspondance des pixels placée par Google associe l'URL de mise en correspondance des cookies de l'enchérisseur à des paramètres supplémentaires que celui-ci peut utiliser pour renseigner sa table des correspondances. Pour une URL de mise en correspondance des cookies spécifiée en tant que https://ad.network.com/pixel
, elle est structurée comme suit:
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
Étape 2: L'enchérisseur doit répondre en renvoyant l'URL du service de lecture des cookies de Google
Les enchérisseurs recevant des demandes de mise en correspondance des pixels doivent répondre par une redirection vers le service de lecture des cookies de Google, comme suit:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
Notez que l'URL de redirection ci-dessus est semblable à celle utilisée dans la balise de correspondance du workflow de mise en correspondance des cookies initié par l'enchérisseur.
Dans la mise en correspondance de pixels, le paramètre google_cm
est remplacé par le paramètre google_push
, et sa valeur doit être égale à celle fournie par Google dans la requête. En outre, comme pour le workflow initié par l'enchérisseur, vous pouvez spécifier des paramètres supplémentaires pour traiter d'autres cas d'utilisation.
Étape 3: Google traite la redirection et répond avec un pixel
Google consigne qu'une correspondance a été créée pour l'utilisateur et gère toutes les opérations supplémentaires demandées via les paramètres de requête. Enfin, Google répond par un pixel transparent de 1 x 1.
Diagramme du workflow de mise en correspondance des pixels
Ce workflow est illustré par le schéma ci-dessous, dans lequel les requêtes et les réponses sont représentées par une flèche, et les éléments de données qui les accompagnent sont indiqués entre parenthèses.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=5&hl=fr)
Paramètres de demande de la balise de correspondance Google
Paramètres | Description |
---|---|
google_gid |
ID utilisateur Google. Pour les utilisateurs qui ne résident pas dans un État américain soumis à des restrictions de confidentialité, il sera toujours spécifié dans la balise de correspondance de Google. |
google_cver |
Version du cookie Il sera toujours spécifié dans la balise de correspondance de Google. |
google_push |
Indique que cette requête lance le workflow de mise en correspondance des pixels. Cette valeur doit être renvoyée via le paramètre correspondant dans la réponse de redirection de l'enchérisseur. |
Paramètres de redirection de la mise en correspondance des pixels de l'enchérisseur
Paramètres | Description |
---|---|
google_nid |
ID de réseau du compte de l'enchérisseur. Cet ID peut être récupéré via la ressource Enchérisseurs. |
google_push |
Indique que cette redirection a terminé le workflow de mise en correspondance des pixels. La valeur de la balise de correspondance Google correspondante doit être spécifiée ici. |
google_hm |
Contient les données que l'enchérisseur souhaite stocker dans une table des correspondances hébergée par Google. |
google_ula |
Chaîne utilisée pour ajouter l'utilisateur à une liste existante. Le format attendu de cette valeur est userlistid[,timestamp] :
Ce paramètre d'URL peut être répété pour ajouter l'utilisateur à plusieurs listes. |
Initiée par Google: mise en correspondance de pixels unidirectionnelle
La mise en correspondance de pixels unidirectionnelle diffère du workflow bidirectionnel dans la mesure où la balise de correspondance de Google n'inclut pas de paramètre spécifiant l'ID utilisateur Google, mais continue à remplir une table des correspondances hébergée par Google. Elle peut être utilisée dans les cas où l'enchérisseur n'est pas autorisé à héberger les ID utilisateur Google dans sa propre table des correspondances. Un exemple simple du workflow révisé est résumé dans les étapes ci-dessous.
Étape 1: Google place une balise de correspondance
Google place une balise de correspondance pour un enchérisseur sélectionné via un algorithme. La balise de correspondance inclut le paramètre google_push
. Exemple :
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
Étape 2: Le navigateur de l'utilisateur demande un pixel à l'URL de mise en correspondance "Cuisine" de l'enchérisseur
Le navigateur de l'utilisateur demande un pixel à l'URL de mise en correspondance des cookies de l'enchérisseur, qui inclut son cookie dans les en-têtes HTTP.
Étape 3: Redirigez les utilisateurs vers le service de lecture des cookies de Google
Le point de terminaison de mise en correspondance des cookies de l'enchérisseur doit rediriger vers le service de mise en correspondance des cookies de Google, y compris le paramètre google_hm
renseigné avec ses données de cookies encodées en base64 compatibles avec le Web. L'URL de redirection peut se présenter comme suit:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA
Étape 4: Le navigateur de l'utilisateur est redirigé vers le service de lecture des cookies de Google
Google recevra une redirection contenant les paramètres que vous avez spécifiés, en plus de son cookie dans les en-têtes HTTP. Si l'opération a réussi, les impressions enregistrées par cet utilisateur dans les demandes d'enchères ultérieures incluront les données de correspondance hébergées par l'enchérisseur dans BidRequest.hosted_match_data
pour le protocole Google ou dans BidRequest.user.buyeruid
pour l'implémentation Google OpenRTB. Les enchérisseurs peuvent également renseigner les listes d'utilisateurs à l'aide des données de correspondance hébergées qu'ils ont spécifiées.
Enfin, Google renvoie un pixel transparent de 1 x 1 au navigateur de l'internaute.
Assistant de mise en correspondance des cookies
Open Bidding permet aux places de marché d'utiliser les workflows de mise en correspondance des cookies démarrés par l'enchérisseur et initiés par Google pour associer un ID utilisateur Google à leur cookie. Cookie Match Assist (CMA) est une fonctionnalité supplémentaire pour les places de marché qui leur permet de créer des tables de correspondance avec leurs propres enchérisseurs.
Fonctionnement de Cookie Match Assist
Lorsque vous placez une annonce, Google sélectionne par le biais d'un algorithme une place de marché participante et place une balise Cookie Match Assist ayant la structure suivante:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
La balise de correspondance CMA de Google entraîne la réception d'une demande de pixel par l'URL de mise en correspondance des cookies de la place de marché.
- Le point de terminaison de mise en correspondance des cookies de la place de marché reçoit la demande, et son propre service de mise en correspondance des cookies est chargé de mettre en correspondance l'ID utilisateur avec l'un de ses enchérisseurs. Dans le schéma ci-dessous, le service de mise en correspondance des cookies de la place de marché répond au navigateur de l'utilisateur par une redirection vers l'un des points de terminaison de l'enchérisseur.
- L'enchérisseur reçoit la demande, ainsi que tous les paramètres spécifiés par la place de marché pour faire correspondre l'ID utilisateur à son cookie.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=5&hl=fr)
Restrictions
Limiter la fréquence des demandes de nouvelles correspondances
Les enchérisseurs sont chargés de limiter le nombre d'appels au service de mise en correspondance des cookies pour les utilisateurs qui ont reçu une nouvelle entrée dans la table de correspondance hébergée par Google. Une entrée de la table des correspondances hébergée peut être considérée comme expirée au bout de 14 jours. Passé ce délai, elle peut être actualisée.
Répondre à toutes les demandes de mise en correspondance des pixels
Les enchérisseurs qui utilisent le workflow de mise en correspondance des pixels doivent répondre à toutes les demandes de mise en correspondance des pixels entrantes avec une réponse incluant le paramètre google_push
. Cela permet à Google d'appliquer des règles en surveillant l'utilisation. Si le taux de réponse d'un enchérisseur passe en dessous de 90%, Google limite le nombre de demandes de mise en correspondance Pixel envoyées à son compte.
Utiliser des points de terminaison HTTPS
Les points de terminaison utilisés dans tous les workflows de mise en correspondance des cookies doivent obligatoirement utiliser le protocole HTTPS.
Lorsque vous répondez à une demande de mise en correspondance de pixels qui vous a été envoyée via HTTPS, vous devez rediriger l'utilisateur vers le service de lecture des cookies via HTTPS. De même, un point de terminaison Cookie Match Assist qui redirige vers des enchérisseurs doit également utiliser HTTPS. Si vous envoyez des requêtes à Google via HTTP plus d'une fois toutes les deux minutes, le nombre de demandes de mise en correspondance envoyées à votre compte sera limité.
Exigences relatives au consentement de l'utilisateur dans l'UE
Les demandes de mise en correspondance des cookies soumises aux Règles de Google relatives au consentement de l'utilisateur dans l'UE doivent indiquer le consentement de l'utilisateur final. Ces demandes doivent indiquer que le consentement a été obtenu de l'une des manières suivantes:
- TCF v2: inclut les paramètres
gdpr
etgdpr_consent
. Pour en savoir plus, consultez la documentation de la version 2.0 du TCF de l'IAB pour Authorized Buyers. process_consent
: déclaration selon laquelle l'enchérisseur a obtenu le consentement nécessaire de l'utilisateur.
Exemples
Les exemples ci-dessous illustrent comment utiliser le service de lecture des cookies pour atteindre des objectifs spécifiques. Notez que, sauf indication contraire, nous partons du principe que l'utilisateur concerné ne réside pas dans un État américain soumis à des restrictions de confidentialité.
Insérer une table des correspondances hébergée par un enchérisseur
Un enchérisseur peut utiliser le workflow de lecture des cookies pour renseigner sa propre table de correspondance en ne fournissant que les paramètres google_nid
et google_cm
dans sa balise de correspondance. Cela peut se présenter comme suit:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
Si l'URL de mise en correspondance des cookies de l'enchérisseur est définie sur https://ad.network.com/pixel?id=1
et que la mise en correspondance des cookies aboutit, la redirection que Google envoie en réponse à la balise de correspondance de l'enchérisseur peut se présenter comme suit:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
Si l'opération de mise en correspondance des cookies échoue, car l'utilisateur ne possède pas de cookie Google, la réponse est la suivante:
https://ad.network.com/pixel?id=1&google_error=3
Le code d'erreur dépend de la cause sous-jacente de l'erreur. Pour en savoir plus sur les codes d'erreur possibles pour le workflow de mise en correspondance des cookies, consultez les paramètres d'URL de redirection.
Ajouter à une seule liste d'utilisateurs
Le paramètre google_ula
peut être spécifié dans la balise de correspondance d'un enchérisseur pour ajouter l'utilisateur à une liste d'utilisateurs avec l'ID donné. Si la table des correspondances hébergée par Google ou l'enchérisseur comporte une nouvelle entrée pour l'utilisateur, l'enchérisseur peut placer une balise de correspondance incluant les paramètres google_nid
et google_ula
pour ajouter l'utilisateur à la liste spécifiée sans lancer le workflow complet de mise en correspondance des cookies. Consultez les restrictions concernant l'appel du service de lecture des cookies pour plus de détails. La balise de correspondance correspondante peut se présenter comme suit:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Pour obtenir une réponse satisfaisante, lorsque l'URL de mise en correspondance des cookies de l'enchérisseur est https://ad.network.com/pixel
, l'URL de redirection de Google se présentera comme suit:
https://ad.network.com/pixel?google_ula=12345,0
En cas d'erreur globale (par exemple, s'il n'y a pas de cookie Google pour l'utilisateur), l'URL de redirection inclura le paramètre google_error
:
https://ad.network.com/pixel?google_error=3
Si une erreur concerne spécifiquement l'ajout de l'utilisateur à la liste, vous recevrez google_ula
au niveau de la redirection. Contrairement au paramètre de balise de correspondance correspondant, ce code remplace l'horodatage par un code d'état pour indiquer la réussite de l'opération. Par exemple, si la demande a échoué, car le compte de l'enchérisseur n'avait pas accès à la liste d'utilisateurs spécifiée, l'URL de redirection serait:
https://ad.network.com/pixel?google_ula=12345,2
Ajouter à plusieurs listes d'utilisateurs
Les enchérisseurs peuvent spécifier qu'un utilisateur doit être ajouté à plusieurs listes d'utilisateurs en incluant plusieurs paramètres google_ula
dans la balise de correspondance. En pratique, cela peut se présenter comme suit:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
L'état de l'opération pour chaque liste d'utilisateurs est également indiqué via des paramètres google_ula
distincts dans la redirection:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
La redirection ci-dessus montre que l'opération a réussi pour la liste d'utilisateurs associée à l'ID 45678
, mais qu'elle a échoué pour la liste d'utilisateurs associée à l'ID 12345
, car l'enchérisseur n'était pas autorisé à y accéder.
Suivez le workflow de mise en correspondance des cookies et ajoutez des utilisateurs à la liste d'utilisateurs
Pour effectuer la mise en correspondance des cookies et ajouter l'utilisateur à une liste d'utilisateurs dans une seule demande, la balise de correspondance d'un enchérisseur doit inclure google_cm
et google_ula
:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />
L'URL de redirection spécifiée par Google inclut google_gid
, google_cver
et google_ula
. Cela peut se présenter comme suit:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Stocker une correspondance dans un tableau de correspondance hébergé par Google
Si un enchérisseur souhaite stocker les données de ses cookies dans une table des correspondances hébergée par Google sans avoir l'intention de stocker la correspondance avec l'ID utilisateur Google dans sa propre table de correspondance, sa balise de correspondance doit inclure le paramètre google_hm
, dont la valeur doit être une chaîne encodée au format base64 adapté au Web. Pour un utilisateur dont les données de cookie non encodées de l'enchérisseur sont Cookie number 1!
, la valeur encodée serait Q29va2llIG51bWJlciAxIQ==
, qui serait utilisée dans une balise de correspondance semblable à celle-ci:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Pour obtenir une réponse satisfaisante, lorsque l'URL de mise en correspondance des cookies de l'enchérisseur est https://cookie-monster.com/pixel
, l'URL de redirection de Google se présentera ainsi:
https://cookie-monster.com/pixel
Le paramètre google_gid
ne figure pas dans la redirection, car la balise de correspondance n'incluait pas google_cm
, et google_hm
n'est pas inclus dans les réponses réussies. Dans les futures demandes d'enchères pour les impressions de cet utilisateur, l'enchérisseur recevra ses données de correspondance hébergées dans BidRequest.hosted_match_data
pour le protocole RTB de Google ou BidRequest.user.buyeruid
pour l'implémentation OpenRTB de Google.
Si l'enchérisseur a utilisé à la place une balise de correspondance dans laquelle la valeur de google_hm
n'était pas encodée en base64 (telle que chocolate_chunk!
), l'URL de redirection peut se présenter comme suit:
https://cookie-monster.com/pixel?google_hm=2
L'URL de redirection ci-dessus inclut une valeur google_hm
de 2
, suggérant que l'opération a échoué parce que la valeur n'a pas pu être décodée.
Tableaux de correspondance hébergés par Google et l'enchérisseur avec listes d'utilisateurs
Si un enchérisseur héberge sa propre liste d'utilisation en plus d'une liste d'utilisateurs hébergée par Google, qu'il souhaite qu'une seule balise de correspondance corresponde aux deux tableaux et ajoute l'utilisateur à une liste d'utilisateurs donnée, sa balise de correspondance doit inclure les paramètres google_cm
, google_hm
et google_ula
. Si les données des cookies de l'enchérisseur sont Cookie number 1!
, la valeur encodée est Q29va2llIG51bWJlciAxIQ==
, ce qui génère une balise de correspondance semblable à celle-ci:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
Pour que la réponse soit satisfaisante, lorsque l'URL de mise en correspondance des cookies de l'enchérisseur est https://cookie-monster.com/pixel
, l'URL de redirection de Google se présente comme suit:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
Lorsqu'il reçoit la redirection, l'enchérisseur peut faire correspondre l'ID utilisateur Google spécifié dans google_gid
avec les données de ses cookies dans sa table des correspondances. En outre, ils peuvent déterminer que la table des correspondances et la liste d'utilisateurs hébergées par Google ont bien été effectuées. Par conséquent, tout préciblage configuré par l'enchérisseur pour cibler l'ID de la liste d'utilisateurs spécifié entraîne désormais la réception de demandes d'enchères de l'utilisateur pour les impressions. De même, dans ces demandes d'enchères, l'enchérisseur recevra ses données de correspondance hébergées dans BidRequest.hosted_match_data
pour le protocole RTB de Google ou BidRequest.user.buyeruid
pour l'implémentation OpenRTB de Google.