contextData

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

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

すべてのコンテキストデータ変数（キーと値を含む）の最大サイズは32 KBです。

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

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

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

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

処理ルール ​ インターフェイスには、該当するドロップダウンメニューにexample_variableと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";