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 contestuali o indicatori sui segmenti di pubblico

Quando crei un endpoint di selezione in tempo reale, devi selezionare se ricevere indicatori di contesto o indicatori dei segmenti di pubblico. 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

Gli indicatori 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 per la piattaforma. È possibile compilare solo uno dei campi SegmentRequest.site e SegmentRequest.app in un SegmentRequest.
  • SegmentRequest.pub: Descrive il publisher dei media che eseguono il rendering dell'impressione, ad esempio l'ID del publisher.
  • SegmentRequest.user: Descrive le scelte degli utenti su come possono essere trattati i 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 gli indicatori dei segmenti di pubblico

Gli indicatori dei segmenti di pubblico includono identificatori utente o dispositivo, nonché 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 gli indicatori dei segmenti di pubblico, riceve solo richieste di segmenti per l'inventario dei publisher che hanno scelto di condividere indicatori sicuri con il tuo account di selezione. Di conseguenza, il numero totale di impressioni idonee per essere inviate agli endpoint dei segmenti di pubblico è inferiore rispetto a quello degli endpoint dei contesti.

La logica di cura dell'endpoint deve interpretare gli indicatori dei segmenti di pubblico e 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 dei segmenti di pubblico

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

Passaggi successivi