Direkte Integration mit dem Experience Cloud Identity-Dienst

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

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

Ihre Anforderung könnte dem unten gezeigten Beispiel ähneln. Lange Variablen wurden gekürzt.

Beispielantwort

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

Anfrageparameter

Parameter Beschreibung

dpm.demdex.net

Eine ältere von Adobe verwaltete Domäne. Siehe Aufrufe an die Domäne „demdex.net“.

d_mid

Die Experience Cloud-Besucher-ID. Siehe Cookies und der Experience Cloud Identity-Dienst .

d_orgid

Ihre Experience Cloud-Organisations-ID. Informationen zum Auffinden dieser ID erhalten Sie unter Voraussetzungen für den Experience Cloud Identity-Dienst

d_cid

Ein optionaler Parameter, der die Data Provider ID (DPID), die Unique User 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...

dcs_region

Der ID-Dienst ist ein geografisch verteiltes und lastausgeglichenes System. Die ID identifiziert die Region des Rechenzentrums, in dem der Aufruf verarbeitet wird. Siehe DCS Region IDs, Locations, and Host Names.

d_cb

(Optional) Ein Rückrufparameter, mit dem Sie eine JavaScript-Funktion im Anforderungstext ausführen können.

d_blob

Ein verschlüsselter Abschnitt der JavaScript-Metadaten. Durch Größenbeschränkungen wird der Blob auf höchstens 512 Byte begrenzt.

d_ver

Erforderlich. Hiermit wird die API-Versionsnummer festgelegt. Behalten Sie d_ver=2 bei.

Antwortparameter

Einige Antwortparameter sind Teil der Anforderung und wurden im obigen Abschnitt definiert.

Parameter Beschreibung

id_sync_ttl

Das in Sekunden angegebene Neusynchronisierungsintervall. Der Standardwert beträgt 604.800 Sekunden (7 Tage).

Auf dieser Seite