Attribut som stöds för DCS API-anrop

Senast uppdaterad: 20 juli 2024

Visar och beskriver syntaxen och de attribut (eller nyckelvärdepar) som stöds och som du kan skicka till Data Collection Servers (DCS). Den här informationen kan hjälpa dig att formatera dina DCS-begäranden och förstå de parametrar som returneras av systemet.

Attributprefix

DCS förlitar sig på specifika prefix som läggs till nycklarna i nyckelvärdepar för att klassificera den typ av data som du skickar in.

NyckelprefixReserverad för
c_Kunddefinierade attribut.
d_Audience Manager-attribut.
h_HTTP-rubrikdata.
p_

Privata, kunddefinierade attribut.

DCS accepterar egna, privata data när nyckeln har ett p_-prefix. Privata data används för utvärdering av egenskaper, men de kommer inte att loggas eller lagras i vårt system. Anta till exempel att du har en egenskap definierad som customers = p_age<25 och du skickar in p_age=23 i ett händelseanrop. På grund av dessa villkor kvalificerar den användare som uppfyller de åldersbaserade kvalificeringskriterierna för egenskapen, men nyckel-värde-paret tas bort efter att Audience Manager har tagit emot begäran och inte loggats.

d_ attribut

Alla dessa är valfria, såvida du inte vill ha ett svar från DCS. Om du vill att DCS ska returnera ett svar krävs d_rtbd=json.

AttributBeskrivning
d_callerAnvänds för att identifiera anroparen som gör anropet till API:t DCS.
d_cbAnger en JavaScript-funktion som du vill köra med DCS -svaret som en funktionsparameter för callback-funktionen.
d_cid

Innehåller ett eller flera par med DataProvider-ID ( DPID) och DataProvider-användar-ID ( DPUUID) som tilldelats av Audience Manager. Om du använder flera par med DPID och DPUUID, skiljer du varje par åt med det tecken som inte skrivs ut %01. Till exempel: DPID%01DPUUUID.

d_cid ersätter d_dpid och d_dpuuid, som är inaktuella men fortfarande stöds. Se CID ersätter DPID och DPUUID.

d_cid_ic

Innehåller en integreringskod och ett associerat unikt användar-ID i ett enda nyckelvärdepar.

d_cid_ic ersätter d_dpid och d_dpuuid, som är inaktuella men fortfarande stöds. Se CID ersätter DPID och DPUUID.

d_coppaInaktivera användning av cookies från tredje part för att uppfylla regler för skydd av barn. Den här parametern ställs in dynamiskt av Adobe Adobe Experience Platform Identity Service och beror på idSyncDisable3rdPartySyncing-konfigurationen. Se COPPA-stöd i Adobe Experience Platform Identity Service.

d_cts=1

d_cts=2

Valfritt. Aktiverad på kundens begäran. Kontakta Adobe Audience Manager eller kundtjänst.

Anger att egenskaper och segment ska returneras inuti svaret JSON.

  • d_cts=1 returnerar äldre segment-ID:nför segmenten.

  • d_cts=2 returnerar segment-ID:n för segmenten.

Ett exempelsvar kan se ut som det nedan:

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

d_dpidFöråldrat. Se d_cid och d_cid_ic.
d_dpuuidFöråldrat. Se d_cid och d_cid_ic.
d_dst=1Returnerar URL-måldata i svaret JSON.
d_dst_filter

d_dst_filter är ett reserverat attribut, som används vid integreringen mellan Adobe Analytics och Audience Manager.

Vi rekommenderar att du inte skapar egenskaper som använder reserverade attribut. Adobe kan när som helst ändra reserverade attribut.

d_jsonv=1|0Anger den JSON-version som ska användas i svaret. Normalt bör du ange det här till d_jsonv=1. Inställningen d_jsonv=0 inaktiverar ID-synkronisering.
d_midAnger det Experience Cloud-ID som angetts och som används av ID-tjänsten Experience Cloud. Mer information om ECID finns i Cookies och Experience Cloud Identity Service.
d_nsidNamnområdes-ID. Anger vilken JavaScript-behållare som används. Används av DIL för ID-synkronisering.
d_ptfm

Gör att Audience Manager kan skilja på mobilförfrågningar och datorförfrågningar. Följande värden stöds:

  • ios
  • android
  • browser
  • all
d_rs

Föråldrat. d_rs är ett reserverat attribut som används i den äldre integreringen mellan Adobe Analytics och Audience Manager .

Vi rekommenderar att du inte skapar egenskaper som använder reserverade attribut. Adobe kan när som helst ändra reserverade attribut.

d_rtbd=json

Krävs om du vill ha ett JSON-svar från DCS.

  • Om du utelämnar detta returnerar DCS en pixel i sidhuvudet.
  • Om du tar med det här returnerar DCS ett JSON-objekt i svarstexten. Se exemplet nedan. Svaret kan vara mer komplext.

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

d_sidSID står för poäng-ID . Detta är ett unikt ID för ett trait eller segment.
d_tdpid

Skickar en datakälla för utvärdering av egenskaper. Endast egenskaper från den här datakällan utvärderas.

Anta att du har:

  • Trait T1 med:
  • Trait-regel: key1 == val1
  • Data-Source ( DPID): 1
  • DPID-integrationskod: ic1
  • Trait T2 med:
  • Trait-regel: key2 == val2
  • Data Source (DPID): 2
  • DPID-integrationskod: ic2

I ett samplingsanrop, yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid=1, returneras bara trait T1.

d_tdpid_ic

Syftet är identiskt med parametern d_tdpid som beskrivs ovan. I det här fallet skickas datakällan med integreringskoden.

Behåll de egenskaper som beskrivs ovan, överväg att genomföra stickprovet:

För yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2 returneras endast egenskapen T2.

d_uuidUnikt användar-ID. Identifierar en besökare när det här värdet inte är tillgängligt från en cookie.