Direkte Integration mit dem Experience Cloud Identity Service direct-integration-with-the-experience-cloud-id-service
Mit dieser Implementierung können Kunden den ID-Dienst auf Geräten verwenden, die unseren JavaScript- oder SDK-Code nicht akzeptieren oder verwenden können. Dazu gehören Geräte wie Spielekonsolen, Smart-TVs oder andere internetfähige Geräte. Informationen zu Syntax, Codebeispielen und Definitionen finden Sie in diesem Abschnitt.
Syntax section-a4754afec5ad40b6be00d6f1011d68bb
Geräte, die weder die VisitorAPI.js- noch die SDK-Codebibliothek unterstützen, können Aufrufe direkt an die vom ID-Dienst verwendeten Datenerfassungsserver (DCS) richten. Dazu rufen Sie dpm.demdex.net auf und geben eine Anforderung im folgenden Format ein. Eine kursive Formatierung gibt einen Variablenplatzhalter an.
In diesem Syntaxbeispiel kennzeichnet das d_ Präfix die Schlüssel-Wert-Paare im Aufruf als Variablen auf Systemebene. Sie können einige d_-Parameter an den ID-Dienst übergeben, konzentrieren Sie sich jedoch auf die Schlüssel-Wert-Paare, wie im Code oben gezeigt. Weitere Informationen zu anderen Variablen finden Sie unter Unterstützte Attribute für DCS-API-Aufrufe.
Der ID-Dienst unterstützt HTTP- und HTTPS-Aufrufe. Verwenden Sie HTTPS, um Daten von einer sicheren Seite weiterzugeben.
Beispielanforderung section-26302b8851704888b6f8e6b2071bcdb0
Ihre Anforderung könnte dem unten gezeigten Beispiel ähneln. Lange Variablen wurden gekürzt.
Beispielantwort section-89bc103b3e9e4a8b98e74c32897b1200
Der ID-Dienst gibt Daten in einem JSON-Objekt zurück, wie unten dargestellt. Ihre Antwort könnte anders aufgebaut sein.
{
"d_mid":"12345",
"dcs_region":"6",
"id_sync_ttl":"604800",
"d_blob":"wxyz5432"
}
Definierte Anforderungs- und Antwortparameter section-4a9912b545364dc4acad4f1ea5ec641d
Anfrageparameter
Ein optionaler Parameter, der die Data Provider ID (DPID), die eindeutige Benutzer-ID (DPUUID) und eine authentifizierte Zustands-ID an den ID-Dienst übergibt. Trennen Sie DPID und DPUUID durch das nicht druckbare Steuerzeichen %01, wie im Codebeispiel gezeigt.
DPID und DPUUID
Weisen Sie im Parameter d_cid alle zusammengehörigen Kombinationen aus DPID und DPUUID demselben d_cid-Parameter zu. Dadurch können Sie mehrere IDs in einer einzigen Anforderung übergeben. Trennen Sie außerdem DPID, DPUUID und die optionale Authentifizierungskennzeichnung durch das nicht druckbare Steuerzeichen %01. In den Beispielen weiter unten werden die Anbieter- und Benutzer-IDs durch Fettdruck hervorgehoben.
- Syntax: ...d_cid=DPID%01DPUUID%01authentication state...
- Beispiel: ...d_cid=123%01456%011...
Authentifizierungsstatus
Dies ist eine optionale ID im Parameter d_cid. Sie wird als Ganzzahl ausgedrückt und gibt den Authentifizierungsstatus von Benutzern an, wie unten gezeigt:
- 0 (Unbekannt)
- 1 (Authentifiziert)
- 2 (Abgemeldet)
Um einen Authentifizierungsstatus anzugeben, legen Sie diese Kennzeichnung im Anschluss an die Variable für die Benutzer-ID (UUID) fest. Trennen Sie UUID und Authentifizierungskennzeichnung durch das nicht druckbare Steuerzeichen %01. In den Beispielen unten werden Authentifizierungs-IDs durch Fettdruck hervorgehoben.
Syntax: ...d_cid=DPID%01DPUUID%01authentication state
Beispiele:
- Unbekannt: ...d_cid=123%01456%010...
- Authentifiziert: ...d_cid=123%01456%011...
- Abgemeldet: ...d_cid=123%01456%012...
Antwortparameter
Einige Antwortparameter sind Teil der Anforderung und wurden im obigen Abschnitt definiert.