Ricevere notifiche sulle impressioni

Puoi ricevere notifiche di impressioni ogni volta che Google rileva che i tuoi segmenti di dati sono stati utilizzati in un'offerta vincente nell'asta delle offerte in tempo reale e hanno generato un'impressione. Google consiglia di integrare le notifiche di impressioni per scoprire di più su come vengono utilizzati i tuoi segmenti di dati. Contatta il tuo account manager per attivare le notifiche di impressioni.

Configurare l'endpoint delle notifiche di impressioni

Per ricevere le notifiche di impressioni, devi creare un endpoint HTTP e condividere il relativo URL con Google. Puoi impostare l'URL a cui vengono inviate le notifiche di impressioni con una delle seguenti opzioni:

  1. Imposta l'URL dell'endpoint delle notifiche di impressioni per ogni callout di selezione in tempo reale.
    • Puoi impostare dinamicamente l'URL utilizzato per le notifiche di impressioni per ogni callout di selezione in tempo reale che ricevi compilando il campo SegmentResponse.burl.
    • Per un determinato callout di selezione in tempo reale, devi impostare il campo SegmentResponse.burl per ricevere una notifica di impressioni per quel callout. Se il campo SegmentResponse.burl non è compilato, non verrà inviata alcuna notifica per quel callout, anche se il campo SegmentResponse.burl è stato impostato nei callout precedenti.
  2. Imposta un URL dell'endpoint delle notifiche di impressioni a livello di account.
    • Puoi impostare un URL dell'endpoint delle notifiche di impressioni a livello di account per il tuo account contattando il tuo account manager. Questa opzione è ideale se l'URL dell'endpoint cambia di rado.
    • Tutti i callout di selezione in tempo reale utilizzeranno l'URL delle notifiche di impressioni a livello di account che hai configurato per il tuo account, a meno che tu non sostituisca l'URL a livello di account impostando il campo SegmentResponse.burl per un singolo callout di selezione in tempo reale.

Analizzare una notifica di impressioni

Le informazioni inviate in una notifica di impressioni dipendono dalla configurazione dell'URL dell'endpoint delle notifiche di impressioni. L'URL dell'endpoint può includere parametri di query e utilizzare le macro per includere un contesto aggiuntivo su come i tuoi segmenti di dati sono stati utilizzati dall'offerta vincente che ha generato un'impressione.

Informazioni su come vengono espanse le macro

Se configuri l'URL dell'endpoint in modo che contenga uno o più parametri di query impostati su una macro, le notifiche di impressioni inviate al tuo endpoint espanderanno queste macro, sostituendole con i valori corrispondenti.

Ad esempio, potresti configurare un URL dell'endpoint delle notifiche di impressioni come il seguente:

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

Quando ricevi una notifica di impressioni, le macro vengono sostituite, quindi l'URL avrà il seguente aspetto:

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

Informazioni sulle macro supportate

Di seguito sono riportate le macro che puoi includere nei parametri di query dell'URL dell'endpoint delle notifiche di impressioni. Queste macro vengono sostituite con valori relativi all'offerta vincente a cui hanno contribuito uno o più dei tuoi segmenti di dati.

Macro Descrizione
${SR_ID} Un ID stringa univoco equivalente al campo SegmentRequest.segment_request_id per il callout di selezione in tempo reale corrispondente. Si riferisce alla richiesta di segmento a cui hai risposto con uno o più ID segmento di dati che hanno contribuito all'offerta vincente.
${SEGMENT_IDS} Un elenco di ID segmento di dati stringa che hanno contribuito all'offerta vincente. Ogni elemento dell'elenco è separato dal carattere "|". Ad esempio, questo potrebbe essere espanso in un elenco di valori come: "segmentId1|segmentId2|segmentId3" Ogni ID segmento di dati che popola l'elenco si riferisce a l'ID risorsa della risorsa curators.dataSegments corrispondente nell'API Marketplace.
${AUCTION_PRICE} Una stringa che rappresenta il prezzo vincente dell'asta. Il prezzo è il costo di una singola impressione (CPI) espresso in micro-USD. Ad esempio, un'offerta delle offerte in tempo reale di 5 $CPM comporterebbe l'espansione della macro ${AUCTION_PRICE} a 5000 micro-USD CPI nella notifica di impressioni di selezione in tempo reale.
${DEAL_ID} ID del deal o del pacchetto che ha vinto l'asta. Si tratta di un deal o di un pacchetto che ha come target uno o più ID segmento di dati, che possono essere identificati con la macro ${SEGMENT_IDS}.
${BUYER_SEAT_ID} L'ID della postazione dell'acquirente che ha vinto l'impressione, come specificato dall'offerente nell'offerta vincente. Ad esempio, le postazioni dell'acquirente possono essere agenzie o inserzionisti.

Passaggi successivi