Recevoir des notifications d'impression

Vous pouvez recevoir des notifications d'impression chaque fois que Google détecte que vos segments de données ont été utilisés dans une enchère gagnante dans l'enchère en temps réel et ont généré une impression. Google vous recommande d'intégrer les notifications d'impression pour en savoir plus sur l'utilisation de vos segments de données. Contactez votre responsable de compte pour activer les notifications d'impression.

Configurer le point de terminaison de vos notifications d'impression

Vous devez créer un point de terminaison HTTP et partager son URL avec Google pour recevoir des notifications d'impression. Vous pouvez définir l'URL à laquelle les notifications d'impression sont envoyées à l'aide de l'une des options suivantes :

  1. Définir l'URL du point de terminaison des notifications d'impression pour chaque appel de curation en temps réel
    • Vous pouvez définir de manière dynamique l'URL utilisée pour les notifications d'impression pour chaque appel de curation en temps réel que vous recevez en renseignant le champ SegmentResponse.burl.
    • Pour un appel de curation en temps réel donné, vous devez définir le champ SegmentResponse.burl pour recevoir une notification d'impression pour cet appel. Si le champ SegmentResponse.burl n'est pas renseigné, aucune notification ne sera envoyée pour cet appel, même si le champ SegmentResponse.burl a été défini dans des appels précédents.
  2. Définir une URL de point de terminaison des notifications d'impression au niveau du compte
    • Vous pouvez définir une URL de point de terminaison des notifications d'impression au niveau de votre compte en contactant votre responsable de compte. Cette option est idéale si l'URL de votre point de terminaison change rarement.
    • Tous les appels de curation en temps réel utiliseront l'URL de notification d'impression au niveau du compte que vous configurez pour votre compte, sauf si vous remplacez l'URL au niveau du compte en définissant le champ SegmentResponse.burl pour un appel de curation en temps réel individuel.

Analyser une notification d'impression

Les informations envoyées dans une notification d'impression dépendent de la configuration de l'URL de votre point de terminaison de notification d'impression. L'URL de votre point de terminaison peut inclure des paramètres de requête et utiliser des macros pour inclure un contexte supplémentaire sur la façon dont vos segments de données ont été utilisés par l'enchère gagnante qui a généré une impression.

Comprendre comment les macros sont développées

Si vous configurez l'URL de votre point de terminaison pour qu'elle contienne un ou plusieurs paramètres de requête définis sur une macro, les notifications d'impression envoyées à votre point de terminaison développeront ces macros, en les remplaçant par leurs valeurs correspondantes.

Par exemple, vous pouvez configurer une URL de point de terminaison de notification d'impression comme suit :

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

Lors de la réception d'une notification d'impression, les macros sont remplacées, ce qui donne l'URL suivante :

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

En savoir plus sur les macros compatibles

Voici les macros que vous pouvez inclure dans les paramètres de requête de l'URL du point de terminaison de notification d'impression. Ces macros sont remplacées par des valeurs liées à l'enchère gagnante à laquelle un ou plusieurs de vos segments de données ont contribué.

Macro Description
${SR_ID} ID de chaîne unique équivalent au champ SegmentRequest.segment_request_id pour l'appel de curation en temps réel correspondant. Il s'agit de la demande de segment à laquelle vous avez répondu avec un ou plusieurs ID de segment de données ayant contribué à l'enchère gagnante.
${SEGMENT_IDS} Liste d'ID de segment de données de chaîne ayant contribué à l'enchère gagnante. Chaque élément de la liste est séparé par le caractère "|". Par exemple, cette liste peut être développée en une liste de valeurs telles que : "segmentId1|segmentId2|segmentId3" Chaque ID de segment de données qui remplit la liste fait référence à l'ID de ressource de la ressource curators.dataSegments correspondante dans l'API Marketplace.
${AUCTION_PRICE} Chaîne représentant le prix gagnant de l'enchère. Le prix correspond au coût d'une seule impression (CPI) exprimé en micro-USD. Par exemple, une enchère en temps réel de 5 USD de CPM entraînerait le développement de la macro ${AUCTION_PRICE} en 5 000 micro-USD de CPI dans la notification d'impression de curation en temps réel.
${DEAL_ID} ID de l'accord ou du package ayant remporté l'enchère. Il s'agit d'un accord ou d'un package qui cible un ou plusieurs de vos ID de segment de données, qui peuvent être identifiés à l'aide de la macro ${SEGMENT_IDS}.
${BUYER_SEAT_ID} ID du compte acheteur ayant remporté l'impression, tel que spécifié par l'enchérisseur dans l'enchère gagnante. Par exemple, les comptes acheteurs peuvent être des agences ou des annonceurs.

Étapes suivantes