Analizza SegmentRequest

Nella selezione in tempo reale, Google invia un JSON SegmentRequest all'endpoint di selezione per fornire indicatori che descrivono una o più impressioni, consentendoti di determinare i segmenti di dati applicabili a ciascuna. Questa guida illustra lo sviluppo della logica di cura che gestisce SegmentRequest.

Utilizzare la codifica gzip

Google utilizza la codifica gzip quando invia un SegmentRequest al tuo endpoint. Il tuo endpoint deve essere in grado di ricevere e rispondere con la codifica gzip.

Selezione con endpoint di indicatori di contesto o indicatori sicuri

Quando crei un endpoint di Real-time Curation, devi selezionare se ricevere indicatori contestuali o indicatori sicuri. I segnali che selezioni influiscono sul modo in cui vengono compilate le richieste di segmenti inviate al tuo endpoint, sulla quantità di inventario che produce richieste di segmenti inviate al tuo endpoint e sulla logica di cura utilizzata nell'integrazione.

Utilizzare gli indicatori contestuali

I segnali contestuali includono informazioni sull'editore, sul dispositivo e sull'utente che descrivono l'origine dell'impressione. Il seguente elenco descrive i segnali disponibili:

  • SegmentRequest.site: Descrive il sito web che esegue il rendering dell'impressione, ad esempio l'URL del sito. È possibile compilare solo uno dei campi SegmentRequest.site e SegmentRequest.app in un SegmentRequest.
  • SegmentRequest.app: Descrive l'app che esegue il rendering dell'impressione, ad esempio l'identificatore dell'applicazione specifico della piattaforma. È possibile compilare solo uno dei campi SegmentRequest.site e SegmentRequest.app in un SegmentRequest.
  • SegmentRequest.pub: Descrive il publisher dei media che generano l'impressione, ad esempio l'ID publisher.
  • SegmentRequest.user: Descrive le scelte degli utenti in merito al trattamento dei loro dati personali; ad esempio, con la stringa del consenso TCF.
  • SegmentRequest.device: Descrive le informazioni sul dispositivo, ad esempio la posizione geografica con una precisione a livello di città.

Puoi utilizzare gli indicatori contestuali per implementare una logica di cura che possa determinare i segmenti di dati applicabili da restituire in SegmentResponse.

Utilizzare indicatori sicuri

Gli indicatori sicuri sono dati creati dal publisher che ha scelto di condividere con uno o più partner. Vengono offuscati prima di essere condivisi con Google nella richiesta di annuncio e in Real-time Curation vengono visualizzati in formato offuscato in SegmentRequest.user.eids.uids.id.

Se l'endpoint è configurato per utilizzare indicatori sicuri, riceverà solo richieste di segmenti per l'inventario dei publisher che hanno scelto di condividere indicatori sicuri con il tuo account di cura. Di conseguenza, il numero totale di impressioni idonee per l'invio agli endpoint degli indicatori sicuri è inferiore rispetto a quello degli endpoint degli indicatori contestuali.

La logica di cura dell'endpoint deve interpretare l'indicatore sicuro e utilizzarlo per determinare i segmenti di dati applicabili da restituire in SegmentResponse.

Esempi di SegmentRequest

Endpoint di cura in tempo reale dell'indicatore contestuale

{
  "site":{
    "page":"https://dfpgpt.appspot.com/smd/"
  },
  "pub":{
    "id":"pub-1234567890987654"
  },
  "device":{
    "geo":{
      "country":"US",
        "metro":"501"
      }
    }
  }
}

Endpoint di cura in tempo reale dell'indicatore sicuro

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

Passaggi successivi