Analizza SegmentRequest

Nella cura in tempo reale, Google invia un JSON SegmentRequest all'endpoint di cura per fornire indicatori che descrivono una o più impressioni, consentendoti di determinare i segmenti di dati applicabili per ciascuna di esse. 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 sicuri o di contesto

Quando crei un endpoint di cura in tempo reale, devi selezionare se ricevere indicatori contestuali o indicatori sicuri. I segnali che selezioni influenzano il modo in cui vengono compilate le richieste di segmento inviate al tuo endpoint, la quantità di inventario che produce richieste di segmento inviate al tuo endpoint e la 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 della piattaforma dell'app. È 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 publisher.
  • SegmentRequest.user: Descrive le scelte dell'utente in merito alle modalità di trattamento dei suoi dati personali, ad esempio con la stringa di consenso TCF.
  • SegmentRequest.device: Descrive le informazioni sul dispositivo, ad esempio la posizione geografica del dispositivo 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 il tuo 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 dei segnali sicuri è inferiore rispetto a quello degli endpoint dei segnali 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