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

Collecte de données non interactive

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

Créé pour :

  • Développeur

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 objet 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, l’Edge Network 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 l’Edge Network doit renvoyer une réponse 204 No Content avec une charge utile 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, et requestID si aucun état n’a été fourni dans la requête.

  • 202 Accepted lorsque la requête a été traitée avec succès ;
  • 204 No Content lorsque la requête a été traitée avec succès et que le paramètre 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