Funzionamento di declared IDs, impostazione di procedure, esempi di codice e variabili.
Scambiare e sincronizzare gli ID utente con Audience Manager da dispositivi o browser che non utilizzano o accettano meccanismi di archiviazione persistenti, ad esempio cookies di terze parti.
Alcuni browser e la maggior parte dei dispositivi mobili non accettano cookies di terze parti. Questo rende difficile conservare le informazioni sui visitatori del sito o assegnare ID persistenti. Per risolvere questo problema, Audience Manager utilizza DIL per consentire 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 di Experience Cloud. La tabella seguente descrive il processo di targeting o di corrispondenza degli ID:
Processo | Descrizione |
---|---|
Chiamata evento | Per funzionare, è necessario DIL e il codice del servizio Adobe Experience Platform Identity sulla pagina. DIL ottiene gli ID dichiarati dalla |
ID corrispondenza | Audience Manager tenta di far corrispondere l’ID client 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 è associato a più di un ID Audience Manager. |
ID mittente | Audience Manager scrive il proprio ID sincronizzato in un cookie di prima parte (o altro spazio di archiviazione indirizzabile) nel dominio o nell’applicazione client. |
Chiamate evento successive | Altre chiamate 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 tra le pagine del sito che desideri utilizzare per la raccolta dei dati. Consulta DIL create e Declared ID Variables.
Il processo declared ID rispetta le preferenze dei visitatori del sito per rinunciare al targeting Audience Manager da parte del sito web. Quando Audience Manager riceve una richiesta di rinuncia, la JSON restituita da DCS contiene il codice di errore 171, con il messaggio Encountered opt out tag
, invece dell' Audience Manager ID utente.
Per ulteriori informazioni su come rinunciare alla raccolta di dati, consulta Privacy dei dati .
Puoi effettuare una richiesta di rinuncia declared ID con le coppie chiave-valore d_cid
e d_cid_ic
. I parametri legacy come d_dpid
e d_dpuuid
funzionano comunque, ma sono considerati obsoleti. Consulta CID Replaces DPID and DPUUID. Negli esempi, il corsivo indica un segnaposto variabile.
Per una descrizione e una sintassi, consulta URL Variables and Syntax for Declared IDs.
Rinuncia tramite | Esempio di codice |
---|---|
Un ID provider di dati e un ID utente. |
|
Un codice di integrazione e un ID utente. |
|
Più coppie chiave-valore |
|
Questi metodi funzionano ancora ma sono considerati obsoleti. Queste informazioni sono fornite per scopi e riferimenti precedenti. Le rinunce legacy includono:
Rinuncia (obsoleta) | Esempio di codice |
---|---|
|
|
Rinuncia a livello di partner |
Viene memorizzata una rinuncia a livello di partner per la mappatura più recente della coppia |
|
|
Nella tabella seguente sono elencate le coppie chiave-valore che passano l’ Audience Manager ID del provider di dati e gli ID utente o i codici di integrazione, se utilizzati. Nota: corsivo indica un segnaposto variabile. Sono stati aggiunti degli spazi per facilitarne la lettura.
In ogni coppia chiave-valore:
=
separa la chiave dai relativi valori correlati.%01
separa i valori.Variabile | Descrizione |
---|---|
|
Contiene un ID provider di dati e un ID utente univoco associato in una singola coppia chiave-valore. |
|
Contiene un codice di integrazione e un ID utente univoco associato in una singola coppia chiave-valore. |
Considerate queste coppie chiave-valore e la relativa sintassi richiesta, effettuerai chiamate evento come mostrato di seguito.
Include nella chiamata dell'evento | Esempio di codice |
---|---|
Un ID provider di dati e un ID utente. |
|
Un codice di integrazione e un ID utente. |
|
Più coppie chiave-valore |
|
Descrive le variabili di configurazione utilizzate per passare da declared IDs a DIL a Audience Manager.
Se utilizzato con il servizio Adobe Experience Platform Identity, non è più necessario passare declared IDs con le variabili dpid
e dpuuid
obsolete. Le versioni correnti di DIL si basano invece sulla funzione visitorService
per ottenere declared IDs dalla funzione setCustomerIDs
in Adobe Experience Platform Identity Service. Per ulteriori informazioni, consulta ID cliente e stati di autenticazione. Dovresti chiamare visitorService
in DIL.create
come mostrato di seguito.
var vDil = DIL.create({
partner:"partner name",
visitorService:{
namespace:"INSERT-MCORG-ID-HERE"
}
});
Nella coppia chiave-valore namespace
, MCORG
è il tuo Experience Cloud ID organizzazione. Se non disponi di questo ID, puoi trovarlo nella sezione Administration del dashboard Experience Cloud. Per visualizzare questo dashboard è necessario disporre delle autorizzazioni di amministratore. Consulta Amministrazione: Servizi di base.
Con le versioni più recenti di DIL (6.2+), non è necessario utilizzare queste coppie chiave-valore per passare in declared IDs. Questo perché DIL ora si basa sulla funzione visitorService
mostrata nell'esempio di codice riportato sopra. Questa funzione ottiene declared IDs da Adobe Experience Platform Identity Service. Tuttavia, stiamo facendo riferimento a queste variabili per scopi storici e precedenti. Vedi 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'oggetto declaredId
:
Nome | Tipo | Descrizione |
---|---|---|
dpid |
Stringa | ID del partner dati assegnato dall’Audience Manager. |
dpuuid |
Stringa | ID univoco del fornitore di dati per l'utente. |
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 combinazione DPID/DPUUID
. Una volta che Audience Manager corrisponde o crea un ID utente (il UUID
), restituisce tale ID nella risposta JSON al cookie nel dominio del client (prima parte cookie) o in un altro archivio locale.
Chiama questa funzione quando utilizzi DIL v6.1 o versioni precedenti. Tuttavia, questa funzione è stata rimossa a favore della nuova versione che ottiene declared IDs da Adobe Experience Platform Identity Service.
DIL.create({
partner : "partner name",
declaredId : {
dpuuid : dpuuid,
DPID : dpid
}
});
Devi sviluppare programmaticamente il codice che fornisce i valori ID per le chiavi d_dpuuid
e d_dpid
.
Se effettui una chiamata API con una combinazione diversa declaredID
, la nuova combinazione verrà utilizzata solo per quella chiamata. Ulteriori chiamate regolari agli eventi utilizzeranno la combinazione originale DIL.create
declaredID
.
DIL.getDil('partner name').api.signals({...}).declaredId({
dpuuid : dpuuid
dpid : dpid
}).submit();
La richiesta invia un provider di dati e un ID utente a 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"
})
Il processo declared ID rispetta le preferenze dei visitatori del sito per rinunciare al targeting Audience Manager da parte del sito web. Quando Audience Manager riceve una richiesta di rinuncia, DCS restituisce un oggetto JSON vuoto invece dell’ Audience Manager ID utente.