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 bewerken. 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. Om dit te doen, zou u roepen dpm.demdex.net en maak uw aanvraag op zoals hieronder wordt getoond. Cursief Hiermee wordt een tijdelijke aanduiding voor een variabele aangegeven.

In dit syntaxisvoorbeeld, d_ prefix identificeert de zeer belangrijk-waardeparen in de vraag als systeem-vlakke variabele. U kunt er een paar doorgeven d_ parameters aan de dienst van identiteitskaart, maar blijf geconcentreerd op de zeer belangrijk-waardeparen zoals aangetoond in de code hierboven. Zie voor meer informatie over andere variabelen Ondersteunde kenmerken voor DCS API-aanroepen.

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 aanvragen

Parameter
Beschrijving
dpm.demdex.net
Een bestaand domein dat wordt beheerd door Adobe. Zie Inzicht in calls naar het Demdex-domein.
d_mid
De Experience Cloud-bezoeker-id. Zie Cookies en de Experience Cloud Identity Service.
d_orgid
Je Experience Cloud Organisatie-id. Zie voor hulp bij het zoeken naar deze id: Vereisten voor de Experience Cloud Identity Service.
d_cid

Een optionele parameter die de Data Provider ID (DPID), de Unique User ID (DPUUID) en een geverifieerde status-id naar de id-service. Zoals getoond in de codesteekproef, scheidt DPID en DPUUID met het niet-druk controlekarakter, %01.

DPID en DPUUID

In de d_cid parameter, elke verwante combinatie DPID en DPUUID aan het zelfde toewijzen d_cid parameter. Hiermee kunt u meerdere id-sets in één aanvraag retourneren. Bovendien scheidt u de DPID, DPUUID en de optionele verificatiemarkering met het niet-afdrukbare besturingsteken. %01. In de onderstaande voorbeelden worden de provider en de gebruikers-id's gemarkeerd in vet tekst.

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

Verificatiestatus

Dit is een optionele id in het dialoogvenster d_cid parameter. 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 de UUID- en authenticatiemarkering met het niet-afdrukbare besturingsteken. %01. In de onderstaande voorbeelden worden de verificatie-id's gemarkeerd in vet 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 Id's, locaties en hostnamen van DCS-regio's.
d_cb
(Optioneel) Een callback-parameter waarmee u een JavaScript-functie in de hoofdtekst van de aanvraag kunt uitvoeren.
d_blob
Een gecodeerd segment JavaScript-metagegevens. De groottebeperkingen beperken de blob tot 512 bytes of minder.
d_ver
Vereist. Hiermee wordt het API-versienummer ingesteld. Deze set laten staan als d_ver=2.

Responsparameters

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