Show Menu
ARGOMENTI×

ID dichiarati

Funzionamento degli ID dichiarati, configurazione di procedure, esempi di codice e variabili.

Targeting degli ID dichiarati

Scambiate e sincronizzate gli ID utente con Audience Manager da dispositivi o browser che non utilizzano o accettano meccanismi di memorizzazione persistenti, ad esempio cookie di terze parti.

Finalità del targeting con ID dichiarato

Alcuni browser e la maggior parte dei dispositivi mobili non accettano i cookie di terze parti. Ciò rende difficile conservare le informazioni sui visitatori del sito o assegnare ID persistenti. Per risolvere questo problema, Audience Manager utilizza DIL per consentirvi di passare declared IDs a una chiamata dell'evento. Inoltre, un declared ID può fungere da ID universale applicabile allo stesso utente in tutte le soluzioni del Experience Cloud. La tabella seguente descrive il processo di targeting degli ID/corrispondenza:
Processo Descrizione
Chiamata evento
Per funzionare, hai bisogno di DIL e del codice del servizio Experience Cloud ID sulla pagina. DIL ottiene ID dichiarati dalla funzione setVisitorID fornita dal servizio Experience Cloud ID e li trasmette ad Audience Manager .
ID corrispondenza
Audience Manager tenta di far corrispondere l'ID cliente e visitatore con un ID corrispondente nel nostro sistema. Se non esiste un ID corrispondente, Audience Manager crea un nuovo ID e lo associa al client e all’ID visitatore.
Nota: La mappatura più recente viene utilizzata se l'ID viene mappato su più ID Audience Manager.
ID restituzione
Audience Manager scrive il proprio ID sincronizzato su un cookie di prima parte (o su altro spazio di memorizzazione indirizzabile) nel dominio client o nell’applicazione.
Chiamate Di Evento Successive
Altre chiamate di evento leggono l’ID Audience Manager dal dominio del client e lo inviano ad Audience Manager.
Per iniziare, devi configurare il servizio Experience Cloud ID e DIL le pagine del tuo sito che desideri utilizzare per la raccolta dati. Consulta Variabili ID DIL create e dichiarate .

Chiamate di rifiuto

Il declared ID processo rispetta le preferenze dei visitatori del sito per rinunciare al targeting di Audience Manager dal sito Web. Quando Audience Manager riceve una richiesta di rifiuto, il JSON restituito dal DCS feed contiene il codice di errore 171, con il messaggio "Incontrato tag di rifiuto", invece dell’ID utente di Audience Manager.
  • Audience Manager può trasmettere una declared ID rinuncia insieme a Audience Manager UUID nella URL.
  • Il declared ID rifiuto viene memorizzato nel server cache del profilo [(PCS) su base individuale. Non esiste un rifiuto a livello di piattaforma tramite declared IDs. Inoltre, Audience Manager esclude l'utente da quella particolare area sul margine (la rinuncia non attraversa DCS aree geografiche).
Consulta Privacy dei dati per ulteriori informazioni sul rifiuto della raccolta dei dati.

Esempi di rifiuto ID dichiarati

Potete effettuare una richiesta di declared ID rifiuto con le coppie d_cid e d_cid_ic chiave-valore. I parametri legacy come d_dpid e d_dpuuid funzionano comunque, ma sono considerati obsoleti. Consultate CID sostituisce DPID e DPUUID Negli esempi, il corsivo indica un segnaposto variabile.

Consenso con CID e CID_IC

Per una descrizione e una sintassi, consultate Variabili URL e sintassi per ID dichiarati.
Rifiuto tramite Esempio di codice
ID provider di dati e ID utente.
https:// nome dominio/demoptout.jpg?d_cid=123%01987...
Un codice di integrazione e un ID utente.
https:// nome di dominio/demoptout?d_cid_ic=456%01321...
Più coppie d_cid e d_cid_ic chiave-valore.
https:// nome di dominio/demoptout?d_cid=123%01987&d_cid_ic=456%01321...

Consenso con DPID, DPUUID e UUID (obsoleto)

Questi metodi funzionano ancora ma sono considerati obsoleti. Queste informazioni sono fornite per scopi e riferimenti legacy. Le opzioni di rifiuto precedenti includono:
Rifiuto (obsoleto) Esempio di codice
d_uuid
https:// dominio /demoptout.jpg?d_uuid=ID AAM
Rinuncia a livello di partner
https://demoptout.jpg?d_dpuuid= utente ID&d_dpid= ID del provider di dati
Viene memorizzata una rinuncia a livello di partner per la mappatura più recente della coppia dpid + dpuuid a un UUID AAM. Se in precedenza non esiste alcuna mappatura, Audience Manager verifica se la richiesta contiene un UUID AAM nel cookie e, in caso contrario, lo utilizza per memorizzare la rinuncia. In caso contrario, Audience Manager genera un nuovo UUID AAM e memorizza sotto di esso il rifiuto.
d_dpuuid + d_dpid ed esplicita d_uuid
https:// dominio /demoptout.jpg?d_uuid= ID utente e d_dpuuid= ID utente del provider di dati e d_dpid=ID del provider di dati
d_uuid ha sempre la precedenza. Se la combinazione dpid + dpuuid viene mappata su un altro UUID AAM, la rinuncia viene memorizzata nell’UUID AAM passato nella richiesta ( d_uuid ).

Variabili e sintassi per ID dichiarati

Nella tabella seguente sono elencate le coppie chiave-valore che passano agli ID del provider di Audience Manager dati e agli ID utente o ai codici di integrazione, se utilizzati. Note, italics indicates a variable placeholder. Sono stati aggiunti spazi per agevolare la lettura.
In ogni coppia chiave-valore:
  • Il = simbolo separa la chiave dai relativi valori.
  • Il ASCII carattere non stampabile %01 separa i valori.
Variabile Descrizione
d_cid = ID provider dati %01 ID utente
Contiene un ID provider di dati e un ID utente univoco associato in una coppia chiave-valore singola. d_cid sostituisce d_dpid e d_dpuuid , che sono considerati obsoleti, ma sono comunque supportati. Consultate CID sostituisce DPID e DPUUID
d_cid_ic = codice di integrazione %01 ID utente
Contiene un codice di integrazione e un ID utente univoco associato in una coppia chiave-valore singola. d_cid_ic sostituisce d_dpid e d_dpuuid , che sono obsoleti, ma sono ancora supportati. Consultate CID sostituisce DPID e DPUUID

Chiamate evento di esempio

Considerate queste coppie chiave-valore e la sintassi richiesta, effettuerete le chiamate evento come mostrato di seguito.
La chiamata dell'evento include Esempio di codice
ID provider di dati e ID utente.
https:// nome di dominio/evento?d_cid=123%01987...
Un codice di integrazione e un ID utente.
https:// nome /evento?d_cid_ic=456%01321...
Più coppie d_cid e d_cid_ic chiave-valore.
https:// nome /evento?d_cid=123%01987&d_cid_ic=456%01321...

Variabili ID dichiarate

Descrive le variabili di configurazione utilizzate per trasmettere gli ID dichiarati DIL a Audience Manager.

DIL usa il servizio Experience Cloud ID per trasmettere gli ID dichiarati

Quando viene utilizzato con il servizio Experience Cloud ID, non è più necessario passare declared IDs con le variabili dpid e dpuuid obsolete. Al contrario, le versioni correnti di DIL si basano sulla visitorService funzione per ottenere il declared IDs dalla setCustomerIDs funzione in Experience Cloud ID Service. For more information, see Customer IDs and Authentication States . Puoi effettuare una chiamata visitorService in DIL.create base a quanto indicato di seguito.
var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

Nella coppia chiave-valore namespace è il tuo MCORG Experience Cloud ID organizzazione. Se non disponete di questo ID, potete trovarlo nella Administration sezione del Experience Cloud dashboard. Per visualizzare questo dashboard è necessario disporre delle autorizzazioni di amministratore. See Administration: Core Services .

Funzioni obsolete

Con le versioni più recenti di DIL (6.2+), non è necessario utilizzare queste coppie chiave-valore per passare declared IDs. Questo perché DIL ora si basa sulla visitorService funzione mostrata nel codice di esempio sopra. Questa funzione viene declared IDs dal Experience Cloud ID Service. Tuttavia, stiamo facendo riferimento a queste variabili per scopi storici e legacy. Consulta il codice seguente per un esempio di come configurare DIL.create per ottenere un declared ID da Visitor ID Service. La tabella seguente descrive le variabili legacy utilizzate dall' declaredId oggetto:
Nome Tipo Descrizione
dpid Stringa
ID partner dati assegnato da Audience Manager.
dpuuid Stringa
ID univoco del fornitore di dati per l'utente.

DPID e DPUUID

Audience Manager confronta e corrisponde al combinato DPID e DPUUID a un ID utente corrispondente nel nostro sistema. Se un ID non esiste, Audience Manager crea un nuovo ID utente e lo sincronizza con la DPID/DPUUID combinazione. Quando Audience Manager corrisponde o crea un ID utente (il UUID ), restituisce tale ID nella JSON risposta al cookie nel dominio del client (cookie di prima parte) o in altro archivio locale.
Chiama questa funzione quando utilizzi DIL v6.1 o versioni precedenti. Tuttavia, questa funzione è stata sconsigliata a favore della nuova versione che viene declared IDs dalla Experience Cloud ID Service.
DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

Nota: devi sviluppare a livello di programmazione il codice che fornisce i valori ID per le chiavi d_dpuuid e d_dpid .

Passa gli ID dopo le istanze DIL

Se effettui una API chiamata con una declaredID combinazione diversa, la nuova combinazione verrà utilizzata solo per quella chiamata. Ulteriori chiamate di eventi regolari utilizzeranno la DIL.create combinazione originale declaredID .
DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

Esempi di richieste/risposte

La richiesta invia un provider di dati e un ID utente ad Audience Manager:
https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678

La risposta restituisce l’ID Audience Manager (ad esempio, UUID ) scritto in un cookie di prima parte nel dominio della pagina.
myCallback({
...
   "uuid":"abc123"
})

Non eseguire il targeting e non eseguire il rifiuto delle chiamate

Il declared ID processo rispetta le preferenze dei visitatori del sito per rinunciare al targeting di Audience Manager dal sito Web. Quando Audience Manager riceve una richiesta di rifiuto, DCS restituisce un JSON oggetto vuoto invece dell’ID utente di Audience Manager.