contextData

コンテキストデータ変数を使用すると、処理ルールで読み取ることのできる各ページにカスタム変数を定義できます。コード内の Analytics 変数に値を明示的に割り当てる代わりに、コンテキストデータ変数でデータを送信できます。次に、処理ルールは、コンテキストデータ変数の値を取得し、それぞれの Analytics 変数に渡します。『管理ユーザガイド』の「処理ルール」を参照してください。

コンテキストデータ変数は、開発チームが番号付き変数ではなく名前付きの要素でデータを収集する場合に役立ちます。例えば、開発チームにページの作成者の eVar10 への割り当てをリクエストする代わりに、s.contextData["author"] への割り当てをリクエストできます。その後、組織の Analytics 管理者は、コンテキストデータ変数をレポート用の Analytics 変数にマップする処理ルールを作成できます。Adobeチームが心配するのは、最終的に、開発で多くのページ変数が提供されるのではなく、コンテキストデータ変数のみです。

Web SDK を使用したコンテキストデータ変数

XDM オブジェクト を使用する場合、Adobe Analytics変数にマッピングされないすべてのフィールドがコンテキストデータ変数として自動的に含まれます。 XDM オブジェクトを使用してコンテキストデータを明示的に設定することもできます。 その後、 処理ルールを使用してコンテキストデータ変数を目的の Analytics 変数に割り当てることができます。 詳しくは 他の XDM フィールドの Analytics 変数へのマッピングを参照してください。

data object を使用する場合、すべてのコンテキストデータ変数はキーと値のペアとして data.__adobe.analytics.contextData 内に存在します。

alloy("sendEvent", {
  "data": {
    "__adobe": {
      "analytics": {
        "contextData": {
          "example_variable": "Example value",
          "second_example": "Another value"
        }
      }
    }
  }
});

処理ルールインターフェイスの該当するドロップダウンメニューには、c.example_variable と c.second_example が表示されます。

Adobe Analytics 拡張機能を使用したコンテキストデータ変数

Adobe Experience Platform データ収集には、コンテキストデータ変数を設定するための専用の場所がありません。AppMeasurement 構文に従って、カスタムコードエディターを使用します。

AppMeasurement および Analytics 拡張機能のカスタムコードエディターの s.contextData

s.contextData 変数は値を直接取りません。代わりに、この変数のプロパティを文字列に設定します。

// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";

処理ルールを使用した Analytics 変数の入力

処理ルールは、保存するとすぐに有効になります。履歴データには適用されません。

リンクトラッキングコールでのコンテキストデータの送信

コンテキストデータ変数を contextData のプロパティとして s.linkTrackVars に含めます。

s.contextData["example_variable"] = "Example value";
s.linkTrackVars = "contextData.example_variable";
s.tl(true,"o","Example context data link");

コンテキストデータ変数を使用したイベントの増分

処理ルールを作成する際に、コンテキストデータ変数をイベントに割り当てることができます。

// Assigning this context data variable to an event increments it by one
s.contextData["example_text"] = "Text value";

// Assigning this context data variable to an event increments it by four
s.contextData["example_number"] = "4";