Declared IDs declared-ids

Funzionamento di declared IDs, impostazione di procedure, esempi di codice e variabili.

Targeting Declared ID declared-id-targeting

Scambia e sincronizza 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.

Scopo del targeting Declared ID declared-id-targeting-purpose

Alcuni browser e la maggior parte dei dispositivi mobili non accettano cookies di terzi. 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 di declared IDs a 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 funzionare, sono necessari DIL e il codice di Adobe Experience Platform Identity Service nella pagina. DIL ottiene ID dichiarati dalla funzione setVisitorID fornita dal servizio Adobe Experience Platform Identity di 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 servizio ID Experience Cloud e DIL nelle pagine del sito che desideri utilizzare per la raccolta dati. Consulta DIL create e Declared ID Variables.

Chiamate di rinuncia opt-out-calls

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

  • Audience Manager può passare una rinuncia a declared ID insieme a un Audience Manager UUID in URL.
  • La rinuncia a declared ID è archiviata in Profile Cache Server (PCS) in base al partner. Non esiste alcuna rinuncia a livello di piattaforma utilizzando declared IDs. Inoltre, Audience Manager rinuncia all'utente da quella particolare area sul server Edge di (la rinuncia non attraversa DCS aree).

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

Declared ID esempi di rinuncia opt-out-examples

È possibile effettuare una declared ID richiesta di rinuncia 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.

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ù coppie chiave-valore d_cid e d_cid_ic .
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
Solo d_uuid
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 archiviata una rinuncia a livello di partner per la mappatura più recente di questa coppia dpid + dpuuid su 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 e d_uuid esplicito

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 la combinazione dpid + dpuuid è mappata a un altro UUID AAM, la rinuncia viene memorizzata nell'UUID AAM passato nella richiesta ( d_uuid ).

Variabili e sintassi per Declared IDs variables-and-syntax

Nella tabella seguente sono elencate le coppie chiave-valore passate nell'ID provider dati Audience Manager e negli ID utente o nei 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 simbolo = separa la chiave dai valori correlati.
  • Il carattere %01 ASCII non stampabile 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. Vedere CID sostituisce DPID e 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 ancora supportati. Vedere CID sostituisce DPID e 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ù coppie chiave-valore d_cid e d_cid_ic .
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 passare da declared IDs a Audience Manager. tramite DIL

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

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. Chiameresti 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 è l'ID organizzazione Experience Cloud. Se non disponi di questo ID, puoi trovarlo nella sezione Administration del dashboard Experience Cloud. Per visualizzare questo dashboard sono necessarie le autorizzazioni di amministratore. Vedere Amministrazione: servizi principali.

Funzioni obsolete deprecated-functions

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 funzione visitorService mostrata nell'esempio di codice precedente. Questa funzione ottiene declared IDs da Adobe Experience Platform Identity Service. Tuttavia, stiamo facendo riferimento a queste variabili qui per scopi storici e legacy. Vedere il codice seguente per un esempio di configurazione di DIL.create per ottenere un declared ID da Visitor ID Service.
Nella tabella seguente vengono descritte le variabili legacy utilizzate dall'oggetto declaredId:

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 DPID e DPUUID combinati con 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 (UUID), restituisce tale ID nella risposta JSON a cookie nel dominio del client (prime parti cookie) o in un altro archivio locale.

Chiamare questa funzione quando si utilizza DIL v6.1 o versione precedente. Questa funzione è stata tuttavia 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
    }
 });
NOTE
È necessario sviluppare a livello di programmazione il codice che fornisce i valori ID per le chiavi d_dpuuid e d_dpid.

Passa Gli ID Dopo DIL Istanze

NOTE
Se effettui una chiamata API con una diversa combinazione di declaredID, la nuova combinazione verrà utilizzata solo per tale chiamata. Per ulteriori chiamate di evento regolari verrà utilizzata la combinazione originale di DIL.create declaredID.
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) scritto in 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 processo declared ID rispetta le preferenze del visitatore del sito per la rinuncia al targeting di Audience Manager da parte del sito Web. Quando Audience Manager riceve una richiesta di rinuncia, DCS restituisce un oggetto JSON vuoto invece dell'ID utente Audience Manager.

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