Benachrichtigungen zu Impressionen erhalten

Sie können Benachrichtigungen zu Impressionen erhalten, wenn Google feststellt, dass Ihre Datensegmente in einem erfolgreichen Gebot in der Echtzeitgebotsauktion verwendet wurden und zu einer Impression geführt haben. Google empfiehlt, Impression-Benachrichtigungen zu integrieren, um mehr darüber zu erfahren, wie Ihre Datensegmente verwendet werden. Wenden Sie sich an Ihren Account Manager, um Impression-Benachrichtigungen zu aktivieren.

Endpunkt für Impression-Benachrichtigungen konfigurieren

Sie müssen einen HTTP-Endpunkt erstellen und seine URL an Google weitergeben, um Impression-Benachrichtigungen zu erhalten. Sie können die URL, an die Impression-Benachrichtigungen gesendet werden, mit einer der folgenden Optionen festlegen:

  1. Legen Sie die Endpunkt-URL für Impression-Benachrichtigungen für jeden Echtzeit-Curation-Aufruf fest.
    • Sie können die URL, die für Impression-Benachrichtigungen verwendet wird, für jeden Echtzeit-Curation-Aufruf dynamisch festlegen, indem Sie das Feld SegmentResponse.burl ausfüllen.
    • Für einen bestimmten RTC-Callout müssen Sie das Feld SegmentResponse.burl festlegen, um eine Impression-Benachrichtigung für diesen Callout zu erhalten. Wenn das Feld SegmentResponse.burl nicht ausgefüllt ist, wird für diesen Hinweis keine Benachrichtigung gesendet, auch wenn das Feld SegmentResponse.burl in früheren Hinweisen festgelegt wurde.
  2. Legen Sie eine Endpunkt-URL für Impressionsbenachrichtigungen auf Kontoebene fest.
    • Sie können eine Endpunkt-URL für Impressionenbenachrichtigungen auf Kontoebene für Ihr Konto festlegen, indem Sie sich an Ihren Account Manager wenden. Diese Methode ist ideal, wenn sich die Endpoint-URL nur selten ändert.
    • Für alle Callouts für die Echtzeit-Kuration wird die Benachrichtigungs-URL für Impressionen auf Kontoebene verwendet, die Sie für Ihr Konto konfigurieren, sofern Sie die URL auf Kontoebene nicht überschreiben, indem Sie das Feld SegmentResponse.burl für einen einzelnen Callout für die Echtzeit-Kuration festlegen.

Impression-Benachrichtigung parsen

Welche Informationen in einer Impression-Benachrichtigung gesendet werden, hängt von der Konfiguration der URL Ihres Impression-Benachrichtigungs-Endpunkts ab. Ihre Endpunkt-URL kann Abfrageparameter enthalten und Makros verwenden, um zusätzlichen Kontext dazu einzufügen, wie Ihre Datensegmente für das Gewinnergebot verwendet wurden, das zu einer Impression geführt hat.

So werden Makros erweitert

Wenn Sie Ihre Endpunkt-URL so konfigurieren, dass sie einen oder mehrere Abfrageparameter enthält, die auf ein Makro festgelegt sind, werden diese Makros in den an Ihren Endpunkt gesendeten Benachrichtigungen zu Impressionen erweitert. Die Makros werden durch die entsprechenden Werte ersetzt.

Sie können beispielsweise eine URL für den Endpunkt für Impressionsbenachrichtigungen so konfigurieren:

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

Wenn Sie eine Benachrichtigung über eine Impression erhalten, werden die Makros ersetzt. Die URL sieht dann so aus:

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

Unterstützte Makros

Im Folgenden finden Sie Makros, die Sie in die Abfrageparameter der URL des Endpunkts für Benachrichtigungen zu Impressionen einfügen können. Diese Makros werden durch Werte ersetzt, die sich auf das erfolgreiche Gebot beziehen, zu dem eines oder mehrere Ihrer Datensegmente beigetragen haben.

Macro Beschreibung
${SR_ID} Eine eindeutige String-ID, die dem Feld SegmentRequest.segment_request_id für den entsprechenden Echtzeit-Auswahlaufruf entspricht. Dies bezieht sich auf die Segmentanfrage, auf die Sie mit einer oder mehreren Datensegment-IDs geantwortet haben, die zum erfolgreichen Gebot beigetragen haben.
${SEGMENT_IDS} Eine Liste der IDs von String-Datensegmenten, die zum erfolgreichen Gebot beigetragen haben. Die einzelnen Elemente in der Liste werden durch das Zeichen „|“ getrennt. Beispiel: Dies könnte auf eine Liste von Werten wie die folgende erweitert werden: "segmentId1|segmentId2|segmentId3" Jede Datensegment-ID, die die Liste enthält, verweist auf die Ressourcen-ID der entsprechenden curators.dataSegments-Ressource in der Marketplace API.
${AUCTION_PRICE} Ein String, der den Zuschlagspreis der Auktion darstellt. Der Preis sind die Kosten für eine einzelne Impression (CPI) in Mikrodollar. Ein RTB-Gebot von 5 $CPM würde beispielsweise dazu führen, dass das Makro ${AUCTION_PRICE} in der Impression-Benachrichtigung für die Echtzeit-Kuration zu 5.000 Mikro-USD CPI erweitert wird.
${DEAL_ID} Die ID des Deals oder Pakets, das die Auktion gewonnen hat. Es handelt sich um einen Deal oder ein Paket, das auf mindestens eine Ihrer Datensegment-IDs ausgerichtet ist. Diese können mit dem Makro ${SEGMENT_IDS} identifiziert werden.
${BUYER_SEAT_ID} Die ID des Käufersitzes, der die Impression gewonnen hat, wie vom Bieter im erfolgreichen Gebot angegeben. Käufersitze können beispielsweise Agenturen oder Werbetreibende sein.

Nächste Schritte