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

Parameter
Beschreibung
dpm.demdex.net
Eine ältere von Adobe verwaltete Domain. Siehe Aufrufe an die Domain „demdex.net“.
d_mid
Die Experience Cloud-Besucher-ID. Siehe Cookies und der Experience Cloud Identity Service.
d_orgid
Ihre Experience Cloud-Organisations-ID. Hilfe zum Auffinden dieser ID finden Sie unter Voraussetzungen für den Experience Cloud Identity-Dienst.
d_cid

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...
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).
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a