DocumentazioneGuida del servizio Identity

Integrazione diretta con il servizio Experience Cloud Identity direct-integration-with-the-experience-cloud-id-service

Last update: Wed May 24 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Developer
  • User
  • Admin
  • Leader

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 section-a4754afec5ad40b6be00d6f1011d68bb

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 section-26302b8851704888b6f8e6b2071bcdb0

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

Risposta di esempio section-89bc103b3e9e4a8b98e74c32897b1200

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 section-4a9912b545364dc4acad4f1ea5ec641d

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).
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a