Declared IDs declared-ids

Come declared IDs lavoro, configurazione di procedure, esempi di codice e variabili.

Declared ID Targeting declared-id-targeting

Scambia e sincronizza gli ID utente con Audience Manager da dispositivi o browser che non utilizzano o non accettano meccanismi di archiviazione persistenti, ad esempio sistemi di terze parti cookies.

Scopo di Declared ID Targeting declared-id-targeting-purpose

Alcuni browser e la maggior parte dei dispositivi mobili non accettano sistemi di terze parti cookies. Questo rende difficile conservare le informazioni sui visitatori del sito o assegnare ID persistenti. Per risolvere il problema: Audience Manager utilizza DIL per consentire il passaggio declared IDs durante una chiamata evento. Inoltre, un declared ID può fungere da ID universale che si applica allo stesso utente in tutte le soluzioni di Experience Cloud. La tabella seguente descrive il processo di targeting ID/corrispondenza:

Processo
Descrizione
Chiamata evento
Per lavorare, è necessario DIL e Servizio Adobe Experience Platform Identitysulla pagina. DIL ottiene ID dichiarati dal setVisitorID funzione fornita da Servizio Adobe Experience Platform Identity e lo trasmette a Audience Manager .
ID corrispondenza

L’Audience Manager tenta di far corrispondere l’ID del cliente e del visitatore con un ID corrispondente nel nostro sistema. Se non esiste un ID corrispondente, Audience Manager crea un nuovo ID e lo associa all’ID client e visitatore.

Nota: viene utilizzata la mappatura più recente se l’ID è mappato su più ID Audience Manager.

ID restituito
Audience Manager scrive il proprio ID sincronizzato in un cookie di prima parte (o in un altro spazio di archiviazione indirizzabile) nel dominio o nell’applicazione client.
Chiamate evento successive
Chiamate evento aggiuntive leggono l’ID dell’Audience Manager dal dominio del client e lo inviano all’Audience Manager.

Per iniziare, devi configurare il Experience Cloud Servizio ID e DIL nelle pagine del sito che si desidera utilizzare per la raccolta dati. Consulta DIL create e Variabili ID dichiarate.

Chiamate di rinuncia opt-out-calls

Il declared ID il processo rispetta le preferenze del visitatore del sito per la rinuncia a Audience Manager eseguire il targeting in base al sito web. Quando Audience Manager riceve una richiesta di rinuncia, il JSON restituito da DCS contiene il codice di errore 171, con il messaggio Encountered opt out tag, invece del Audience Manager ID utente.

  • Audience Manager può passare un declared ID rinuncia insieme a un Audience Manager UUID nel URL.
  • Il declared ID la rinuncia viene memorizzata in Profile Cache Server (PCS) per ciascun partner. Non esiste alcuna rinuncia a livello di piattaforma utilizzando declared IDs. Inoltre, Audience Manager rifiuta all’utente di uscire da quella particolare area del bordo (la rinuncia non attraversa DCS regioni).

Consulta Privacy dei dati per ulteriori informazioni sulla rinuncia alla raccolta di dati.

Declared ID Esempi di rinuncia opt-out-examples

È possibile effettuare una declared ID richieste di rinuncia con d_cid e d_cid_ic coppie chiave-valore. 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.

Rinunce con CID e CID_IC

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.
https://domain name/demoptout.jpg?d_cid=123%01987...
Un codice di integrazione e un ID utente.
https://domain name/demoptout?d_cid_ic=456%01321...
Più d_cid e d_cid_ic coppie chiave-valore.
https://domain name/demoptout?d_cid=123%01987&d_cid_ic=456%01321...

Rinunce con DPID, DPUUID, e UUID (Obsoleto)

Questi metodi continuano a funzionare, ma sono considerati obsoleti. Queste informazioni sono fornite per scopi e riferimenti legacy. Le rinunce legacy includono:

Rinuncia (obsoleto)
Esempio di codice
d_uuid solo
https://domain/demoptout.jpg?d_uuid=AAM ID
Rinuncia a livello di partner

https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID

Viene memorizzata una rinuncia a livello di partner per la mappatura più recente di questo dpid + dpuuid associarlo a un UUID AAM. Se non esiste alcuna mappatura precedente, Audience Manager controlla se la richiesta contiene un UUID AAM nel cookie e, in caso affermativo, lo utilizza per memorizzare la rinuncia. In caso contrario, Audience Manager genera un nuovo UUID AAM e memorizza la rinuncia al suo interno.

d_dpuuid + d_dpid ed esplicito d_uuid

https://domain/demoptout.jpg?d_uuid= user ID&d_dpuuid= data provider's user ID&d_dpid=data provider ID

d_uuid ha sempre la precedenza. Se il dpid + dpuuid viene mappato su un altro AAM UUID, la rinuncia viene memorizzata sotto l’AAM UUID passato nella richiesta ( d_uuid ).

Variabili e sintassi per Declared IDs variables-and-syntax

Nella tabella seguente sono elencate le coppie chiave-valore che passano nel Audience Manager ID del provider dati e ID utente o 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:

  • Il = separa la chiave dai valori correlati.
  • La non stampa ASCII carattere %01 separa i valori.
Variabile
Descrizione
d_cid =data provider ID %01user ID
Contiene un ID provider dati e un ID utente univoco associato in una singola coppia chiave-valore. d_cid sostituisce d_dpid e d_dpuuid , considerati obsoleti, ma ancora supportati. Consulta CID Replaces DPID and DPUUID.
d_cid_ic =integration code %01user ID
Contiene un codice di integrazione e un ID utente univoco associato in una singola coppia chiave-valore. d_cid_ic sostituisce d_dpid e d_dpuuid , che sono obsoleti, ma sono ancora supportati. Consulta CID Replaces DPID and DPUUID.

Chiamate evento di esempio sample-event-calls

Considerate queste coppie chiave-valore e la loro sintassi richiesta, dovrai effettuare chiamate evento come mostrato di seguito.

La chiamata dell'evento include
Esempio di codice
Un ID provider di dati e un ID utente.
https://domain name/event?d_cid=123%01987...
Un codice di integrazione e un ID utente.
https://domain name/event?d_cid_ic=456%01321...
Più d_cid e d_cid_ic coppie chiave-valore.
https://domain name/event?d_cid=123%01987&d_cid_ic=456%01321...

Declared ID Variabili declared-id-variables

Descrive le variabili di configurazione utilizzate per trasmettere declared IDs da a DIL a Audience Manager.

DIL utilizza Adobe Experience Platform Identity Service da superare Declared IDs dil-id-service-pass-declared-ids

Se utilizzato con Servizio Adobe Experience Platform Identity, non è più necessario trasmettere declared IDs con il deprecato dpid e dpuuid variabili. Invece, le versioni correnti di DIL affidarsi a visitorService funzione per ottenere declared IDs dal setCustomerIDs funzione in Adobe Experience Platform Identity Service. Per ulteriori informazioni, consulta ID cliente e stati di autenticazione. Chiameresti visitorService in DIL.create come mostrato di seguito.

var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

In namespace coppia chiave-valore, MCORG è il tuo Experience Cloud ID organizzazione. Se non disponi di questo ID, puoi trovarlo in Administration sezione del Experience Cloud dashboard. Per visualizzare questo dashboard sono necessarie le autorizzazioni di amministratore. Consulta Amministrazione: servizi core.

Funzioni obsolete deprecated-functions

Con le versioni più recenti di DIL (6.2+), non è necessario utilizzare queste coppie chiave-valore per passare declared IDs. È perché… DIL ora si basa su visitorService come mostrato nell’esempio di codice precedente. Questa funzione ottiene declared IDs dal Adobe Experience Platform Identity Service. Tuttavia, stiamo facendo riferimento a queste variabili qui per scopi storici e legacy. Per un esempio di configurazione, consulta il codice seguente DIL.create per ottenere un declared ID dal Visitor ID Service.
La tabella seguente descrive le variabili legacy utilizzate da declaredId oggetto:

Nome
Tipo
Descrizione
dpid
Stringa
ID partner dati assegnato dall’Audience Manager.
dpuuid
Stringa
ID univoco del fornitore di dati per l'utente.

DPID e DPUUID

Audience Manager confronta e confronta il DPID e DPUUID a un ID utente corrispondente nel nostro sistema. Se non esiste un ID, Audience Manager crea un nuovo ID utente e lo sincronizza con DPID/DPUUID combinazione. Una volta Audience Manager corrisponde o crea un ID utente (il UUID) restituisce tale ID nella JSON risposta al cookie nel dominio del client (prime parti) cookie) o altro tipo di storage locale.

Chiama questa funzione quando utilizzi DIL versione 6.1 o precedente. Tuttavia, questa funzione è stata rimossa a favore della nuova versione che ottiene declared IDs dal Adobe Experience Platform Identity Service.

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });
NOTE
Devi sviluppare in modo programmatico il codice che fornisce i valori ID per il d_dpuuid e d_dpid tasti.

Passa ID dopo DIL Istanze

NOTE
Se si crea un API chiama con un diverso declaredID nuova combinazione verrà utilizzata solo per tale chiamata. Ulteriori chiamate regolari di evento utilizzeranno l’originale DIL.create declaredID combinazione.
DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

Esempi di richieste/risposte request-response-examples

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) che viene scritto su un cookie di prime parti nel dominio della pagina.

myCallback({
...
   "uuid":"abc123"
})

Non eseguire il targeting delle chiamate e delle chiamate di rinuncia do-not-target

Il declared ID il processo rispetta le preferenze del visitatore del sito per la rinuncia a Audience Manager eseguire il targeting in base al sito web. Quando Audience Manager riceve una richiesta di rinuncia, il DCS restituisce un valore vuoto JSON oggetto invece del Audience Manager ID utente.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695