Interaktive Datenerfassung

Übersicht overview

Endpunkte zur interaktiven Datenerfassung erhalten ein einzelnes Ereignis und werden verwendet, wenn der Client erwartet, dass eine Antwort vom Adobe Experience Platform-Edge Network-Server zurückgegeben wird. Diese Endpunkte können bei der Datenerfassung auch Inhalte von anderen Edge Network-Diensten zurückgeben.

IMPORTANT
Der Endpunkt /interact ist in erster Linie für die Verwendung durch die Experience Platform SDKs vorgesehen. Dieser Endpunkt unterliegt zusätzlichen Änderungen, und sein Verhalten kann sich ohne Vorankündigung weiterentwickeln. Beispielsweise können der Antwort-Payload in Zukunft neue Elemente hinzugefügt werden.

Die Serverantwort enthält ein oder mehrere Handle -Objekte, wie unten dargestellt.

Beispiel für API-Aufruf

API-Format format

POST /ee/v2/interact

Anfrage request

curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
   "event": {
      "xdm": {
         "identityMap": {
            "Email_LC_SHA256": [
               {
                  "id": "0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b",
                  "primary": true
               }
            ]
         },
         "eventType": "web.webpagedetails.pageViews",
         "web": {
            "webPageDetails": {
               "URL": "https://alloystore.dev/",
               "name": "home-demo-Home Page"
            }
         },
         "timestamp": "2021-08-09T14:09:20.859Z"
      },
      "data": {
         "prop1": "custom value"
      }
   }
}'
Parameter
Typ
Erforderlich
Beschreibung
dataStreamId
String
Ja.
Datenspeicher-ID.
requestId
String
Nein
Geben Sie eine Client-Zufallskennung für die Korrelation interner Server-Anforderungen an. Wenn keine angegeben ist, generiert das Edge-Netzwerk eine und gibt sie in der Antwort zurück.

Antwort response

Eine erfolgreiche Antwort gibt den HTTP-Status 200 OK mit einem oder mehreren Handle -Objekten zurück, je nachdem, welche Echtzeit-Edge-Dienste in der Datastream-Konfiguration aktiviert sind.

{
   "requestId": "c85402f5-83a1-4fb3-abdd-f4c17bf6dd49",
   "handle": []
}
recommendation-more-help
f36c2cef-1417-40aa-a11d-5d0abaee121b