Attributi supportati per le chiamate DCS API

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

Prefissi attributi

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

Prefisso chiave Riservato per

c_

Attributi definiti dal cliente.

d_

Attributi di Audience Manager.

h_

Dati di intestazione HTTP.

p_

Attributi privati definiti dal cliente.

Il DCS accetta i propri dati privati quando la chiave ha un prefisso p_ . I dati privati vengono utilizzati per la valutazione delle caratteristiche, ma non verranno registrati o memorizzati nel nostro sistema. Ad esempio, supponiamo che tu abbia una caratteristica definita come customers = p_age<25 e che passi p_age=23 in una chiamata dell’evento. Date queste condizioni, l’utente che soddisfa i criteri di qualificazione basati sull’età si qualifica come idoneo per la caratteristica, ma la coppia chiave-valore viene rilasciata dopo che Audience Manager riceve la richiesta e non viene registrata.

d_ Attributi

Tutte queste opzioni sono facoltative, a meno che non si desideri ricevere una risposta da DCS. Se si desidera che il DCS restituisca una risposta, è necessario d_rtbd=json.

Attributo Descrizione

d_caller

Utilizzato per identificare il chiamante che effettua la chiamata all' API DCS.

d_cb

Specifica una funzione JavaScript da eseguire utilizzando la risposta DCS come parametro di funzione 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 utilizzi più coppie di DPIDs e DPUUIDs, separa ciascuna coppia con il carattere non stampabile %01. Ad esempio: DPID%01DPUUUID.

d_cid sostituisce d_dpid e d_dpuuid, che sono obsoleti ma sono ancora supportati. Consulta CID Replaces DPID and 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 sono ancora supportati. Consulta CID Replaces DPID and DPUUID.

d_coppa

Disabilitare l'utilizzo di cookie di terze parti per rispettare le normative sulla protezione dei bambini. 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 le caratteristiche e i 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 del segmento per i segmenti.

Di seguito è riportato un esempio di risposta:

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

d_dpid

Obsoleto. Vedere d_cid e d_cid_ic.

d_dpuuid

Obsoleto. Vedere d_cid e d_cid_ic.

d_dst=1

Restituisce 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.

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

d_jsonv=1|0

Indica la versione JSON da utilizzare nella risposta. Normalmente, è necessario impostare questo su d_jsonv=1. L'impostazione d_jsonv=0 disattiva le sincronizzazioni ID.

d_mid

Specifica l'ID Experience Cloud impostato e utilizzato dal servizio Experience Cloud ID. Per ulteriori informazioni sull’ECID, consulta Cookie e il servizio Experience Cloud Identity.

d_nsid

ID spazio nome. Indica il contenitore JavaScript utilizzato. Utilizzato da DIL per la sincronizzazione id.

d_ptfm

Consente ad Audience Manager di distinguere le richieste mobile dalle richieste 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.

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

d_rtbd=json

Obbligatorio se si desidera una risposta JSON da DCS.

  • Se ometti questa operazione, il DCS restituisce un pixel nell'intestazione.
  • Se si include questa opzione, il DCS 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_sid

SID sta per score 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 delle caratteristiche: " key1 == val1"
  • Origine dati ( DPID): 1
  • Codice di integrazione DPID: ic1
  • Caratteristica T2 con:
  • Regola delle caratteristiche: " key2 == val2"
  • Origine dati (DPID): 2
  • Codice di 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.

Tenendo le caratteristiche descritte sopra, 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_uuid

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

In questa pagina