[Alpha]{class="badge informative"}

data (Server SDK)

Questa pagina descrive data nel metodo Server SDK sendEvent. Per il Web SDK, vedere data.

L’oggetto data consente di inviare dati che non corrispondono a uno schema XDM. È utile per i dati letti direttamente da uno specifico servizio Adobe, ad esempio Adobe Analytics o Adobe Target, o per i dati mappati su campi XDM nello stream di dati. Quando i dati arrivano al flusso di dati, puoi utilizzare Preparazione dati per raccolta dati per mappare ogni campo nell’oggetto data a un campo XDM.

IMPORTANT
Ogni proprietà nell'oggetto data deve essere utilizzata in almeno uno dei seguenti modi:
  • Un servizio nello stream di dati è configurato per leggerlo.
  • Viene mappato a un campo XDM utilizzando la preparazione dati.
Se una proprietà non è mappata a un campo XDM o utilizzata da un servizio configurato, tali dati vengono persi in modo permanente.

Impostare l’oggetto data quando si chiama sendEvent. Per i dati che intendi mappare nel flusso di dati, puoi strutturare questo oggetto come preferisci. Per i dati letti da un servizio specifico, utilizza la struttura prevista dal servizio. È possibile includere sia l’oggetto data che l’oggetto xdm nella stessa chiamata. L’oggetto xdm deve comunque includere una identità primaria.

await visitor.sendEvent({
  xdm: {
    eventType: "web.webpagedetails.pageViews",
    identityMap: {
      Email: [{ id: "visitor@example.com", primary: true }]
    }
  },
  data: {
    loyaltyTier: "gold",
    cartItemCount: 3
  }
});

Il callback onBeforeEventSend riceve l’oggetto data, quindi è possibile modificarlo prima che SDK invii l’evento.

Usa l’oggetto data con Adobe Analytics analytics

È possibile utilizzare l’oggetto data per inviare dati a una suite di rapporti di Adobe Analytics senza uno schema XDM. Le variabili utilizzano la stessa sintassi delle variabili di AppMeasurement. Vedi Mappatura della variabile dell’oggetto dati su Adobe Analytics nella guida all’implementazione di Adobe Analytics.

await visitor.sendEvent({
  xdm: {
    identityMap: {
      Email: [{ id: "visitor@example.com", primary: true }]
    }
  },
  data: {
    __adobe: {
      analytics: {
        pageName: "Order confirmation",
        eVar1: "Server-side value"
      }
    }
  }
});
recommendation-more-help
experience-platform-help-collection