Direkt integrering med Experience Cloud Identity Service direct-integration-with-the-experience-cloud-id-service

Den här implementeringen gör att kunder kan använda ID-tjänsten på enheter som inte kan acceptera eller arbeta med vår JavaScript- eller SDK-kod. Detta omfattar enheter som spelkonsoler, smarta TV-apparater eller andra internetanslutna enheter. I det här avsnittet finns syntax, kodexempel och definitioner.

Syntax section-a4754afec5ad40b6be00d6f1011d68bb

Enheter som inte kan använda kodbiblioteken VisitorAPI.js eller SDK kan anropa direkt till de datainsamlingsservrar (DCS) som används av ID-tjänsten. Om du vill göra det ringer du dpm.demdex.net och formaterar din begäran enligt nedan. Kursiv anger en variabelplatshållare.

I det här syntaxexemplet identifierar prefixet d_ nyckelvärdepar i anropet som en variabel på systemnivå. Du kan skicka flera d_-parametrar till ID-tjänsten, men fokusera på nyckelvärdepar enligt koden ovan. Mer information om andra variabler finns i Attribut som stöds för DCS API-anrop.

ID-tjänsten stöder HTTP- och HTTPS-anrop. Använd HTTPS för att skicka data från en säker sida.

Exempelbegäran section-26302b8851704888b6f8e6b2071bcdb0

Din förfrågan kan se ut ungefär som exemplet nedan. Långa variabler har förkortats.

Exempelsvar section-89bc103b3e9e4a8b98e74c32897b1200

ID-tjänsten returnerar data i ett JSON-objekt enligt nedan. Ditt svar kan vara annorlunda.

{
     "d_mid":"12345",
     "dcs_region":"6",
     "id_sync_ttl":"604800",
     "d_blob":"wxyz5432"
}

Parametrar för begäran och svar har definierats section-4a9912b545364dc4acad4f1ea5ec641d

Begär parametrar

Parameter
Beskrivning
dpm.demdex.net
En äldre domän som styrs av Adobe. Se Förstå anrop till Demdex-domänen.
d_mid
Besökar-ID för Experience Cloud. Se Cookies och Experience Cloud Identity Service.
d_orgid
Organisations-ID för Experience Cloud. Om du vill ha hjälp med att hitta det här ID:t kan du läsa Krav för Experience Cloud-identitetstjänsten.
d_cid

En valfri parameter som skickar Data Provider ID (DPID), det unika användar-ID:t (DPUUID) och ett autentiserat tillstånd-IDtill ID-tjänsten. Som du kan se i kodexemplet separerar du DPID och DPUID med kontrolltecknet som inte skrivs ut, %01.

DPID och DPUUID

I parametern d_cid tilldelar du varje relaterad DPID- och DPUID-kombination till samma d_cid -parameter. På så sätt kan du returnera flera ID-uppsättningar i en enda begäran. Separera också DPID, DPUID och valfri autentiseringsflagga med kontrolltecknet som inte skrivs ut, %01. I exemplen nedan markeras provider- och användar-ID i texten bold .

  • Syntax: ..d_cid=DPID%01DPUID%01autentiseringstillstånd..
  • Exempel: ..d_cid=123%01456%011..

Autentiseringstillstånd

Detta är ett valfritt ID i parametern d_cid . Uttryckt som ett heltal identifierar det användare utifrån deras autentiseringsstatus enligt nedan:

  • 0 (okänd)
  • 1 (autentiserad)
  • 2 (utloggad)

Om du vill ange ett autentiseringstillstånd anger du den här flaggan efter variabeln för användar-ID (UUID). Avgränsa UUID- och autentiseringsflaggan med kontrolltecknet som inte skrivs ut, %01. I exemplen nedan är autentiserings-ID:n markerade i texten bold.

Syntax: ..d_cid=DPID%01DPUID%01autentiseringstillstånd

Exempel:

  • Okänd: ..d_cid=123%01456%010..
  • Autentiserad: ..d_cid=123%01456%011..
  • Utloggad: ..d_cid=123%01456%012..
dcs_region
ID-tjänsten är ett geografiskt distribuerat och lastbalanserat system. ID:t identifierar den region i datacentret som hanterar anropet. Se ID:n för DCS-region, platser och värdnamn.
d_cb
(Valfritt) En callback-parameter som gör att du kan köra en JavaScript-funktion i begärandetexten.
d_blob
Ett krypterat segment med JavaScript-metadata. Storleksbegränsningar begränsar blobben till 512 byte eller mindre.
d_ver
Obligatoriskt. Detta anger API-versionsnumret. Låt den här uppsättningen vara d_ver=2.

Svarsparametrar

Vissa svarsparametrar ingår i begäran och har definierats i avsnittet ovan.

Parameter
Beskrivning
id_sync_ttl
Intervallet för omsynkronisering, angivet i sekunder. Standardintervallet är 604 800 sekunder (7 dagar).
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a