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 formatera din begäran enligt nedan. Kursiv används för att ange en variabelplatshållare.

I det här syntaxexemplet d_ prefix identifierar nyckelvärdepar i anropet som en systemnivåvariabel. Du kan skicka ganska många 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 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

Parametrar för begäran

Parameter
Beskrivning
dpm.demdex.net
En äldre domän som styrs av Adobe. Se Förstå anrop till Demdex-domänen.
d_mitt
Besökar-ID för Experience Cloud. Se Cookies och Experience Cloud Identity Service.
d_orgid
Organisations-ID för Experience Cloud. Mer information om hur du hittar detta ID finns i Krav för Experience Cloud Identity Service.
d_cid

En valfri parameter som skickar Data Provider ID (DPID), det unika användar-ID:t (DPUUID) och en ID för autentiserat tillstånd till ID-tjänsten. Som framgår av kodexemplet ska DPID och DPUID skiljas från kontrolltecknet som inte skrivs ut. %01.

DPID och DPUID

I d_cid parameter, tilldela varje relaterad DPID- och DPUUID-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 leverantörs- och användar-ID:n i fet text.

  • Syntax: ...d_cid=DPID%01DPUUID%01autentiseringsläge..
  • Exempel: ...d_cid=123%01456%011..

Autentiseringstillstånd

Detta är ett valfritt ID i d_cid parameter. 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 markeras autentiserings-ID:n i fet text.

Syntax: ...d_cid=DPID%01DPUUID%01autentiseringsläge

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 DCS-region-ID, -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ämna uppsättningen som 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