Continua qui per informazioni su come richiedere una risposta DCS in una chiamata /event
. Questa sezione include un esempio di risposta e le definizioni per gli elementi dati comuni in una risposta.
Prima di esaminare questo contenuto, consulta Inviare dati al DCS.
La richiesta DCS deve includere d_rtbd=json
se si desidera ricevere una risposta da DCS. Se ometti questo parametro, il valore DCS non restituisce dati. Una chiamata di base a DCS per richiedere i dati utilizza questa sintassi:
https://domain_alias.demdex.net/event?key1=val1&key2=val2&d_dst=1&d_rtbd=json&d_cb=callback
Ricorda che dalla documentazione Invia dati a DCS, l'azienda fittizia Acme, Inc. ha effettuato questa chiamata:
https://acme_aam_domain.demdex.net/event?videoTypeID=2&data=moarData&d_dst=1&d_rtbd=json&d_cb=acme_callback
Poiché questa chiamata include il parametro di risposta richiesto, l’ DCS ha inviato nuovamente l’oggetto JSON mostrato di seguito. Il tuo può essere simile o più complesso.
{
"stuff": [],
"uuid": "22920112968019678612904394744954398990",
"dcs_region": 7,
"tid": "31ZpxW5bQGc="
}
La tabella seguente elenca e definisce i parametri più comuni che è possibile visualizzare in una risposta da DCS. Ciò si applica alle chiamate evento o ad altre query DCS API che restituiscono dati.
Parametro | Descrizione |
---|---|
c |
URL impostato come destinazione URL. |
cn |
Nome o ID impostato nel campo del nome cookie di una destinazione cookie. |
cv |
I valori inviati alla destinazione definita dal parametro di destinazione "cn":"". |
dcs_region |
Le chiamate DCS server-to-server. |
dests |
Questo oggetto contiene informazioni per tutte le destinazioni URL configurate nell'interfaccia utente. L’elenco di questo oggetto è dinamico in base alle azioni dell’utente. |
dmn |
Si tratta del dominio specificato nel campo Dominio cookie per una destinazione cookie. Consulta Impostazioni facoltative per le destinazioni cookie. Per le integrazioni da server a server si consiglia di utilizzare un dominio come aam-api.com . |
e |
L’URL protetto impostato in una destinazione URL. |
stuff |
Questo oggetto contiene informazioni per tutte le destinazioni dei cookie. L’elenco di questo oggetto è dinamico in base alle azioni dell’utente. |
tid |
ID transazione, ID univoco di 12 caratteri utilizzato a scopo di debug. Ogni chiamata /evento al DCS riceve un tag a cui è possibile fare riferimento nelle richieste di supporto per una risposta migliore e più rapida. |
ttl |
Il valore "time-to-live" del cookie in giorni. |
u e uuid |
ID utente univoco assegnato dall'Audience Manager. Questo è necessario se effettui chiamate DCS server-to-server. |
y |
Tipo di destinazione, iFrame (iframe ) o immagine (img ). |