Directe integratie met de Experience Cloud Identity Service
Gemaakt voor:
- Ontwikkelaar
- Gebruiker
- Beheerder
- Leider
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
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
Uw verzoek kan er ongeveer zo uitzien als hieronder weergegeven voorbeeld. Lange variabelen zijn ingekort.
Monsterreactie
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
Parameters van het Verzoek
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...
Parameters van de Reactie
Sommige responsparameters maken deel uit van de aanvraag en zijn gedefinieerd in de bovenstaande sectie.