DokumentationExperience PlatformDokumentation zur Edge Network Server-API

Nicht interaktive Datenerfassung

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler

Ü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 innerhalb ihres identityMap -Objekts enthalten.

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 Network eines für Sie und gibt es im Antworttext/in den Kopfzeilen zurück.
silent
Boolean
Nein
Optionaler boolean -Parameter, der angibt, ob das Edge Network eine 204 No Content -Antwort mit einer leeren Payload zurückgeben soll 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 einen requestID , wenn in der Anfrage keiner angegeben wurde.

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