Documentación Experience Platform Documentación de la API del servidor de red perimetral

Recopilación de datos no interactiva

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

Temas:

Creado para:

Desarrollador

Información general overview

Los extremos de recopilación de datos de evento no interactivos se utilizan para enviar varios eventos a conjuntos de datos de Experience Platform u otros medios.

Se recomienda enviar eventos por lotes cuando los eventos del usuario final se ponen en cola localmente durante un corto periodo de tiempo (por ejemplo, cuando no hay conexión de red).

Los eventos por lotes no deben pertenecer necesariamente al mismo usuario final, lo que significa que los eventos pueden contener identidades diferentes dentro de su objeto identityMap.

Ejemplo de llamada de API no interactiva example

Formato de API api-format

POST /ee/v2/collect

Solicitud 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"
         }
      }
   ]
}'

Parámetro

Tipo

Requerido

Descripción

dataStreamId

String

Sí

ID de la secuencia de datos utilizada por el extremo de recopilación de datos.

requestId

String

Proporcione un ID de seguimiento de solicitud externa. Si no se proporciona ninguno, el Edge Network generará uno para usted y lo devolverá de nuevo en el cuerpo/encabezados de respuesta.

silent

Boolean

Parámetro booleano opcional que indica si el Edge Network debe devolver o no una respuesta 204 No Content con una carga útil vacía. Los errores críticos se registran utilizando el código de estado HTTP y la carga útil correspondientes.

Respuesta response

Una respuesta correcta devuelve uno de los siguientes estados, y un requestID si no se proporcionó ninguno en la solicitud.

202 Accepted cuando la solicitud se procesó correctamente;
204 No Content cuando la solicitud se procesó correctamente y el parámetro silent se estableció en true;
400 Bad Request cuando la solicitud no se formó correctamente (por ejemplo, no se encontró la identidad principal obligatoria).

{
  "requestId": "f567a988-4b3c-45a6-9ed8-f283188a445e"
}

recommendation-more-help

f36c2cef-1417-40aa-a11d-5d0abaee121b