La mise en correspondance des cookies est une fonctionnalité qui vous permet d'associer votre cookie (par exemple, un ID pour un utilisateur qui a consulté votre site Web) à un ID utilisateur Google spécifique à un enchérisseur correspondant, puis de créer des listes d'utilisateurs qui vous aideront à prendre de meilleures décisions d'enchères. Ce guide décrit les concepts utilisés dans le cookie matching, ainsi que différents workflows de cookie matching et les éventuelles variations qu'ils peuvent présenter 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 naviguent sur leur site. Ces cookies sont utilisés pour identifier les utilisateurs au sein 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 empêche l'un de lire un cookie défini par un autre domaine.
Dans le contexte de la publicité numérique, Google identifie les utilisateurs à l'aide de cookies appartenant au domaine doubleclick.net. Les enchérisseurs participant aux enchères en temps réel peuvent avoir leur propre domaine dans lequel ils identifient un ensemble d'utilisateurs auxquels 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ères est associée à l'un des utilisateurs ciblés. Il recevra alors ses propres données de cookie ou un ID utilisateur Google spécifique à l'enchérisseur, qui est une forme chiffrée du cookie doubleclick.net dans la demande d'enchères.
Le service de 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, et permet également de remplir des listes d'utilisateurs.
Tableaux de correspondance
Une table de correspondance peut être utilisée pour mapper un ID ou d'autres données d'un domaine à un autre. Les enchérisseurs peuvent utiliser le service de cookie matching pour remplir leurs propres tables de correspondance en mappant leur cookie pour un utilisateur donné à l'ID utilisateur Google de cet utilisateur, ou pour remplir une table de correspondance hébergée par Google. Les tables de correspondance sont nécessaires pour qu'une application d'enchérisseur puisse accéder aux données de cookies de l'utilisateur auquel l'impression est diffusée.
Tableaux de correspondance hébergés par Google
Pour faciliter la maintenance, améliorer la latence et permettre aux utilisateurs de certaines régions d'accéder aux données de correspondance, nous vous recommandons d'autoriser Google à héberger votre table de correspondance. Cela vous permet de spécifier une chaîne encodée en base64 adaptée au Web (ci-après appelée "données de correspondance hébergées") qui sera associée à l'ID utilisateur Google d'un utilisateur donné. Une fois une correspondance établie, elle peut être utilisée de différentes manières :
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 associées à son ID utilisateur Google. Google spécifiera
BidRequest.user.buyeruidsous la forme d'une chaîne encodée en base64 sécurisée pour le Web.Listes d'utilisateurs : les listes d'utilisateurs peuvent être remplies avec des ID utilisateur Google ou des données de correspondance hébergées.
- Préciblage : Vous pouvez configurer votre préciblage de sorte à ne recevoir que les demandes d'enchères contenant des données de correspondance hébergées. Vous pouvez l'utiliser pour éliminer les impressions moins pertinentes pour les utilisateurs en dehors de votre espace de cookies.
Listes d'utilisateurs
Vous pouvez créer et gérer des listes d'utilisateurs avec l'API Real-Time Bidding. Une fois ces listes créées, vous pouvez les remplir à l'aide des workflows de cookie matching suivants ou du service d'importation groupée.
Premiers pas
Pour commencer à utiliser le cookie matching, vous devez contacter votre responsable de compte technique. Il pourra 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 qui identifie de façon unique un compte d'enchérisseur pour la mise en correspondance des cookies et d'autres opérations similaires.
- URL de mise en correspondance des cookies : URL de base d'un point de terminaison qui accepte et gère les demandes entrantes dans les workflows de mise en correspondance des cookies. Les enchérisseurs peuvent intégrer des macros dans cette URL pour contrôler l'ordre des paramètres qui lui sont transmis dans les workflows de cookie matching.
- Tag de cookie matching : balise que vous devez placer dans le navigateur d'un utilisateur pour le workflow de cookie matching initié par l'enchérisseur. Elles peuvent être diffusées à côté des annonces ou placées sur des propriétés Web en dehors des annonces.
- URL du rapport de cookie matching (facultatif) : dans le workflow unidirectionnel de cookie matching, il s'agit d'une URL facultative permettant de spécifier un point de terminaison qui recevra les détails de l'erreur en cas d'échec du cookie matching via une redirection HTTP 302. Par défaut, les réponses ne seront envoyées à cette URL qu'en cas d'erreur lors de l'opération de correspondance des cookies, mais les enchérisseurs peuvent demander à ce que la redirection soit toujours envoyée.
- URL d'assistance pour la mise en correspondance des cookies : pour les plates-formes d'échange qui implémentent le workflow d'assistance pour la mise en correspondance des cookies, il s'agit de l'URL de base du point de terminaison destiné à répondre aux demandes entrantes.
- Quota d'assistance à la mise en correspondance des cookies : pour les plates-formes d'échange qui implémentent le workflow d'assistance à la mise en correspondance des cookies, il s'agit du nombre maximal de requêtes que leur URL de mise en correspondance des cookies peut recevoir chaque seconde. Cela vise à empêcher les requêtes CMA de surcharger les serveurs de l'échange.
Macros de cookie matching
Dans l'un des 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 dont les intégrations nécessitent un ordre cohérent des paramètres peuvent placer des macros dans leur URL de mise en correspondance des cookies pour indiquer leur emplacement.
Macros prises en charge
Les enchérisseurs peuvent éventuellement configurer leur URL de cookie matching pour inclure une ou plusieurs macros au format %%GOOGLE_<PARAM_NAME>%% ou %%GOOGLE_<PARAM_NAME>_PAIR%%. Les macros acceptées et leurs valeurs développées 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 dispose d'une intégration de cookie matching avec un point de terminaison hébergé sur https://user.bidder.com/cookies, et son implémentation nécessite des paramètres prédéfinis par l'enchérisseur en plus des paramètres Pixel Matching 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 correspondance à cet enchérisseur, elle sera développée comme suit :
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 mise en correspondance des cookies
Le service de cookie matching de Google est compatible avec les trois workflows suivants.
Initiée par l'enchérisseur : mise en correspondance bidirectionnelle des cookies
La mise en correspondance bidirectionnelle des cookies fait référence à un workflow initié par l'enchérisseur, dans lequel il place un tag de correspondance dans le navigateur de l'utilisateur, qui le redirige vers Google. Ce workflow permet à Google et à l'enchérisseur de remplir les tables de correspondance. Voici un exemple de ce workflow.
Étape 1 : Placez la balise de correspondance
Pour lancer ce flux, le soumissionnaire doit placer sa balise de correspondance de sorte qu'elle s'affiche dans le navigateur de l'utilisateur. Une balise de correspondance qui ne renvoie que l'ID utilisateur Google au soumissionnaire 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 Paramètres d'URL des balises de correspondance.
Étape 2 : Google répond avec une redirection incluant les données de correspondance
La balise de correspondance entraînera l'envoi d'une requête au service de mise en correspondance des cookies de Google depuis le navigateur de l'utilisateur, ce qui émettra 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 cookie matching spécifiée comme https://ad.network.com/pixel, l'URL de redirection du tag de correspondance précédent 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, sans remplissage et adaptée au Web. Pour les enchérisseurs qui choisissent d'héberger une table de correspondance, nous leur recommandons de stocker la chaîne exacte renvoyée par le service de correspondance des cookies. Dans les demandes d'enchères suivantes, cela correspondra aux valeurs spécifiées par BidRequest.user.id.
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, après quoi ce numéro est incrémenté.
Si Google rencontre une erreur lors du traitement de votre demande de 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
Le soumissionnaire reçoit une redirection vers son URL de cookie matching, 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 a réussi, un enchérisseur hébergeant sa propre table de correspondance 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 correspondance des cookies.
Si l'opération a échoué, l'enchérisseur recevra 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 spécifique qui s'est produite. Pour en savoir plus sur les valeurs d'erreur possibles, consultez la description du paramètre d'URL google_error. Si vous recevez un message d'erreur, vous pouvez réessayer d'associer l'utilisateur en plaçant une nouvelle balise de correspondance.
Le soumissionnaire doit toujours répondre en diffusant une image de pixel invisible de 1x1 ou, à la place, renvoyer une réponse HTTP 204 No Content.
Diagramme du workflow de mise en correspondance des cookies
Ce workflow est illustré par le schéma suivant, où 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 listés entre parenthèses.
Paramètres d'URL des tags de correspondance
| Paramètre | Description |
|---|---|
google_nid |
ID du réseau (NID) pour le compte enchérisseur. Cet ID peut être récupéré à l'aide de la ressource Enchérisseurs. |
google_cm |
Indique au service de mise en correspondance des cookies de Google qu'il doit effectuer la mise en correspondance des 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 n'en existe pas déjà un. La valeur du paramètre est ignorée et peut être omise. Si vous omettez le paramètre, une erreur se produit si aucun cookie n'existe. |
google_no_sc |
Ce paramètre est obsolète. Cela indique au service de correspondance des cookies de Google qu'il ne doit pas définir de cookie pour l'utilisateur si aucun n'est présent. 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 de correspondance hébergée par Google. La valeur est une chaîne encodée en base64 sécurisée pour le Web (marge intérieure facultative). Les données brutes ne doivent pas dépasser 40 octets. Par exemple, |
google_redir |
Chaîne encodée en URL qu'un enchérisseur peut spécifier s'il souhaite que Google envoie la redirection HTTP 302 vers l'URL encodée pour ce tag de correspondance. Cela permet à Google d'être placé en tête d'un appel en chaîne aux partenaires. Cela entraînera une erreur si elle est spécifiée sans google_hm ou avec google_cm. |
google_ula |
Chaîne utilisée pour ajouter l'utilisateur à une liste d'utilisateurs existante. Le format attendu de la valeur est userlistid[,timestamp] :
Ce paramètre d'URL peut être répété pour ajouter l'utilisateur à plusieurs listes. |
gdpr |
Indique que la requête est soumise aux restrictions du RGPD concernant l'utilisation des données. Pour en savoir plus, consultez
Exigences concernant le consentement des utilisateurs dans l'UE ou Impact sur l'éligibilité au cookie matching dans la
documentation Authorized Buyers sur le TCF v2.0 de l'IAB.
Exemple : |
gdpr_consent |
Chaîne TC représentant le consentement de l'utilisateur final. Pour en savoir plus, consultez Exigences concernant le consentement des utilisateurs dans l'UE ou Comment la chaîne TC sera-t-elle transmise ? dans la documentation Authorized Buyers sur la version 2.0 du TCF de l'IAB. |
process_consent |
Indique que l'enchérisseur a obtenu le consentement de l'utilisateur final pour les utilisations des 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 dans la demande ( Exemple : |
En plus des paramètres précédents, 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 dont le nom commence par le préfixe google_ seront ignorés, car Google les réserve pour de futurs développements. De plus, l'ordre des paramètres n'est pas garanti. Un tag de correspondance incluant des paramètres définis par l'enchérisseur peut se présenter comme suit :
<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 base de cookie matching configurée pour le compte d'un enchérisseur, y compris les paramètres google_ et ceux 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ètre | Description |
|---|---|
google_gid |
ID utilisateur Google Défini si google_cm est spécifié dans la requête et si celle-ci a abouti. |
google_cver |
Version du cookie. Défini si google_cm est spécifié dans la requête et si celle-ci a abouti. |
google_error |
Valeur entière indiquant l'erreur globale de la requête. Lorsqu'il est 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 que si la tentative d'écriture dans la table des correspondances hébergée par Google échoue. Dans ce cas, sa valeur correspond à l'un des codes d'état suivants :
|
google_ula |
État de l'opération d'ajout à la liste des utilisateurs. Répété si plusieurs Ex. : L'opération
|
Exemples de scénarios de workflow de mise en correspondance des cookies
Les scénarios suivants décrivent à quoi peut ressembler le cookie matching pour un utilisateur type qui consulte une page Web.
Scénario 1 : L'utilisateur efface ses cookies et navigue sur un site
Jane vide le cache de tous les cookies. Il accède ensuite à la page d'accueil d'ExampleNews.com.
Voici le processus :
- ExampleNews.com s'affiche et appelle les annonces de Google (Ad Manager).
- Comme le bloc d'annonces est éligible à 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érisseur 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 un tag de correspondance (pixel).
- FinestDSP remporte les enchères. Google diffuse le tag d'annonce et de correspondance de FinestDSP à Jane.
- La balise de correspondance appelle le service de mise en correspondance des cookies de Google, en spécifiant les paramètres
google_nidetgoogle_cm. - Le service de mise en correspondance des cookies lit le cookie Google de Jane et envoie à son navigateur une redirection vers l'URL de mise en correspondance des cookies de FinestDSP avec les paramètres
google_gidetgoogle_cverdéfinis. - Le navigateur de Jane charge la redirection vers l'URL de cookie matching de FinestDSP.
- Le point de terminaison de mise en correspondance des cookies de FinestDSP traite la demande de redirection, qui inclut les paramètres d'URL définis par Google et le cookie de Jane dans les en-têtes HTTP. FinestDSP peut désormais stocker le mappage de son cookie vers
google_giddans sa table de correspondance. - FinestDSP répond à la redirection avec un pixel invisible de 1 x 1.
Scénario 2 : Utilisateur avec un mappage existant
Une semaine après le scénario 1, Jane visite à nouveau ExampleNews.com. Maintenant que Jane dispose à la fois de cookies d'enchérisseur et Ad Manager sur son ordinateur, voici comment fonctionne le matching.
- La page Web s'affiche, ce qui amène Google (Ad Manager) à demander des annonces qui seront diffusées sur la page.
- Lors des enchères publicitaires, Google envoie une demande d'enchère aux enchérisseurs concernés, y compris FinestDSP.
- FinestDSP reçoit la demande d'enchère, y compris des signaux tels que
google_gid. - FinestDSP recherche
google_giddans sa table de correspondance et trouve le cookie associé à Jane qui a été créé une semaine plus tôt (dans le scénario 1). - En fonction 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 voir une annonce adaptée à ses centres d'intérêt, en fonction des informations dont dispose FinestDSP.
Initiée par l'enchérisseur : mise en correspondance unidirectionnelle des cookies
La mise en correspondance unidirectionnelle des cookies est semblable au workflow bidirectionnel, à la différence qu'elle est modifiée de sorte que seuls Google héberge et remplit une table de correspondance. Cette méthode peut être utilisée lorsque l'enchérisseur n'est pas autorisé à héberger des User-ID Google dans sa propre table de correspondance. Pour utiliser ce flux, les enchérisseurs doivent autoriser Google à héberger la table de correspondance. Ils ne peuvent plus spécifier google_cm dans les requêtes envoyées au service de cookie matching de Google et ne recevront donc pas google_gid pour remplir leur propre table de correspondance. Une fois que Google a trouvé une correspondance pour un utilisateur, les enchérisseurs peuvent l'ajouter à des listes d'utilisateurs à l'aide de leurs propres données de cookies. De même, les demandes d'enchères pour ces utilisateurs excluront l'ID utilisateur Google, mais incluront les données de correspondance hébergées. Un exemple de workflow révisé est résumé dans les étapes suivantes.
Étape 1 : Placez la balise de correspondance dirigée vers l'URL de cookie matching de l'enchérisseur
Pour lancer ce flux, un enchérisseur doit placer une balise de correspondance de sorte qu'elle s'affiche dans le navigateur de l'utilisateur. Contrairement au workflow pour les utilisateurs ne résidant 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 correspondance des cookies. Par exemple, si l'URL de mise en correspondance des cookies est configurée sur https://ad.network.com/pixel, elle se présentera comme suit :
<img src="https://ad.network.com/pixel" />
Lors du chargement dans le navigateur de l'utilisateur, il demandera un pixel à l'URL de cookie matching de l'enchérisseur. Cette requête contiendra leur cookie dans l'en-tête HTTP, qui devra être extrait pour l'étape suivante.
Étape 2 : Redirigez l'utilisateur vers le service de cookie matching de Google
Le point de terminaison de cookie matching de l'enchérisseur doit rediriger vers le service de cookie matching de Google, y compris le paramètre google_hm renseigné avec les données de cookie encodées en base64 adaptées au 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 cookie matching de Google
Google recevra une redirection contenant les paramètres que vous avez spécifiés, en plus du cookie de Google dans les en-têtes HTTP.
Étape 4 : Google diffuse le pixel en cas de redirection réussie ou d'erreur si l'URL du rapport est spécifiée
Si l'opération de cookie matching réussit ou si aucune URL de rapport de cookie matching n'a été spécifiée pour le compte de l'enchérisseur, Google diffusera par défaut un pixel transparent de 1x1 et le workflow s'arrêtera là.
Les impressions pour cet utilisateur dans les demandes d'enchères ultérieures incluront les données de correspondance hébergées de l'enchérisseur dans BidRequest.user.buyeruid. Les enchérisseurs peuvent également remplir des 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 enverra une redirection vers l'URL du rapport sur le cookie matching de l'enchérisseur, avec la cause de l'erreur spécifiée dans le paramètre google_error. Si l'URL du rapport de mise en correspondance des cookies de l'enchérisseur est https://ad.network.com/report, l'URL de redirection se présente comme suit :
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
Étape 5 : Le navigateur de l'utilisateur est redirigé vers l'URL du rapport de mise en correspondance des cookies de l'enchérisseur
Le navigateur de l'utilisateur sera redirigé vers l'URL du rapport sur le cookie matching de l'enchérisseur, y compris 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 du paramètre.
Étape 6 : L'enchérisseur diffuse un pixel transparent de 1 x 1
Le soumissionnaire doit répondre en diffusant un pixel transparent de 1 x 1 dans le navigateur de l'utilisateur.
Schéma du workflow de mise en correspondance des cookies pour les utilisateurs des États américains soumis à des restrictions de confidentialité
Le workflow par défaut pour les utilisateurs résidant dans des États américains soumis à des restrictions de confidentialité est illustré dans le schéma suivant, où 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 listés entre parenthèses.
Paramètres d'URL pour la redirection de l'enchérisseur vers le service de cookie matching de Google
| Paramètre | Description |
|---|---|
google_nid |
ID du réseau (NID) pour le compte enchérisseur. Cet ID peut être récupéré à l'aide de la ressource Enchérisseurs. |
google_sc |
Ce paramètre est obsolète. Définit le cookie Google pour l'utilisateur s'il n'en existe pas déjà un. La valeur du paramètre est ignorée et peut être omise. Si vous omettez le paramètre, une erreur se produit si aucun cookie n'existe. |
google_no_sc |
Ce paramètre est obsolète. Cela indique au service de correspondance des cookies de Google qu'il ne doit pas définir de cookie pour l'utilisateur si aucun n'est présent. 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 de correspondance hébergée par Google. |
google_redir |
URL encodée vers laquelle 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 d'utilisateurs existante. Le format attendu de la valeur est userlistid[,timestamp] :
Ce paramètre d'URL peut être répété pour ajouter l'utilisateur à plusieurs listes. |
gdpr |
Indique que la requête est soumise aux restrictions du RGPD concernant l'utilisation des données. Pour en savoir plus, consultez
Exigences concernant le consentement des utilisateurs dans l'UE ou Impact sur l'éligibilité au cookie matching dans la
documentation Authorized Buyers sur le TCF v2.0 de l'IAB.
Exemple : |
gdpr_consent |
Chaîne TC représentant le consentement de l'utilisateur final. Pour en savoir plus, consultez Exigences concernant le consentement des utilisateurs dans l'UE ou Comment la chaîne TC sera-t-elle transmise ? dans la documentation Authorized Buyers sur la version 2.0 du TCF de l'IAB. |
process_consent |
Indique que l'enchérisseur a obtenu le consentement de l'utilisateur final pour les utilisations des 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 dans la demande ( Exemple : |
Paramètres d'URL pour la redirection Google vers l'URL du rapport de mise en correspondance des cookies de l'enchérisseur
| Paramètre | Description |
|---|---|
google_error |
Valeur entière indiquant l'erreur globale de la requête. Lorsqu'il est 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 bidirectionnelle des pixels
La mise en correspondance bidirectionnelle des pixels est un workflow du service de mise en correspondance des cookies de Google, dans lequel Google tente de faire correspondre un ID utilisateur Google à un enchérisseur sélectionné de manière algorithmique autre que le gagnant des enchères en temps réel. Lorsqu'une annonce est diffusée, Google place une balise de correspondance qui redirige le navigateur de l'utilisateur vers un pixel transparent à partir de l'URL de correspondance des cookies de l'enchérisseur choisi. Cela permettra à Google et au soumissionnaire d'insérer des données dans un tableau de correspondance pour un utilisateur donné. Voici un exemple de ce workflow.
Étape 1 : Google place une balise de correspondance
Lorsqu'une page d'un éditeur participant se charge dans le navigateur de l'utilisateur et qu'un emplacement publicitaire sur cette page est rempli par Google, une balise de correspondance peut être placée pour demander un pixel à un enchérisseur sélectionné de manière algorithmique. La balise de mise en correspondance des pixels placée par Google combine l'URL de mise en correspondance des cookies de l'enchérisseur avec des paramètres supplémentaires que l'enchérisseur peut utiliser pour remplir son tableau de correspondance. Pour une URL de mise en correspondance des cookies spécifiée comme 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 : Le bidder doit répondre en redirigeant l'utilisateur vers l'URL du service de correspondance des cookies de Google
Les enchérisseurs qui reçoivent des demandes de correspondance de pixels doivent répondre par une redirection vers le service de correspondance des cookies de Google, structurée comme suit :
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
Notez que l'URL de redirection précédente est semblable à celle utilisée dans la balise de correspondance pour le workflow de cookie matching initié par l'enchérisseur.
Dans la correspondance des 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. Comme pour le workflow initié par l'enchérisseur, des paramètres supplémentaires peuvent être spécifiés pour répondre à d'autres cas d'utilisation.
Étape 3 : Google traite la redirection et répond avec un pixel
Google enregistre qu'une correspondance a été créée pour l'utilisateur et gère toutes les opérations supplémentaires demandées par le biais des paramètres de requête. Enfin, Google répond avec un pixel transparent de 1 x 1.
Schéma du workflow de mise en correspondance des pixels
Ce workflow est illustré par le schéma suivant, où 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 listés entre parenthèses.
Paramètres de requête de balise de correspondance Google
| Paramètre | Description |
|---|---|
google_gid |
ID utilisateur Google Pour les utilisateurs qui ne résident pas dans un État américain soumis à des restrictions de confidentialité, cette valeur sera toujours spécifiée dans la balise de correspondance de Google. |
google_cver |
Version du cookie. Cette valeur sera toujours spécifiée dans la balise de correspondance de Google. |
google_push |
Indique que cette requête lance le workflow de correspondance des pixels. La valeur doit être renvoyée via le paramètre correspondant dans la réponse de redirection de l'enchérisseur. |
gdpr_consent |
Chaîne TC représentant le consentement de l'utilisateur final. Pour en savoir plus, consultez les [exigences concernant le consentement des utilisateurs dans l'UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) ou la section **Comment la chaîne TC sera-t-elle transmise ?** dans la [documentation Authorized Buyers sur le TCF v2.0 de l'IAB](//support.google.com/authorizedbuyers/answer/9789378). |
Paramètres de redirection de la correspondance des pixels de l'enchérisseur
| Paramètre | Description |
|---|---|
google_nid |
ID du réseau (NID) pour le compte enchérisseur. Cet ID peut être récupéré à l'aide de la ressource Enchérisseurs. |
google_push |
Indique que cette redirection termine le workflow de correspondance des pixels. La valeur du tag de correspondance Google correspondant doit être spécifiée ici. |
google_hm |
Contient les données que l'enchérisseur souhaite stocker dans une table de correspondance hébergée par Google. |
google_ula |
Chaîne utilisée pour ajouter l'utilisateur à une liste d'utilisateurs existante. Le format attendu de la valeur est userlistid[,timestamp] :
Ce paramètre d'URL peut être répété pour ajouter l'utilisateur à plusieurs listes. |
gdpr_consent |
Chaîne TC représentant le consentement de l'utilisateur final. Pour en savoir plus, consultez les [exigences concernant le consentement des utilisateurs dans l'UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) ou la section **Comment la chaîne TC sera-t-elle transmise ?** dans la [documentation Authorized Buyers sur le TCF v2.0 de l'IAB](//support.google.com/authorizedbuyers/answer/9789378). |
Initiée par Google : mise en correspondance unidirectionnelle des pixels
La correspondance de pixels unidirectionnelle diffère du workflow bidirectionnel en ce que la balise de correspondance de Google n'inclut pas de paramètre spécifiant l'ID utilisateur Google, mais continue de remplir un tableau de correspondance hébergé par Google. Cette méthode peut être utilisée lorsque l'enchérisseur n'est pas autorisé à héberger des ID utilisateur Google dans sa propre table de correspondance. Un exemple de workflow révisé est résumé dans les étapes suivantes.
Étape 1 : Google place une balise de correspondance
Google place un tag de correspondance pour un enchérisseur sélectionné par algorithme. Le tag 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 le pixel à l'URL de mise en correspondance des cookies de l'enchérisseur
Le navigateur de l'utilisateur demande un pixel à l'URL de cookie matching de l'enchérisseur, y compris le cookie de l'enchérisseur dans les en-têtes HTTP.
Étape 3 : Redirigez vers le service de correspondance des cookies de Google
Le point de terminaison de cookie matching de l'enchérisseur doit rediriger vers le service de cookie matching de Google, y compris le paramètre google_hm renseigné avec les données de cookie encodées en base64 adaptées au 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 cookie matching de Google
Google recevra une redirection contenant les paramètres que vous avez spécifiés, en plus du cookie de Google dans les en-têtes HTTP. Si l'opération a réussi, les impressions pour cet utilisateur dans les demandes d'enchères suivantes incluront les données de correspondance hébergées de l'enchérisseur dans BidRequest.user.buyeruid.
Les enchérisseurs peuvent également remplir des 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'utilisateur.
Assistance pour la mise en correspondance des cookies
Open Bidding permet aux plates-formes d'échange d'utiliser des workflows de mise en correspondance des cookies initiés par l'enchérisseur et initiés par Google pour associer un ID utilisateur Google à son cookie. L'outil Cookie Match Assist (CMA) est une fonctionnalité supplémentaire pour les plates-formes d'échange. Il leur permet de créer des tables de correspondance avec leurs propres enchérisseurs.
Fonctionnement de l'Aide à la mise en correspondance des cookies
Lorsqu'il diffuse une annonce, l'algorithme de Google sélectionne une place de marché participante et y place une balise Cookie Match Assist dont la structure est la suivante :
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
La balise de mise en correspondance CMA de Google entraîne l'envoi d'une demande de pixel à l'URL de mise en correspondance des cookies de la plate-forme.
- Le point de terminaison de cookie matching de la place de marché reçoit la demande, où son propre service de cookie matching est chargé d'associer l'ID utilisateur à l'un de ses enchérisseurs. Dans le diagramme suivant, le service de cookie matching de la place de marché répond au navigateur de l'utilisateur en le redirigeant vers l'un des points de terminaison de son 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.
Restrictions
Limiter la fréquence des demandes de nouvelles correspondances
Il incombe aux enchérisseurs de limiter le nombre d'appels au service Cookie Matching pour les utilisateurs qui ont une entrée récente dans la table de correspondance hébergée par Google. Une entrée dans la table des correspondances hébergée peut être considérée comme expirée au bout de 14 jours, après quoi elle peut être actualisée.
Répondre à toutes les demandes de correspondance de pixels
Les enchérisseurs qui utilisent le workflow de correspondance des pixels sont censés répondre à toutes les demandes de correspondance des pixels entrantes avec une réponse incluant le paramètre google_push. Cela permet à Google d'appliquer les règles en surveillant l'utilisation. Si le taux de réponse d'un enchérisseur est inférieur à 90 %, Google limitera le nombre de demandes de correspondance des pixels envoyées à son compte.
Utiliser des points de terminaison HTTPS
Il est obligatoire que les points de terminaison utilisés dans tous les workflows de lecture des cookies utilisent le protocole HTTPS.
Lorsque vous répondez à une demande de correspondance des pixels qui vous est envoyée via HTTPS, vous devez rediriger vers le service de correspondance des cookies via HTTPS. De même, un point de terminaison Cookie Match Assist qui redirige les 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 requêtes de correspondance envoyées à votre compte sera limité.
Exigences de 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é recueilli de l'une des manières suivantes :
- TCFv2 : cela inclut les paramètres
gdpretgdpr_consent. Pour en savoir plus, consultez la documentation Authorized Buyers sur le TCF v2.0 de l'IAB. process_consent: déclaration indiquant que l'enchérisseur a obtenu le consentement nécessaire de l'utilisateur.
Exemples
Les exemples suivants illustrent l'utilisation du service Cookie Matching pour atteindre des objectifs spécifiques. Notez que, sauf indication contraire, il est supposé que l'utilisateur concerné n'est pas originaire d'un État américain soumis à des restrictions de confidentialité.
Remplir une table de correspondance hébergée par un enchérisseur
Un enchérisseur peut utiliser le workflow de mise en correspondance des cookies pour remplir sa propre table de correspondance en fournissant uniquement les paramètres google_nid et google_cm dans sa balise de correspondance. Voici un exemple :
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
Si l'URL de cookie matching de l'enchérisseur est définie sur https://ad.network.com/pixel?id=1 et que l'opération de cookie matching aboutit, la redirection que Google envoie en réponse au tag 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 cookie matching échoue parce que 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 cookie matching, consultez les paramètres d'URL de redirection.
Ajouter à la liste d'un seul utilisateur
Le paramètre google_ula peut être spécifié dans le tag de correspondance d'un enchérisseur pour ajouter l'utilisateur à une liste d'utilisateurs avec l'ID donné. Si la table de correspondance hébergée par Google ou l'enchérisseur contient une entrée récente 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 cookie matching. Pour en savoir plus, consultez les restrictions concernant l'appel du service de cookie matching. Le tag de correspondance correspondant peut se présenter comme suit :
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Si la réponse est positive et que l'URL de cookie matching de l'enchérisseur est https://ad.network.com/pixel, l'URL de redirection de Google sera la suivante :
https://ad.network.com/pixel?google_ula=12345,0
En cas d'erreur globale (par exemple, si l'utilisateur n'a pas de cookie Google), l'URL de redirection inclut le paramètre google_error :
https://ad.network.com/pixel?google_error=3
Si une erreur se produit lors de l'ajout de l'utilisateur à la liste, vous recevrez google_ula dans la redirection. Contrairement au paramètre de balise de correspondance correspondant, celui-ci remplace le code temporel par un code d'état pour indiquer la réussite de l'opération. Par exemple, si la demande a échoué parce que le compte enchérisseur n'avait pas accès à la liste d'utilisateurs spécifiée, l'URL de redirection serait la suivante :
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 indiqué de la même manière à l'aide de paramètres google_ula distincts dans la redirection :
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
Dans la redirection précédente, nous pouvons voir que l'opération a réussi pour la liste d'utilisateurs dont l'ID est 45678, mais a échoué pour la liste d'utilisateurs dont l'ID est 12345, car l'enchérisseur n'y avait pas accès.
Parcourir le workflow de cookie matching et ajouter à la liste d'utilisateurs
Pour effectuer le cookie matching et ajouter l'utilisateur à une liste d'utilisateurs en une seule requête, 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 inclurait google_gid, google_cver et google_ula. Voici quelques exemples :
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Stocker une correspondance dans une table de correspondance hébergée par Google
Si un enchérisseur souhaite stocker ses données de cookies dans une table de correspondance hébergée par Google et ne prévoit pas de stocker la correspondance avec l'ID utilisateur Google dans sa propre table de correspondance, son tag de correspondance doit inclure le paramètre google_hm, dont la valeur doit être une chaîne encodée en base64 adaptée 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 comme celle-ci :
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Si la réponse est positive et que l'URL de correspondance des cookies de l'enchérisseur est https://cookie-monster.com/pixel, l'URL de redirection de Google sera la suivante :
https://cookie-monster.com/pixel
Le paramètre google_gid n'est pas inclus 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.user.buyeruid.
Si l'enchérisseur utilisait plutôt une balise de correspondance où la valeur de google_hm n'était pas encodée en base64 (par exemple, chocolate_chunk!), l'URL de redirection pourrait ressembler à ce qui suit :
https://cookie-monster.com/pixel?google_hm=2
L'URL de redirection précédente inclut une valeur google_hm de 2, ce qui suggère que l'opération a échoué, car la valeur n'a pas pu être décodée.
Tables de correspondance hébergées par Google et par les enchérisseurs avec des 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, et qu'il souhaite qu'un seul tag de correspondance corresponde aux deux tables et ajoute l'utilisateur à une liste d'utilisateurs donnée, son tag de correspondance doit inclure les paramètres google_cm, google_hm et google_ula. Si les données de cookies de l'enchérisseur sont Cookie number 1!, la valeur encodée sera Q29va2llIG51bWJlciAxIQ==, ce qui générera une balise de correspondance comme celle-ci :
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
Si la réponse est positive et que l'URL de cookie matching 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
À la réception de la redirection, l'enchérisseur peut faire correspondre l'ID utilisateur Google spécifié dans google_gid avec ses données de cookies dans son tableau de correspondance. De plus, ils peuvent déterminer si les opérations sur la table de correspondance et la liste des utilisateurs hébergées par Google ont réussi. Par conséquent, tout ciblage prédéfini configuré par l'enchérisseur pour cibler l'ID de la liste d'utilisateurs spécifiée entraînera désormais la réception de demandes d'enchères pour les impressions de l'utilisateur. De même, dans ces demandes d'enchères, l'enchérisseur recevra ses données de correspondance hébergées dans BidRequest.user.buyeruid.