DocumentationExperience PlatformDocumentation de l’API du serveur réseau Edge

Collecte de données non interactive

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

Créé pour :

  • Developer

Vue d’ensemble overview

Les points de terminaison de collecte de données d’événement non interactifs sont utilisés pour envoyer plusieurs événements à des jeux de données ou à d’autres sources Experience Platform.

L’envoi d’événements par lots est recommandé lorsque les événements d’utilisateur final sont placés en file d’attente localement pendant une courte période (par exemple, lorsqu’il n’y a aucune connexion réseau).

Les événements de lot ne doivent pas nécessairement appartenir au même utilisateur final, ce qui signifie que les événements peuvent contenir différentes identités dans leur identityMap .

Exemple d’appel API non interactif example

Format d’API api-format

POST /ee/v2/collect

Requête 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"
         }
      }
   ]
}'
Paramètre
Type
Obligatoire
Description
dataStreamId
String
Oui
L’identifiant du flux de données utilisé par le point de terminaison de la collecte de données.
requestId
String
Non
Fournissez un identifiant de suivi de requête externe. Si aucun n’est fourni, le réseau Edge en génère un pour vous et le renvoie dans le corps/les en-têtes de réponse.
silent
Boolean
Non
Paramètre booléen facultatif indiquant si le réseau Edge doit renvoyer une valeur 204 No Content réponse avec un payload vide ou non. Les erreurs critiques sont signalées à l’aide du code d’état HTTP et de la charge utile correspondants.

Réponse response

Une réponse réussie renvoie l’un des états suivants, ainsi qu’un requestID si aucun n’a été fourni dans la requête.

  • 202 Accepted une fois la requête traitée ;
  • 204 No Content lorsque la requête a été traitée avec succès et que la variable silent a été défini sur true;
  • 400 Bad Request lorsque la requête n’a pas été correctement formée (par exemple, l’identité principale obligatoire est introuvable).
{
  "requestId": "f567a988-4b3c-45a6-9ed8-f283188a445e"
}
recommendation-more-help
f36c2cef-1417-40aa-a11d-5d0abaee121b