La mise en correspondance des cookies est une fonctionnalité qui vous permet de mettre en correspondance vos cookies : (l'ID d'un utilisateur qui a consulté votre site Web, avec une l'identifiant utilisateur Google propre à un enchérisseur et à créer des listes d'utilisateurs qui vous aideront à pour optimiser l'efficacité de vos choix d'enchères. Ce guide décrit les concepts utilisés dans l'analyse Mise en correspondance, différents processus de mise en correspondance des cookies et variantes pour certains cas d'utilisation.
<ph type="x-smartling-placeholder">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 leur site, afin d'identifier les utilisateurs de ce domaine. Même si deux propriétaires des domaines accepteraient d'échanger ces données, le modèle de sécurité des navigateurs Internet empêchent l'un d'entre eux de lire un cookie défini par un autre domaine.
Dans le contexte de la publicité digitale, Google identifie les utilisateurs à l'aide de cookies
appartenant au domaine doubleclick.net
, et aux enchérisseurs
qui utilisent les enchères en temps réel peuvent avoir leur propre domaine
identifier un ensemble d'utilisateurs
qu'ils aimeraient diffuser. Mise en correspondance des cookies
permet à l'enchérisseur de faire correspondre ses cookies avec ceux de Google, afin de pouvoir
de déterminer si une impression envoyée dans une demande d'enchère est associée à l'un des
utilisateurs ciblés, ils recevront soit leurs propres données de cookies, soit un
l'ID utilisateur Google propre à l'enchérisseur, qui est une forme chiffrée du
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 le et permet de remplir les listes d'utilisateurs.
Tableaux de correspondance
Une table des correspondances peut être utilisée pour mapper un identifiant ou d'autres données d'un domaine avec une autre. Les enchérisseurs peuvent utiliser le service de lecture des cookies pour renseigner leur propre des tables des correspondances en mappant le cookie d'un internaute donné sur le compte ou pour insérer une table des correspondances hébergée par Google. Les tableaux de correspondance sont nécessaire pour que l'application d'enchères d'un enchérisseur puisse accéder aux données des cookies pour l'utilisateur à l'affichage de l'impression.
Tableaux de correspondance hébergés par Google
La maintenance est simplifiée, l'amélioration de la latence et l'accès aux données de correspondance pour 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 au format base64 adaptée au Web : appelées données de correspondance hébergées, qui seront mappées au ID utilisateur Google d'un utilisateur donné. Une fois la correspondance établie, utilisées des manières suivantes:
Enchères en temps réel: dans les demandes d'enchères ultérieures pour les impressions associé à l'utilisateur, Google vous envoie les données de correspondance hébergées correspondant à son ID utilisateur Google. Si votre point de terminaison d'enchères est configuré pour utiliser le protocole RTB de Google, vous les recevez sous forme d'octets décodés via le champ
<ph type="x-smartling-placeholder">BidRequest.hosted_match_data
. Dans le système OpenRTB de Google implémentation,BidRequest.user.buyeruid
renvoie cette sous forme de chaîne encodée en base64 adaptée au Web.Listes d'utilisateurs: les listes d'utilisateurs peuvent être renseignées. à l'aide des ID utilisateur Google ou des données de correspondance hébergées.
<ph type="x-smartling-placeholder">- Préciblage: Vous pouvez configurer votre préciblage de façon à ne recevoir que des demandes d'enchères contenant des données de correspondance hébergées. Cela permet d'éliminer les mots clés d'impressions pour les utilisateurs en dehors de 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 ces listes créées, vous pouvez les renseigner à l'aide des processus de mise en correspondance des cookies décrites ci-dessous, ou via le service d'importation groupée.
<ph type="x-smartling-placeholder">Premiers pas
Pour commencer à utiliser la mise en correspondance des cookies, vous devez contacter votre le responsable de compte technique, qui peut gérer des flux de travail spécifiques et vous aider configurez les éléments suivants:
- ID du réseau de mise en correspondance des cookies (NID): identifiant de chaîne 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érer 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 flux de travail de mise en correspondance des cookies.
- Balise de correspondance: balise que vous devez insérer dans le navigateur de l'utilisateur pour la de mise en correspondance des cookies initié par l'enchérisseur. Il peut être diffusé avec des annonces, ou sur des propriétés Web, en dehors des annonces.
- URL du rapport de mise en correspondance des cookies (facultatif): dans la même direction. de mise en correspondance des cookies, il s'agit d'une URL facultative que vous pouvez fournir spécifier un point de terminaison qui recevra les détails de l'erreur si le cookie la mise en correspondance échoue via une redirection HTTP 302. Par défaut, les réponses sont uniquement envoyé à cette URL si une erreur s'est produite lors de la mise en correspondance des cookies, mais les enchérisseurs peuvent demander que la redirection soit toujours envoyée.
- URL d'assistance de mise en correspondance des cookies: pour les places de marché qui implémentent la l'assistance à la mise en correspondance des cookies, URL de base du point de terminaison destiné à répondre aux requêtes entrantes.
- Quota de l'assistant de mise en correspondance des cookies: pour les places de marché qui implémentent le l'assistance à la mise en correspondance des cookies, le nombre maximal de demandes que son URL de mise en correspondance des cookies peut recevoir chaque fois que seconde. Cela permet d'éviter que les demandes CMA surchargent serveurs d'échange avec des requêtes.
Macros de mise en correspondance des cookies
Quel que soit le processus de mise en correspondance des cookies compatible, L'URL de mise en correspondance des cookies d'un enchérisseur comporte généralement des paramètres ajoutés à un le classement non garanti. Enchérisseurs avec des intégrations nécessitant l'ordre des paramètres peut placer des macros dans leur URL de mise en correspondance des cookies pour garantir leur placement.
Macros prises en charge
Les enchérisseurs peuvent éventuellement configurer leur URL de mise en correspondance des cookies pour inclure un ou
d'autres macros sous la forme %%GOOGLE_<PARAM_NAME>%%
ou
%%GOOGLE_<PARAM_NAME>_PAIR%%
Les macros acceptées et leurs
les 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 de l'intégration de la mise en correspondance des cookies avec un point de terminaison hébergé à
https://user.bidder.com.cookies
et leur implémentation nécessite
paramètres prédéfinis définis par l'enchérisseur, en plus de la 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
URL de mise en correspondance des cookies vers:
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 plus tard une demande de mise en correspondance à cet enchérisseur, elle sera étendue par un texte de ce type:
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 flux de travail : différents cas d'utilisation décrits ci-dessous.
Initié par l'enchérisseur: mise en correspondance bidirectionnelle des cookies
La mise en correspondance bidirectionnelle des cookies fait référence à un flux de travail initié par l'enchérisseur, il place une balise de correspondance dans le navigateur de l'utilisateur qui le redirige vers Google. Ce permet à Google et à l'enchérisseur de remplir les tables des correspondances. Vous trouverez ci-dessous un un exemple simple de ce workflow.
Étape 1: Placez la balise de correspondance
Pour lancer ce processus, le système d'enchères doit placer sa balise de correspondance qu'il affiche dans le navigateur de l'utilisateur. Une balise de correspondance simple qui ne renvoie l'ID utilisateur Google à l'enchérisseur peut être structuré 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 remplir dans différents cas d'utilisation. Pour en savoir plus sur ces paramètres, consultez Paramètres de l'URL de la balise correspondante :
Étape 2: Google répond en envoyant une redirection incluant les données de correspondance
La balise de lecture des cookies fait en sorte que le service de lecture des cookies de Google reçoive une
du navigateur de l'utilisateur, ce qui génère un HTTP 302
rediriger vers l'URL de mise en correspondance des cookies de l'enchérisseur. La redirection inclura les requêtes
spécifiant l'identifiant d'utilisateur Google et son numéro de version dans l'URL ;
l'enchérisseur reçoit également son cookie inclus dans l'en-tête de la demande. Dans
que pour l'URL de mise en correspondance des cookies https://ad.network.com/pixel
,
l'URL de redirection de la balise de correspondance simple, telle qu'illustrée ci-dessus, pourrait se présenter comme suit :
suivantes:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
L'ID utilisateur Google transmis via le paramètre google_gid
est
une version encodée en base64 adaptée au Web sans séparation entre les éléments
. Nous recommandons aux enchérisseurs qui choisissent d'héberger un tableau des correspondances
permet de stocker la chaîne exacte renvoyée par le service de lecture des cookies. Dans les
demandes d'enchères, elles correspondent aux valeurs spécifiées via BidRequest.google_user_id
dans le protocole RTB de Google, ou BidRequest.user.id
dans le protocole
Implémentation d'OpenRTB
La version spécifiée dans google_cver
indique la version
numéro de version de l'identifiant d'utilisateur Google. L'identifiant d'utilisateur Google d'un utilisateur donné
peu fréquemment, après quoi elles sont incrémentées.
Si Google rencontre une erreur lors du traitement de votre demande de mise en correspondance, une
Le paramètre google_error
est spécifié à la place.
Étape 3: L'enchérisseur traite la redirection et répond par un pixel
L'enchérisseur reçoit une redirection vers son URL de mise en correspondance des cookies qui inclut qu'ils ont spécifiés lors de la première étape, et ceux fournis par Google deuxième étape. De plus, ils reçoivent également leur cookie dans l'adresse en-têtes. Si l'opération aboutit, un enchérisseur hébergeant sa propre table des correspondances pourraient faire correspondre leur cookie à l'identifiant d'utilisateur Google inclus dans la réponse. Il est recommandé aux enchérisseurs de stocker la chaîne exacte renvoyée par la mise en correspondance des cookies de service.
Si l'opération échoue, l'enchérisseur reçoit une google_error
dans la redirection. Il s'agit d'une valeur numérique correspondant à différentes
les états d'erreur qui identifient
l'erreur particulière qui s'est produite. Vous pouvez apprendre
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.
Le système d'enchères doit toujours répondre en diffusant une image invisible de 1 x 1 pixel.
Vous pouvez également renvoyer une réponse No Content HTTP 204
.
Schéma du workflow de mise en correspondance des cookies
Ce workflow est illustré par le diagramme ci-dessous, 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 indiqués entre parenthèses.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=19&hl=fr)
Paramètres d'URL de la balise de correspondance
Paramètre | Description |
---|---|
google_nid |
ID de réseau (NID) du compte d'enchérisseur. Cet ID peut être récupéré la section Enchérisseurs ressource. |
google_cm |
Indique au service de lecture 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 sont omises. |
google_sc |
Ce paramètre est obsolète. Définit le cookie de Google pour si aucun utilisateur n'est présent. La valeur du paramètre est ignorée et peut être omises. Si vous ne renseignez pas ce paramètre, une erreur est renvoyée si aucun cookie existe. |
google_no_sc |
Ce paramètre est obsolète. Cela indique à Google au service de lecture des cookies qu'il ne doit pas définir de cookie pour l'utilisateur si l'une n'est pas présente. La valeur du paramètre est ignorée et peut être sont omises. |
google_hm |
Données que l'enchérisseur souhaite stocker dans une table des correspondances hébergée par Google.
La valeur est une chaîne au format base64 adaptée au Web (le remplissage est facultatif). Les données brutes doivent être égales à 40
octets ou moins. Par exemple, |
google_redir |
Une chaîne encodée au format URL qu'un enchérisseur peut spécifier s'il souhaite diriger
Google doit envoyer la redirection HTTP 302 à l'URL encodée pour
cette balise de correspondance. Cela permet à Google d'être placé à l'avant d'une chaîne
à nos partenaires. Cela entraînera une erreur si vous spécifiez
google_hm ou avec google_cm . |
google_ula |
Chaîne utilisée pour ajouter l'utilisateur à une liste d'utilisateurs existante. La valeur
le format attendu est userlistid[,timestamp] :
<ph type="x-smartling-placeholder">
Ce paramètre d'URL peut être répété pour ajouter l'utilisateur à plusieurs . |
gdpr |
Indique que la requête est soumise aux restrictions de données du RGPD
sur l'utilisation de l'IA générative. Pour plus d'informations, voir
les exigences relatives au consentement de l'utilisateur dans l'UE ci-dessous ou l'article Impact sur la mise en correspondance des cookies
des critères d'éligibilité
<ph type="x-smartling-placeholder"></ph>
Documentation sur la version 2.0 du TCF de l'IAB Authorized Buyers
Exemple : |
gdpr_consent |
Une chaîne TC qui représente le consentement de l'utilisateur final. Pour en savoir plus, Voir les exigences relatives au consentement de l'utilisateur dans l'UE ci-dessous, ou Comment la chaîne TC sera-t-elle transmise ? dans le champ <ph type="x-smartling-placeholder"></ph> Documentation sur la version 2.0 du TCF de l'IAB Authorized Buyers |
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
<ph type="x-smartling-placeholder"></ph>
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 ci-dessus, les enchérisseurs peuvent spécifier leurs propres paramètres,
sont ajoutés à l'URL de redirection en tant que paramètres. Notez que les règles définies par l'enchérisseur
les paramètres nommés avec le préfixe google_
seront ignorés, car
ceux-ci sont réservés par Google pour le développement futur et la préservation
paramètres" le classement n'est pas garanti. Une balise de correspondance incluant les valeurs définies par l'enchérisseur
paramètres peuvent ressembler à ceci:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
Paramètres de l'URL de redirection
L'URL de redirection est créée à partir de l'URL de lecture des cookies de base configurée pour
compte d'un enchérisseur, y compris google_
et les paramètres définis par l'enchérisseur
en fonction de ceux spécifiés
dans la balise de correspondance. Les google_
suivants
paramètres de réponse définis:
Paramètre | Description |
---|---|
google_gid |
ID d'utilisateur Google. Définissez ce paramètre si google_cm est spécifié dans la requête et que celle-ci a abouti. |
google_cver |
Version du cookie. Définissez ce paramètre 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. Quand ?
reçu, il indique qu'aucune opération n'a été effectuée et qu'aucune autre
Les paramètres de réponse
|
google_hm |
S'affiche uniquement si la tentative d'écriture dans la table de correspondance hébergée par Google est défaillant. 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 comme un utilisateur type qui consulte une page Web.
Scénario 1: L'utilisateur supprime ses cookies et consulte un site
Jeanne efface tous les cookies de son cache. Il visite ensuite la page d'accueil de ExampleNews.com.
Voici le processus :
- ExampleNews.com s'affiche et appelle les annonces à partir de Google (Ad Manager).
- Comme le bloc d'annonces est éligible pour l'allocation dynamique, Google envoie l'enchère à 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. et envoie sa réponse à l'enchère.
- Google reçoit les réponses aux enchères des enchérisseurs, y compris la réponse de FinestDSP spécifiant une annonce avec une balise de correspondance (pixel).
- FinestDSP remporte l'enchère. Google diffuse l'annonce de FinestDSP et fait correspondre la balise à Jane.
- La balise appelle le service de lecture des cookies de Google, en spécifiant le
Paramètres
google_nid
etgoogle_cm
. - Le service de lecture des cookies lit le cookie Google de Jane et envoie le cookie
navigateur, une redirection vers l'URL de lecture des cookies de FinestDSP avec
Paramètres
google_user_id
etgoogle_cver
définis. - Le navigateur de Jane charge la redirection vers l'URL de lecture des cookies 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 son cookie pour Jeanne dans le
En-têtes HTTP. FinestDSP peut désormais stocker le mappage de son cookie
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=19&hl=fr)
Scénario 2: Utilisateur avec un mappage existant
Une semaine après le scénario 1, Jane accède de nouveau à ExampleNews.com. Maintenant que Jane des cookies de l'enchérisseur et d'Ad Manager sont disponibles. fonctionne.
- La page Web s'affiche, ce qui amène Google (Ad Manager) à demander des annonces qui sera affichée 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 le
google_user_id
- FinestDSP recherche
google_user_id
dans sa table des correspondances, et trouve le cookie associé à Jeanne créé une semaine plus tôt. (dans le scénario 1). - Sur la base des informations associées au cookie, les enchères de FinestDSP place une enchère sur l'impression et remporte l'enchère.
- Jeanne pourra voir une annonce adaptée à ses centres d'intérêt, sur la base d'informations appartenant à FinestDSP.
Initié par l'enchérisseur: mise en correspondance unidirectionnelle des cookies
La lecture des cookies unidirectionnelle est
similaire au workflow bidirectionnel.
sauf qu'elle est modifiée de sorte que seul Google héberge et renseigne une correspondance.
tableau. Elle peut être utilisée lorsque l'enchérisseur n'est pas autorisé à héberger
les ID utilisateur Google dans leur propre table des correspondances. Pour cela, les enchérisseurs
doit autoriser Google à héberger la table des correspondances, ne peut plus spécifier
google_cm
dans les demandes adressées au service de lecture des cookies de Google ; et
ne reçoivent donc pas de google_gid
pour remplir leur propre
table des correspondances. Une fois que Google a établi une correspondance pour un utilisateur, les enchérisseurs peuvent ajouter
aux listes d'utilisateurs à l'aide de leurs propres données de cookies. De même, les demandes d'enchères pour
ces utilisateurs excluent l'User-ID Google, mais incluent les données de correspondance hébergées. A
Les étapes ci-dessous résument un exemple simple du flux de travail révisé.
Étape 1: Placez la balise de correspondance dirigée vers l'URL de mise en correspondance des cookies de l'enchérisseur
Pour lancer ce processus, un enchérisseur doit placer une balise de correspondance
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 diriger le navigateur de l'internaute vers votre cookie
URL correspondante. Par exemple, si l'URL de mise en correspondance des cookies est configurée comme suit :
https://ad.network.com/pixel
, il ressemblerait à ceci:
<img src="https://ad.network.com/pixel" />
Lors du chargement dans le navigateur de l'utilisateur, celui-ci demande un pixel au fichier URL de mise en correspondance des cookies. Cette requête contiendra son cookie dans l’en-tête HTTP, à extraire pour l'étape suivante.
Étape 2: Redirection vers le service de lecture des cookies de Google
Le point de terminaison de la mise en correspondance des cookies de l'enchérisseur doit rediriger vers le point de terminaison de Google
Service de mise en correspondance, y compris le paramètre google_hm
renseigné avec
leurs données de cookies encodées en base64 adaptées au Web. L'URL de redirection peut se présenter comme suit :
suivantes:
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, dans en plus du cookie de Google dans les en-têtes HTTP.
Étape 4: Google diffuse un pixel en cas de réussite ou d'erreur de redirection si l'URL du rapport est spécifiée
Si l'opération de mise en correspondance des cookies aboutit, ou si aucun cookie
L'URL du rapport correspondant a été spécifiée pour le compte Google de l'enchérisseur
diffuse un pixel transparent de 1 x 1 par défaut, et le workflow s'arrête ici.
Les impressions générées par cet utilisateur dans les demandes d'enchères ultérieures incluront les impressions
des données de correspondance hébergées dans BidRequest.hosted_match_data
pour
Protocol, ou BidRequest.user.buyeruid
pour OpenRTB de Google
la mise en œuvre. 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é.
Sinon, si une erreur s'est produite, Google enverra une redirection au
URL du rapport de mise en correspondance des cookies indiquant la cause de l'erreur spécifiée dans le champ
Paramètre google_error
. Si l'URL du rapport de mise en correspondance des cookies de l'enchérisseur
étaient https://ad.network.com/report
, l'URL de redirection serait
par exemple:
<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 mise en correspondance des cookies de l'enchérisseur
Le navigateur de l'utilisateur redirigera vers l'URL du rapport de mise en correspondance 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 de l'erreur
consultez la description des paramètres.
Étape 6: L'enchérisseur diffuse 1 x 1 pixel transparent
L'enchérisseur doit répondre en diffusant un pixel transparent de 1 x 1 à l'adresse navigateur.
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 situés dans les États américains soumis à des restrictions de confidentialité est illustré par le schéma. ci-dessous, où les requêtes et les réponses sont représentées par une flèche, et les données les éléments qui les accompagnent sont répertoriés entre parenthèses.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=19&hl=fr)
Paramètres d'URL pour l'enchérisseur qui redirigent vers le service de lecture des cookies de Google
Paramètre | Description |
---|---|
google_nid |
ID de réseau (NID) du compte d'enchérisseur. Cet ID peut être récupéré la section Enchérisseurs ressource. |
google_sc |
Ce paramètre est obsolète. Définit le cookie de Google pour si aucun utilisateur n'est présent. La valeur du paramètre est ignorée et peut être omises. Si vous ne renseignez pas ce paramètre, une erreur est renvoyée si aucun cookie existe. |
google_no_sc |
Ce paramètre est obsolète. Cela indique à Google au service de lecture des cookies qu'il ne doit pas définir de cookie pour l'utilisateur si l'une n'est pas présente. La valeur du paramètre est ignorée et peut être sont omises. |
google_hm |
Contient les données que l'enchérisseur souhaite stocker dans une correspondance hébergée par Google tableau. |
google_redir |
URL encodée à laquelle vous souhaitez que Google envoie une redirection HTTP 302. La
l'URL spécifiée recevra les 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. La valeur
le format attendu est userlistid[,timestamp] :
<ph type="x-smartling-placeholder">
Ce paramètre d'URL peut être répété pour ajouter l'utilisateur à plusieurs . |
gdpr |
Indique que la requête est soumise aux restrictions de données du RGPD
sur l'utilisation de l'IA générative. Pour plus d'informations, voir
les exigences relatives au consentement de l'utilisateur dans l'UE ci-dessous ou l'article Impact sur la mise en correspondance des cookies
des critères d'éligibilité
<ph type="x-smartling-placeholder"></ph>
Documentation sur la version 2.0 du TCF de l'IAB Authorized Buyers
Exemple : |
gdpr_consent |
Une chaîne TC qui représente le consentement de l'utilisateur final. Pour en savoir plus, Voir les exigences relatives au consentement de l'utilisateur dans l'UE ci-dessous, ou Comment la chaîne TC sera-t-elle transmise ? dans le champ <ph type="x-smartling-placeholder"></ph> Documentation sur la version 2.0 du TCF de l'IAB Authorized Buyers |
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
<ph type="x-smartling-placeholder"></ph>
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. Quand ?
reçu, il indique qu'aucune opération n'a été effectuée et qu'aucune autre
Les paramètres de réponse
|
Déclenchement par Google: mise en correspondance bidirectionnelle des pixels
La mise en correspondance bidirectionnelle des pixels est un processus de mise en correspondance des cookies de Google Service où Google tente d'établir une correspondance entre un identifiant utilisateur Google et un algorithme l'enchérisseur sélectionné autre que le gagnant de l'enchère du système d'enchères en temps réel. Lorsqu'une annonce est place, Google place une balise de correspondance indiquant au navigateur de l'internaute de charger un pixel transparent provenant de l'URL de mise en correspondance des cookies de l'enchérisseur sélectionné. Cela permettra Google et l'enchérisseur pour remplir 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'internaute et qu'une
l'espace publicitaire de cette page est rempli par Google, une balise de correspondance peut être insérée
demande un pixel à un enchérisseur sélectionné par un algorithme. 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, le
peuvent utiliser pour remplir
leur table des correspondances. Pour une URL de mise en correspondance des cookies
spécifiée en tant que https://ad.network.com/pixel
, la structure est la suivante :
ce qui 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 renvoyer vers l'URL du service de lecture des cookies de Google
Les enchérisseurs qui reçoivent des demandes de mise en correspondance de pixels doivent répondre avec un rediriger vers le service de lecture des cookies de Google structuré 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 de l'URL utilisée dans la
pour le 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
google_push
. Sa valeur doit être égale à la valeur du paramètre
fournies par Google dans la demande. Également semblable à celui créé par l'enchérisseur
le workflow, paramètres supplémentaires
pour des cas d'utilisation supplémentaires.
Étape 3: Google traite la redirection et répond par pixel
Google consigne qu'une correspondance a été créée pour cet utilisateur et gère les opérations supplémentaires demandées par les paramètres de requête. Enfin, Google répond avec un pixel transparent de 1 x 1.
Schéma illustrant le workflow de mise en correspondance des pixels
Ce workflow est illustré par le diagramme ci-dessous, 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 indiqués entre parenthèses.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=19&hl=fr)
Paramètres de demande de balise de correspondance Google
Paramètre | Description |
---|---|
google_gid |
ID d'utilisateur Google. Pour les utilisateurs situés en dehors d'un État des États-Unis soumis à des restrictions de confidentialité, il s'agira toujours spécifié dans la balise de correspondance de Google. |
google_cver |
Version du cookie. Il sera toujours spécifié dans la correspondance de Google . |
google_push |
Indique que cette requête lance le workflow de mise en correspondance des pixels. La valeur doit être renvoyée via le paramètre correspondant dans le fichier la réponse de redirection. |
Paramètres de redirection de la mise en correspondance des pixels de l'enchérisseur
Paramètre | Description |
---|---|
google_nid |
ID de réseau (NID) du compte d'enchérisseur. Cet ID peut être récupéré la section Enchérisseurs ressource. |
google_push |
Indique que cette redirection termine la mise en correspondance des pixels du workflow. La valeur de la balise de correspondance Google correspondante doit être spécifiées ici. |
google_hm |
Contient les données que l'enchérisseur souhaite stocker dans une correspondance hébergée par Google tableau. |
google_ula |
Chaîne utilisée pour ajouter l'utilisateur à une liste d'utilisateurs existante. La valeur
le format attendu est userlistid[,timestamp] :
<ph type="x-smartling-placeholder">
Ce paramètre d'URL peut être répété pour ajouter l'utilisateur à plusieurs . |
Déclenchement par Google: mise en correspondance unidirectionnelle des pixels
La mise en correspondance de pixels unidirectionnelle diffère du workflow bidirectionnel dans que la balise de correspondance de Google n'inclut pas de paramètre spécifiant l'utilisateur mais continue à remplir un tableau de correspondance hébergé par Google. Il peut être utilisé lorsque l'enchérisseur n'est pas autorisé à héberger des ID utilisateur Google dans ses sa propre table des correspondances. Un exemple simple de flux de travail révisé est résumé dans le les étapes ci-dessous.
Étape 1: Google place une balise de correspondance
Google place une balise de correspondance pour un enchérisseur sélectionné par un algorithme. La balise de correspondance inclut le paramètre
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 Cooking Matching de l'enchérisseur
Le navigateur de l'utilisateur demande un pixel à partir de l'URL de mise en correspondance des cookies de l'enchérisseur. en incluant le cookie de l'enchérisseur dans les en-têtes HTTP.
Étape 3: Redirection vers le service de lecture des cookies de Google
Le point de terminaison de la mise en correspondance des cookies de l'enchérisseur doit rediriger vers le point de terminaison de Google
Service de mise en correspondance, y compris le paramètre google_hm
renseigné avec
leurs données de cookies encodées en base64 adaptées au Web. L'URL de redirection peut se présenter comme suit :
suivantes:
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, dans
en plus du cookie de Google
dans les en-têtes HTTP. Si l'opération était
les impressions enregistrées par cet utilisateur dans les demandes d'enchères ultérieures incluront
données de correspondance hébergées de l'enchérisseur dans BidRequest.hosted_match_data
pour
le protocole Google, ou BidRequest.user.buyeruid
pour le protocole
Implémentation d'OpenRTB Les enchérisseurs peuvent également remplir les listes d'utilisateurs à l'aide de l'API
correspondent aux
donné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 des enchères initiées par un enchérisseur et initiative par Google de mise en correspondance des cookies, afin d'associer un ID utilisateur Google à son cookie. Biscuits Il s'agit d'une fonctionnalité supplémentaire qui permet aux places de marché créer des tables des correspondances avec leurs propres enchérisseurs.
Fonctionnement de l'assistant de mise en correspondance des cookies
Lorsqu'une annonce est diffusée, Google sélectionne, via un algorithme, et place une balise Cookie Match Assist avec structure:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
Avec la balise de correspondance CMA de Google, l'URL de mise en correspondance des cookies de la place de marché recevoir une requête de pixel.
- Le point de terminaison de mise en correspondance des cookies de la place de marché reçoit la demande, où et son propre service de mise en correspondance des cookies l'un de ses enchérisseurs. Dans le schéma ci-dessous, la mise en correspondance des cookies répond au navigateur de l'utilisateur par une redirection vers le les points de terminaison.
- L'enchérisseur reçoit la demande, ainsi que les paramètres spécifiés par la place de marché pour faire correspondre l'ID utilisateur avec son cookie.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=19&hl=fr)
Restrictions
Limiter la fréquence des requêtes pour les nouvelles correspondances
Les enchérisseurs sont chargés de limiter le nombre d'appels au cookie Service de mise en correspondance pour les utilisateurs ayant une nouvelle entrée dans la correspondance hébergée par Google tableau. Une entrée du tableau de correspondance hébergé peut être considérée comme expirée au bout de 14 jours, après quoi elles peuvent être actualisées.
<ph type="x-smartling-placeholder">Répondre à toutes les demandes de mise en correspondance de pixels
Les enchérisseurs qui utilisent le workflow de mise en correspondance des pixels doivent répondre à toutes
requêtes de mise en correspondance de pixels entrantes avec une réponse incluant l'google_push
. Cela permet à Google d'appliquer des règles en surveillant l'utilisation. Si un
le taux de réponse d'un enchérisseur passe en dessous de 90%, Google limitera le nombre
Demandes de mise en correspondance des pixels envoyées à son compte.
Utiliser des points de terminaison HTTPS
Les points de terminaison utilisés dans tous les workflows de lecture des cookies doivent obligatoirement utiliser HTTPS
Lorsque vous répondez à une demande de mise en correspondance des pixels qui vous est envoyée via HTTPS, vous êtes pour 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 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 demandes de 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 à Utilisateur de Google dans l'UE Les Règles relatives au consentement doivent indiquer le consentement de l'utilisateur final. Ces demandes doivent indiquent que le consentement a été recueilli de l'une des manières suivantes:
- TCF v2: cela inclut
gdpr
etgdpr_consent
paramètres. Pour en savoir plus, consultez le <ph type="x-smartling-placeholder"></ph> Documentation sur la version 2.0 du TCF de l'IAB Authorized Buyers process_consent
: déclaration que l'enchérisseur a obtenue le consentement nécessaire de l'utilisateur.
Exemples
Les exemples ci-dessous montrent comment utiliser le service de lecture des cookies pour atteindre des objectifs spécifiques. Sauf mention contraire, il est a supposé que l'utilisateur concerné ne provenait pas d'un État américain avec des restrictions de confidentialité.
Insérer des données dans une table des correspondances hébergée par l'enchérisseur
Un enchérisseur peut utiliser le processus de mise en correspondance des cookies pour renseigner sa propre correspondance.
en ne fournissant que les champs 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 mise en correspondance des cookies de l'enchérisseur est définie sur https://ad.network.com/pixel?id=1
,
et que l'opération de mise en correspondance des cookies aboutit, la redirection envoyée par Google
à 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 parce que l'utilisateur ne dispose pas cookie Google, la réponse est:
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 apprendre pour en savoir plus sur les codes d'erreur associés au processus de mise en correspondance des cookies, consultez paramètres d'URL de redirection.
Ajouter à une seule liste d'utilisateurs
Le paramètre google_ula
peut être spécifié dans une correspondance d'enchérisseur.
pour ajouter l'utilisateur à une liste d'utilisateurs avec l'ID indiqué. Si le compte Google ou
table de correspondance hébergée par l'enchérisseur contient une nouvelle entrée pour l'utilisateur, l'enchérisseur peut placer
Une balise de correspondance comprenant les champs google_nid
et google_ula
pour ajouter l'utilisateur à la liste spécifiée sans lancer la procédure
Mise en correspondance des cookies Consultez les restrictions.
sur l'appel du service de lecture
des cookies pour plus de détails. L'erreur correspondante
peut se présenter comme suit:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Pour une réponse positive, où l'URL de mise en correspondance des cookies de l'enchérisseur est
https://ad.network.com/pixel
, l'URL de redirection de Google serait la suivante:
https://ad.network.com/pixel?google_ula=12345,0
S'il y a une 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
En cas d'erreur concernant spécifiquement l'ajout de l'utilisateur à la liste,
vous recevrez google_ula
dans la redirection. Contrairement au
paramètre de balise de correspondance correspondant, l'horodatage est alors remplacé par un état
pour indiquer la réussite de l'opération. Par exemple, si la requête échoue
étant donné que le compte d'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
inclure plusieurs paramètres google_ula
dans la balise de correspondance. Dans
vous pouvez obtenir le résultat suivant:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
De même, l'état de l'opération pour chaque liste d'utilisateurs est indiqué via
paramètres google_ula
distincts dans la redirection:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
Dans la redirection ci-dessus, nous pouvons voir que l'opération a réussi pour l'utilisateur.
liste d'utilisateurs 45678
, mais échec pour la liste d'utilisateurs 12345
car l'enchérisseur n'avait pas
l'autorisation d'y accéder.
Suivre la procédure de mise en correspondance des cookies et l'ajouter à la liste d'utilisateurs
Pour mettre en correspondance les cookies et ajouter l'utilisateur à une liste d'utilisateurs
, 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 comprendrait google_gid
,
google_cver
et google_ula
. Cela pourrait
ressembler au
suivantes:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Stocker une correspondance dans une table des correspondances hébergée par Google
Si un enchérisseur souhaite stocker les données de ses cookies dans une table des correspondances hébergée par Google,
et n'a pas l'intention de stocker la correspondance avec l'identifiant d'utilisateur Google dans sa propre correspondance
sa balise de correspondance doit inclure le paramètre google_hm
, où
sa valeur doit être une chaîne au format base64 adaptée au Web. Pour les utilisateurs
données de cookie non encodées de l'enchérisseur est Cookie number 1!
, la valeur encodée
la valeur Q29va2llIG51bWJlciAxIQ==
, qui serait utilisée dans une
de correspondance, comme celle-ci:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Pour une réponse positive, où l'URL de mise en correspondance des cookies de l'enchérisseur est
https://cookie-monster.com/pixel
, l'URL de redirection de Google
être:
https://cookie-monster.com/pixel
Le paramètre google_gid
ne figure pas dans la redirection, car le
la balise de correspondance ne comprenait pas google_cm
, et google_hm
est
non incluses dans les réponses positives. Dans les futures demandes d'enchères pour les impressions
pour cet utilisateur, l'enchérisseur recevra ses données de correspondance hébergées dans
BidRequest.hosted_match_data
pour le protocole d'enchères en temps réel de Google, ou
BidRequest.user.buyeruid
pour l'implémentation OpenRTB de Google.
Si le système d'enchères a utilisé une balise de correspondance dans laquelle la valeur de
google_hm
n'était pas encodé en base64, par exemple
chocolate_chunk!
: l'URL de redirection peut se présenter comme suit :
suivantes:
https://cookie-monster.com/pixel?google_hm=2
L'URL de redirection ci-dessus inclut une valeur google_hm
de
2
, ce qui suggère que l'opération a échoué, car la valeur pourrait
de ne pas être décodées.
Tableaux de correspondance hébergés par Google et par l'enchérisseur avec des listes d'utilisateurs
Si un enchérisseur héberge sa propre liste d'utilisateurs en plus d'un utilisateur hébergé par Google
et souhaite qu'une seule balise de correspondance corresponde aux deux tables et ajoute l'utilisateur
liste d'utilisateurs donnée, sa balise de correspondance doit inclure les éléments suivants : google_cm
,
google_hm
et google_ula
. Si l'annonceur
données du cookie est Cookie number 1!
, la valeur encodée est
Q29va2llIG51bWJlciAxIQ==
, qui générerait une balise de correspondance semblable à
suivantes:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
Pour une réponse positive, où 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
À la réception de la redirection, l'enchérisseur peut correspondre à l'ID utilisateur Google spécifié.
dans google_gid
par les données de cookies dans sa table des correspondances. Dans
En outre, il peut déterminer que la table de correspondance et la liste d'utilisateurs hébergées par Google
ont réussi. Par conséquent, tout préciblage de l'enchérisseur
configuré pour cibler l'ID de liste d'utilisateurs spécifié, l'enchérisseur
recevoir des demandes d'enchères de la part de l'utilisateur pour les impressions De même, dans ces enchères,
l'enchérisseur reçoit ses données de correspondance hébergées
BidRequest.hosted_match_data
pour le protocole d'enchères en temps réel de Google, ou
BidRequest.user.buyeruid
pour l'implémentation OpenRTB de Google.