Attributi supportati per DCS chiamate API

20 luglio 2024
  • Argomenti:
  • DCS

Elenca e descrive la sintassi e gli attributi supportati (o coppie chiave-valore) che è possibile passare a Data Collection Servers (DCS). Queste informazioni possono essere utili per formattare le richieste DCS e comprendere i parametri restituiti dal sistema.

Prefissi attributo

DCS si basa su prefissi specifici aggiunti alle chiavi nelle coppie chiave-valore per classificare il tipo di dati che stai trasmettendo.

Prefisso chiaveRiservato a
c_Attributi definiti dal cliente.
d_Attributi Audience Manager.
h_Dati di intestazione HTTP.
p_

Attributi privati definiti dal cliente.

Il DCS accetta dati privati quando la chiave ha il prefisso p_. I dati privati vengono utilizzati per la valutazione delle caratteristiche, ma non verranno registrati o memorizzati nel nostro sistema. Supponiamo ad esempio che tu abbia una caratteristica definita come customers = p_age<25 e passi p_age=23 in una chiamata evento. Considerate queste condizioni, l'utente che soddisfa i criteri di qualifica basati sull'età è idoneo per la caratteristica, ma la coppia chiave-valore viene eliminata dopo che Audience Manager riceve la richiesta e non viene registrato.

Attributi d_

Tutti questi elementi sono facoltativi, a meno che non si desideri una risposta da DCS. Se desideri che DCS restituisca una risposta, è necessario d_rtbd=json.

AttributoDescrizione
d_callerUtilizzato per identificare il chiamante che effettua la chiamata all'API DCS di .
d_cbSpecifica una funzione JavaScript che si desidera eseguire utilizzando la risposta DCS di come parametro della funzione di callback.
d_cid

Contiene una o più coppie di ID provider dati ( DPID) e ID utente provider dati ( DPUUID) assegnati da Audience Manager. Se si utilizzano più coppie di DPID e DPUUID, separare ciascuna coppia con il carattere non stampabile %01. Esempio: DPID%01DPUUUID.

d_cid sostituisce d_dpid e d_dpuuid, che sono obsoleti ma ancora supportati. Vedere CID sostituisce DPID e DPUUID.

d_cid_ic

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.

d_coppaDisattiva l’utilizzo di cookie di terze parti al fine di rispettare le normative a tutela dei minori. Questo parametro viene impostato dinamicamente dal servizio Adobe Adobe Experience Platform Identity e dipende dalla configurazione idSyncDisable3rdPartySyncing. Consulta Supporto per COPPA nel servizio Adobe Experience Platform Identity.

d_cts=1

d_cts=2

Facoltativo. Abilitato su richiesta del cliente. Contatta il tuo consulente Adobe Audience Manager o l'Assistenza clienti.

Indica che caratteristiche e segmenti devono essere restituiti all'interno della risposta JSON.

  • d_cts=1 restituisce ID segmento legacy per i segmenti.

  • d_cts=2 restituisce gli ID segmento per i segmenti.

Un esempio di risposta potrebbe essere simile a quello riportato di seguito:

{     "stuff": [],     "uuid": "07955261652886032950143702505894272138",     "dcs_region": 7,     "traits": [420020, 5421506],     "segments": [984263, 985264],     "tid": "ss3OTqPiQp0=" }

d_dpidObsoleto. Vedere d_cid e d_cid_ic.
d_dpuuidObsoleto. Vedere d_cid e d_cid_ic.
d_dst=1Restituisce i dati di destinazione URL nella risposta JSON.
d_dst_filter

d_dst_filter è un attributo riservato, utilizzato nell’integrazione tra Adobe Analytics e Audience Manager.

Consigliamo di non creare caratteristiche che utilizzano attributi riservati. Adobe può modificare gli attributi riservati in qualsiasi momento.

d_jsonv=1|0Indica la versione JSON da utilizzare nella risposta. In genere, è necessario impostare su d_jsonv=1. L'impostazione di d_jsonv=0 disabilita le sincronizzazioni ID.
d_midSpecifica l'ID Experience Cloud impostato e utilizzato dal servizio ID Experience Cloud di . Per ulteriori informazioni sull'ECID, vedere Cookie e il servizio Experience Cloud Identity.
d_nsidID spazio dei nomi. Indica quale contenitore JavaScript viene utilizzato. Utilizzato da DIL per la sincronizzazione ID.
d_ptfm

Consente ad Audience Manager di distinguere le richieste da dispositivi mobili da quelle da desktop. I valori supportati includono:

  • ios
  • android
  • browser
  • all
d_rs

Obsoleto. d_rs è un attributo riservato, utilizzato nell'integrazione legacy tra Adobe Analytics e Audience Manager.

Consigliamo di non creare caratteristiche che utilizzano attributi riservati. Adobe può modificare gli attributi riservati in qualsiasi momento.

d_rtbd=json

Obbligatorio se si desidera ottenere una risposta JSON dal DCS .

  • Se si omette questo elemento, il DCS di restituisce un pixel nell'intestazione.
  • Se si include questo elemento, il DCS di restituisce un oggetto JSON nel corpo della risposta. Vedi l’esempio seguente. La tua risposta potrebbe essere più complessa.

{     "stuff": [],     "uuid": "22920112968019678612904394744954398990",     "dcs_region": 7,     "tid": "ss3OTqPiQp0=" }

d_sidSID sta per punteggio ID. Questo è un ID univoco per una caratteristica o un segmento.
d_tdpid

Passa un'origine dati per la valutazione delle caratteristiche. Vengono valutate solo le caratteristiche di questa origine dati.

Ad esempio, supponiamo che tu abbia:

  • Caratteristica T1 con:
  • Regola caratteristiche: " key1 == val1"
  • Data Source ( DPID): 1
  • Codice di integrazione DPID: ic1
  • Caratteristica T2 con:
  • Regola caratteristiche: " key2 == val2"
  • Data Source (DPID): 2
  • Codice integrazione DPID: ic2

In una chiamata di esempio, yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid=1, viene restituita solo la caratteristica T1.

d_tdpid_ic

Lo scopo è identico al parametro d_tdpid descritto sopra. Tuttavia, in questo caso, l’origine dati viene passata utilizzando il codice di integrazione.

Mantenendo le caratteristiche descritte in precedenza, considera la chiamata di esempio:

Per yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2, viene restituita solo la caratteristica T2.

d_uuidID utente univoco. Identifica un visitatore quando questo valore non è disponibile da un cookie.

h_ Attributes

Queste intestazioni contengono informazioni come richieste di dati e risposte in una chiamata HTTP.

AttributoDescrizione
h_hostÈ impostato sul nome host specifico del client per la raccolta dati. Viene visualizzato come host name .demdex.net. Consulta Understanding Calls to the Demdex Domain.
h_user-agentImposta sul valore dell'intestazione User-Agent.
h_accept-languageImposta sul valore dell'intestazione Accept-Language.
h_refererImposta sul valore dell'intestazione Referer.
h_referrerImposta sul valore dell'intestazione Referrer.
h_dateImposta sul valore dell'intestazione Date.
recommendation-more-help