DocumentazioneExperience PlatformDocumentazione API del server di rete Edge

Raccolta di dati non interattivi

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

Creato per:

  • Sviluppatore

Panoramica overview

Gli endpoint di raccolta dati per eventi non interattivi vengono utilizzati per inviare più eventi a set di dati Experience Platform o ad altre prese.

L’invio di eventi in batch è consigliato quando gli eventi dell’utente finale vengono messi in coda localmente per un breve periodo di tempo (ad esempio quando non vi è alcuna connessione di rete).

Gli eventi batch non devono necessariamente appartenere allo stesso utente finale, il che significa che possono contenere identità diverse all'interno del loro oggetto identityMap.

Esempio di chiamata API non interattiva example

Formato API api-format

POST /ee/v2/collect

Richiesta 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"
         }
      }
   ]
}'
Parametro
Tipo
Obbligatorio
Descrizione
dataStreamId
String
Sì
ID dello stream di dati utilizzato dall’endpoint di raccolta dati.
requestId
String
No
Specifica un ID di traccia della richiesta esterno. Se non viene fornito alcun elemento, l’Edge Network ne genererà uno per te e lo restituirà nel corpo/nelle intestazioni della risposta.
silent
Boolean
No
Parametro booleano facoltativo che indica se l'Edge Network deve restituire o meno una risposta 204 No Content con un payload vuoto. Gli errori critici vengono segnalati utilizzando il codice di stato HTTP e il payload corrispondenti.

Risposta response

In caso di esito positivo, la risposta restituisce uno dei seguenti stati e requestID, se non ne è stato fornito alcuno nella richiesta.

  • 202 Accepted quando la richiesta è stata elaborata correttamente;
  • 204 No Content quando la richiesta è stata elaborata correttamente e il parametro silent è stato impostato su true;
  • 400 Bad Request quando la richiesta non era formata correttamente (ad esempio, l'identità primaria obbligatoria non è stata trovata).
{
  "requestId": "f567a988-4b3c-45a6-9ed8-f283188a445e"
}
recommendation-more-help
f36c2cef-1417-40aa-a11d-5d0abaee121b