CID sostituisce DPID e DPUUID

Aggiornate il codice per utilizzare d_cid o d_cid_ic invece di d_dpid e d_dpuuid. Le variabili DPID e DPUUID continueranno a funzionare, ma devi considerarle obsolete. Questo include le varianti DPID e DPUUID senza d_ prefix.

DPID e DPUUID: Revisione

Il DPID e il DPUUID sono coppie chiave-valore che contengono un ID provider di dati e un ID utente. Queste coppie chiave-valore collegano gli ID del fornitore agli ID utente. Essi inviano dati durante le chiamate dell'evento, per gli eventi di sincronizzazione in ingresso e per le chiamate ID. Senza di essi, Audience Manager e altri servizi o funzionalità, non avrebbe un modo per far corrispondere e sincronizzare gli ID. Queste variabili vengono talvolta espresse con o senza il prefisso d_ come mostrato di seguito. Nota: nel codice, corsivo indica un segnaposto variabile.

Variabile Sintassi

ID provider dati (DPID)

  • d_dpid=data provider ID
  • dpid=data provider ID

ID utente univoco provider di dati (DPUUID)

  • d_dpuuid=data provider unique user ID
  • dpuuid=data provider unique user ID

Queste coppie chiave-valore funzionano ancora, ma sono obsolete. Devi aggiornare il codice per usare CID o CID_IC.

CID e CID_IC: Informazioni su

Le coppie chiave-valore CID e CID_IC sostituiscono DPID e DPUUID. Forniscono le stesse funzioni del DPID e del DPUUID, ma sono più efficienti perché includono l'ID provider di dati (o codice di integrazione) e l'ID utente in una singola coppia chiave-valore. In ogni coppia chiave-valore:

  • Il simbolo = separa la chiave dai relativi valori.
  • Il carattere ASCII non stampabile %01 separa i valori.

d_cid e d_cid_ic utilizzare la sintassi indicata di seguito. Nota: nel codice, corsivo indica un segnaposto variabile.

Variabile Sintassi

ID cliente (CID)

d_cid=data provider ID%01user ID

Codice integrazione ID cliente (CID_IC)

d_cid_ic=integration code%01user ID

Un codice di integrazione è un ID alternativo che puoi utilizzare invece dell'ID origine dati, assegnato da Audience Manager. Per configurare un codice di integrazione, vedi Crea un'origine dati.

Vedi anche variabili URL e sintassi per ID dichiarati.

NOTA

È possibile utilizzare codici di integrazione per le proprie origini dati e per le origini dati condivise globali a cui si ha accesso. Ad esempio, è possibile utilizzare i codici di integrazione quando si utilizzano le origini dati degli identificatori mobili. Utilizzate i seguenti codici di integrazione, esattamente come specificato di seguito:

  • DSID_20914 per GAID, che rappresenta i dispositivi con sistema operativo Android.
  • DSID_20915 per IDFA, che rappresenta i dispositivi con il sistema operativo iOS.

Esempi

Nella tabella seguente sono riportati alcuni esempi per tipo di evento.

Tipo evento Esempio

Evento

  • Nuova API: .../event?d_cid=123%01987...
  • Obsoleto: .../event?d_dpid=123&d_dpuuid=987...

Sincronizzazione in ingresso (IBS)

  • Nuova API: .../ibs:d_cid=123%01987...
  • Obsoleto: .../ibs:d_dpid=123&d_dpuuid=987

Genera UUID Audience Manager (ID)

  • Nuova API: .../id?d_cid=123%01987...
  • Obsoleto: .../id?d_dpid=123&d_dpuuid=987

Ogni chiamata può anche includere più coppie di valori chiave d_cid e d_cid_ic come segue:

...?d_cid=123%01456&d_cid=123%01789&d_cid_ic=543%01333...

Considerazioni importanti per i team di sviluppo

Elemento

Descrizione

Codifica URL

I team di sviluppo devono applicare la codifica URL alle seguenti variabili nella coppia chiave-valore CID:

  • user ID (dpuuid)
  • integration code

Nota: È necessario codificare l'ID utente e il codice di integrazione prima di concatenandoli in una stringa. Questo perché il carattere ASCII %01 che separa le due variabili non deve essere acquisito nella codifica URL.

La codifica URL assicura che gli ID utente e i codici di integrazione che contengono caratteri riservati o non sicuri, ad esempio, ma non limitati a, + o =, vengano trasmessi correttamente ai nostri server.

Utilizzate la tabella di codifica ASCII come riferimento.

Uso dei codici di integrazione per le origini dati condivise globali

È possibile utilizzare codici di integrazione per le proprie origini dati e per le origini dati condivise globali a cui si ha accesso. Ad esempio, è possibile utilizzare i codici di integrazione quando si utilizzano le origini dati degli identificatori mobili. Utilizzate i seguenti codici di integrazione, esattamente come specificato di seguito:

  • DSID_20914 per GAID, che rappresenta i dispositivi con sistema operativo Android.
  • DSID_20915 per IDFA, che rappresenta i dispositivi con il sistema operativo iOS.

In questa pagina