Show Menu
ARGOMENTI×

Integrazione diretta con il servizio Experience Cloud Identity

Questa implementazione permette ai clienti di usare il servizio ID su dispositivi che non possono accettare o lavorare con il nostro codice JavaScript o SDK. Tra questi dispositivi sono incluse consolle di gioco, smart TV o altri apparecchi dotati di Internet. Fai riferimento a questa sezione per sintassi, esempi di codice e definizioni.

Sintassi

I dispositivi che non possono usare le librerie di codici VisitorAPI.js o SDK possono effettuare chiamate dirette ai server di raccolta dati (DCS) usati dal servizio ID. A tal fine, effettuerai una chiamata dpm.demdex.net formulando la tua richiesta come mostrato di seguito. Il corsivo indica un segnaposto variabile.
In questo esempio di sintassi, il d_ prefisso identifica le coppie chiave-valore nella chiamata come variabile a livello di sistema. Puoi trasmettere una serie di d_ parametri al servizio ID, ma fai particolare attenzione alle coppie chiave-valore mostrate nel codice seguente. Per ulteriori informazioni su altre variabili, consulta Attributi supportati per le chiamate API DCS .
Il servizio ID supporta le chiamate HTTP e HTTPS. Utilizza HTTPS per trasmettere dati da una pagina protetta.

Richiesta di esempio

L'aspetto della tua richiesta potrebbe essere simile all'esempio mostrato di seguito. Le variabili lunghe sono state abbreviate.

Risposta di esempio

Il servizio ID restituisce i dati in un oggetto JSON come mostrato di seguito. La tua risposta potrebbe essere diversa.
{
     "d_mid":"12345",
     "dcs_region":"6",
     "id_sync_ttl":"604800",
     "d_blob":"wxyz5432"
}

Parametri di richiesta e risposta definiti

Parametri di richiesta
Parametro Descrizione
dpm.demdex.net
Un dominio legacy controllato da Adobe . Vedi Informazioni sulle chiamate al dominio demdex .
d_mid
L'ID visitatore Experience Cloud. Consulta Cookie e il servizio Experience Cloud Identity .
d_orgid
L'ID organizzazione Experience Cloud. Per maggiori informazioni su come trovare questo ID vedere, Requisiti del servizio Experience Cloud Identity .
d_cid
Un parametro facoltativo che trasmette l'ID del fornitore dati (DPID), l'ID utente univoco (DPUUID) e un ID dello stato di autenticazione al servizio ID. Come mostrato nell'esempio di codice, separata il DPID e il DPUUID con il carattere di controllo non stampabile, %01 .
DPID e DPUUID
Nel parametro d_cid , assegna ogni combinazione di DPID e DPUUID allo stesso parametro d_cid . Ciò ti consente di restituire set di ID multipli in un'unica richiesta. Inoltre, separa il DPID, il DPUUID e il flag di autenticazione opzionale con il carattere di controllo non stampabile, %01 . Negli esempi seguenti, gli ID del fornitore e dell'utente sono in grassetto .
  • Sintassi: ...d_cid=DPID%01DPUUID%01authentication state...
  • Esempio: ...d_cid=123%01456%011...
Stato di autenticazione
Questo è un ID opzionale nel parametro d_cid . Espresso sotto forma di numero intero, identifica gli utenti a seconda del loro stato di autenticazione come mostrato di seguito:
  • 0 (sconosciuto)
  • 1 (autenticato)
  • 2 (disconnesso)
Per specificare uno stato di autenticazione, imposta questo flag dopo la variabile ID utente (UUID). Separa il UUID e il flag di autenticazione con il carattere di controllo non stampabile, %01 . Negli esempi seguenti, gli ID di autenticazione sono in grassetto .
Sintassi: ...d_cid=DPID%01DPUUID%01authentication state
Esempi:
  • Sconosciuto: ...d_cid=123%01456%010...
  • Autenticato: ...d_cid=123%01456%011...
  • Disconnesso: ...d_cid=123%01456%012...
dcs_region
Il servizio ID è un sistema distribuito geograficamente e bilanciato in base al carico. L'ID identifica la regione del centro dati che gestisce la chiamata. Consulta ID regioni DCS, posizioni e nomi host .
d_cb
(Facoltativo) Un parametro di callback che ti permette di eseguire una funzione JavaScript nel corpo della richiesta.
d_blob
Un pezzo crittografato di metadati JavaScript. I vincoli di dimensione limitano il blob a un massimo di 512 byte.
d_ver
Obbligatorio. Questo imposta il numero della versione API. Lascialo impostato come d_ver=2 .
Parametri di risposta
Alcuni parametri di risposta fanno parte della richiesta e sono stati definiti nella sezione precedente.
Parametro Descrizione
id_sync_ttl
L'intervallo di ri-sincronizzazione, specificato in secondi. L’intervallo predefinito è di 604.800 secondi (7 giorni).