DocumentazioneExperience PlatformDocumentazione API del server di rete Edge

Raccolta interattiva di dati

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 interattivi ricevono un singolo evento e vengono utilizzati quando il client prevede che venga restituita una risposta dal server di Edge Network di Adobe Experience Platform. Durante la raccolta dei dati, questi endpoint possono restituire anche il contenuto di altri servizi Edge Network.

IMPORTANT
L'endpoint /interact è progettato principalmente per essere utilizzato dagli SDK Experience Platform. Questo endpoint è soggetto a cambiamenti aggiuntivi e il suo comportamento può evolvere senza preavviso. Ad esempio, nuovi elementi potrebbero essere aggiunti al payload di risposta in futuro.

La risposta del server include uno o più oggetti Handle, come illustrato di seguito.

Esempio di chiamata API

Formato API format

POST /ee/v2/interact

Richiesta request

curl -X POST "https://server.adobedc.net/ee/v2/interact?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 '{
   "event": {
      "xdm": {
         "identityMap": {
            "Email_LC_SHA256": [
               {
                  "id": "0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b",
                  "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"
      }
   }
}'
Parametro
Tipo
Obbligatorio
Descrizione
dataStreamId
String
Sì.
ID dello stream di dati.
requestId
String
No
Fornisci un ID casuale client per correlare le richieste interne del server. Se non viene fornito nessuno, l’Edge Network ne genera uno e lo restituisce nella risposta.

Risposta response

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 OK, con uno o più oggetti Handle, a seconda dei servizi edge in tempo reale abilitati nella configurazione dello stream di dati.

{
   "requestId": "c85402f5-83a1-4fb3-abdd-f4c17bf6dd49",
   "handle": []
}
recommendation-more-help
f36c2cef-1417-40aa-a11d-5d0abaee121b