[Alpha]{class="badge informative"}

data （Server SDK）

このページでは、Server SDK sendEvent メソッドのdataについて説明します。 Web SDKについては、dataを参照してください。

data オブジェクトを使用すると、XDM スキーマに一致しないデータを送信できます。 これは、Adobe AnalyticsやAdobe Targetなど、特定のAdobe サービスが直接読み取るデータや、データストリームのXDM フィールドにマッピングするデータに役立ちます。 データがデータストリームに到達したら、​ データ収集のためのデータ準備を使用して、data オブジェクトの各フィールドをXDM フィールドにマッピングできます。

sendEventを呼び出すときにdata オブジェクトを設定します。 データストリームにマッピングするデータについては、このオブジェクトを好きなように構造化できます。 特定のサービスが読み取るデータには、サービスが期待する構造を使用します。 data オブジェクトとxdm オブジェクトの両方を同じ呼び出しに含めることができます。 xdm オブジェクトには、​ プライマリ IDを含める必要があります。

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

onBeforeEventSend コールバックはdata オブジェクトを受け取るので、SDKがイベントを送信する前に変更できます。

Adobe Analyticsでのdata オブジェクトの使用 analytics

data オブジェクトを使用して、XDM スキーマを使用せずにAdobe Analytics レポートスイートにデータを送信できます。 変数は、AppMeasurement変数と同じ構文を使用します。 Adobe Analytics実装ガイドの「Adobe Analyticsへのデータオブジェクト変数のマッピング ​」を参照してください。

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