DokumentationExperience PlatformDokumentation zur Edge Network Server-API

Nicht interaktive Datenerfassung

Last update: Wed Dec 06 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Developer

Übersicht overview

Nicht-interaktive Ereignis-Datenerfassungs-Endpunkte werden verwendet, um mehrere Ereignisse an Experience Platform-Datensätze oder andere Ausgänge zu senden.

Das Senden von Ereignissen im Batch-Modus wird empfohlen, wenn Endbenutzerereignisse für einen kurzen Zeitraum lokal in die Warteschlange gestellt werden (z. B. wenn keine Netzwerkverbindung besteht).

Batch-Ereignisse sollten nicht unbedingt demselben Endbenutzer angehören, d. h. Ereignisse können unterschiedliche Identitäten in ihren identityMap -Objekt.

Beispiel für nicht interaktiven API-Aufruf example

API-Format api-format

POST /ee/v2/collect

Anfrage request

curl -X POST "https://server.adobedc.net/ee/v2/collect?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 '{
   "events": [
      {
         "xdm": {
            "identityMap": {
               "FPID": [
                  {
                     "id": "79bf8e83-f708-414b-b1ed-5789ff33bf0b",
                     "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"
         }
      },
      {
         "xdm": {
            "identityMap": {
               "FPID": [
                  {
                     "id": "871e8460-a329-4e96-a5b6-ff359fb0afb9",
                     "primary": "true"
                  }
               ]
            },
            "eventType": "web.webinteraction.linkClicks",
            "web": {
               "webInteraction": {
                  "linkClicks": {
                     "value": 1
                  }
               },
               "name": "My Custom Link",
               "URL": "https://myurl.com"
            },
            "timestamp": "2021-08-09T14:09:20.859Z"
         }
      }
   ]
}'
Parameter
Typ
Erforderlich
Beschreibung
dataStreamId
String
Ja
Die ID des vom Datenerfassungs-Endpunkt verwendeten Datastreams.
requestId
String
Nein
Geben Sie eine externe Anfrage-Tracking-ID an. Wenn keines angegeben ist, generiert das Edge-Netzwerk eines für Sie und gibt es im Antworttext/in den Kopfzeilen zurück.
silent
Boolean
Nein
Optionaler boolescher Parameter, der angibt, ob das Edge-Netzwerk eine 204 No Content -Antwort mit einer leeren Payload oder nicht. Kritische Fehler werden mithilfe des entsprechenden HTTP-Status-Codes und der Payload gemeldet.

Antwort response

Eine erfolgreiche Antwort gibt einen der folgenden Status zurück und eine requestID , wenn in der Anfrage keine angegeben wurde.

  • 202 Accepted wann die Anfrage erfolgreich verarbeitet wurde;
  • 204 No Content wann die Anfrage erfolgreich verarbeitet wurde und silent festgelegt wurde auf true;
  • 400 Bad Request wenn die Anforderung nicht ordnungsgemäß erstellt wurde (z. B. wurde die obligatorische primäre Identität nicht gefunden).
{
  "requestId": "f567a988-4b3c-45a6-9ed8-f283188a445e"
}
recommendation-more-help
f36c2cef-1417-40aa-a11d-5d0abaee121b