Directe integratie met de Experience Cloud Identity Service direct-integration-with-the-experience-cloud-id-service

Met deze implementatie kunnen klanten de id-service gebruiken op apparaten die onze JavaScript- of SDK-code niet kunnen accepteren of gebruiken. Dit geldt onder andere voor apparaten zoals gameconsoles, slimme tv's of andere toestellen die geschikt zijn voor internet. Zie deze sectie voor syntaxis, codevoorbeelden en definities.

Syntaxis section-a4754afec5ad40b6be00d6f1011d68bb

Apparaten die de VisitorAPI.js of SDK codebibliotheken niet kunnen gebruiken kunnen vraag rechtstreeks aan de servers van de gegevensinzameling (DCS) maken die door de dienst van identiteitskaart worden gebruikt. U kunt dit doen door dpm.demdex.net aan te roepen en uw aanvraag op te maken, zoals hieronder wordt weergegeven. Cursief wijst op veranderlijke placeholder.

In dit syntaxisvoorbeeld identificeert het voorvoegsel d_ de sleutel-waardeparen in de vraag als een systeem-vlakke variabele. U kunt tamelijk een paar d_ parameters tot de dienst van identiteitskaart overgaan, maar geconcentreerd blijven op de zeer belangrijk-waardeparen zoals aangetoond in de code hierboven. Voor meer informatie over andere variabelen, zie Gesteunde Attributen voor vraag DCS API.

De id-service ondersteunt HTTP- en HTTPS-aanroepen. Gebruik HTTPS om gegevens van een beveiligde pagina door te geven.

Voorbeeldverzoek section-26302b8851704888b6f8e6b2071bcdb0

Uw verzoek kan er ongeveer zo uitzien als hieronder weergegeven voorbeeld. Lange variabelen zijn ingekort.

Monsterreactie section-89bc103b3e9e4a8b98e74c32897b1200

De id-service retourneert gegevens in een JSON-object, zoals hieronder wordt weergegeven. Je reactie kan anders zijn.

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

Parameters voor aanvragen en antwoorden gedefinieerd section-4a9912b545364dc4acad4f1ea5ec641d

Parameters van het Verzoek

Parameter
Beschrijving
dpm.demdex.net
Een verouderd domein dat wordt beheerd door Adobe . Zie Begrip Vraag aan het Domein van de Index.
d_mid
De bezoeker-id van het Experience Cloud. Zie Cookies en de Dienst van de Identiteit van het Experience Cloud.
d_orgid
Uw organisatie-id voor Experience Cloud. Voor hulp bij het vinden van deze identiteitskaart zie, Vereisten voor de Dienst van de Identiteit van het Experience Cloud.
d_cid

Een facultatieve parameter die identiteitskaart van de Leverancier van Gegevens (DPID), de Unieke Gebruiker - identiteitskaart (DPUUID), en een voor authentiek verklaarde staatsidentiteitskaarttot de dienst van identiteitskaart overgaat. Zoals aangetoond in de codesteekproef, scheidt DPID en DPUUID met het niet-druk controlekarakter, %01 .

DPID en DPUUID

In de d_cid parameter, wijs elke verwante combinatie DPID en DPUUID aan de zelfde d_cid parameter toe. Hiermee kunt u meerdere id-sets in één aanvraag retourneren. Plaats ook een scheidingsteken tussen DPID, DPUUID en de optionele verificatiemarkering en het niet-afdrukbare besturingsteken, %01 . In de voorbeelden hieronder, worden de leverancier en gebruiker IDs benadrukt in gewaagde tekst.

  • Syntaxis: ..d_cid=DPID%01DPUUID%01authentication state..
  • Voorbeeld: ..d_cid=123%01456%011...

de Staat van de Authentificatie

Dit is een optionele id in de parameter d_cid . Uitgedrukt als een geheel getal, identificeert het gebruikers op basis van hun verificatiestatus, zoals hieronder wordt weergegeven:

  • 0 (Onbekend)
  • 1 (geverifieerd)
  • 2 (Afgemeld)

Als u een verificatiestatus wilt opgeven, stelt u deze markering in na de variabele gebruikersnaam (UUID). Scheid UUID en authentificatiemarkering met het niet-druk controlekarakter, %01 . In de voorbeelden hieronder, worden authentificatie IDs benadrukt in gewaagde tekst.

Syntaxis: ..d_cid=DPID%01DPUUID%01authentication state

Voorbeelden:

  • Onbekend: ...d_cid=123%01456%010...
  • Voor authentiek verklaard: ..d_cid=123%01456%011...
  • Afgemeld: ..d_cid=123%01456%012...
dcs_region
De dienst van identiteitskaart is geografisch verdeeld en lading-evenwichtig systeem. Identiteitskaart identificeert het gebied van het gegevenscentrum dat de vraag behandelt. Zie DCS Gebied IDs, Locaties, en de Namen van de Gastheer.
d_cb
(Facultatief) Een callback parameter die u een functie van JavaScript in het verzoeklichaam laat uitvoeren.
d_blob
Een gecodeerd segment met JavaScript-metagegevens. De groottebeperkingen beperken de blob tot 512 bytes of minder.
d_ver
Vereist. Hiermee wordt het API-versienummer ingesteld. Laat deze set staan als d_ver=2 .

Parameters van de Reactie

Sommige responsparameters maken deel uit van de aanvraag en zijn gedefinieerd in de bovenstaande sectie.

Parameter
Beschrijving
id_sync_ttl
Het re-synchronisatieinterval, dat in seconden wordt gespecificeerd. Het standaardinterval is 604.800 seconden (7 dagen).
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a