Mise en correspondance des cookies

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.

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 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.

  <ph type="x-smartling-placeholder">

• 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.

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:

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.

Paramètres d'URL de la balise de correspondance

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:

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 :

1. ExampleNews.com s'affiche et appelle les annonces à partir de Google (Ad Manager).
2. 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.
3. L'application d'enchères de FinestDSP reçoit et traite la demande d'enchère. et envoie sa réponse à l'enchère.
4. 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).
5. FinestDSP remporte l'enchère. Google diffuse l'annonce de FinestDSP et fait correspondre la balise à Jane.
6. La balise appelle le service de lecture des cookies de Google, en spécifiant le Paramètres google_nid et google_cm.
7. 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 et google_cver définis.
8. Le navigateur de Jane charge la redirection vers l'URL de lecture des cookies de FinestDSP.
9. 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.
10. FinestDSP répond à la redirection avec un pixel 1x1 invisible.

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.

1. La page Web s'affiche, ce qui amène Google (Ad Manager) à demander des annonces qui sera affichée sur la page.
2. Lors des enchères publicitaires, Google envoie une demande d'enchère aux enchérisseurs concernés, y compris FinestDSP.
3. FinestDSP reçoit la demande d'enchère, y compris des signaux tels que le google_user_id
4. 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).
5. 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.
6. 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.

Paramètres d'URL pour l'enchérisseur qui redirigent vers le service de lecture des cookies de Google

Paramètres d'URL pour la redirection Google vers l'URL du rapport de mise en correspondance des cookies de l'enchérisseur

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.

Paramètres de demande de balise de correspondance Google

Paramètres de redirection de la mise en correspondance des pixels de l'enchérisseur

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

1. 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"/>

2. 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.

3. 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.
4. 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.

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.

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 et gdpr_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.