prop

このヘルプページでは、prop の実装方法について説明します。prop がディメンションとして機能する方法について詳しくは、『コンポーネントユーザガイド』の prop を参照してください。

Prop は、好きなだけ使用できるカスタム変数です。prop は、設定されたヒットの後は保持されません。

ソリューションデザインドキュメントがある場合、これらのカスタムディメンションを組織に固有の値に割り当てることができます。使用可能な prop の数は、アドビとの契約によって異なります。アドビとの契約でサポートされている場合は、最大 75 個の prop を使用できます。

Web SDK を使用した prop

prop は、次の変数にマッピングされます。

Adobe Analytics 拡張機能を使用した prop

Prop は、Analytics 拡張機能の設定時（グローバル変数）またはルールで設定できます。

Prop 値またはデータ要素に設定できます。別の Analytics 変数から値をコピーすることもできます。

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

各 prop 変数は、組織固有のカスタム値を含む文字列です。最大長は 100 バイトです。100 バイトを超える値は、アドビに送信する際に自動的に切り捨てられます。

s.prop1 = "Example custom value";

リスト prop

リスト prop は、変数が同じヒット内の複数の値を保持できるようにする prop に適用される設定です。この設定が有効でない場合、または誤った区切り文字が使用された場合、変数は単一の値として扱われます。

リスト prop の設定

レポートスイート設定のトラフィック変数でリスト prop を有効にします。目的の区切り文字が正しく設定されていることを確認します。デフォルトの区切り文字は提供されません。

Web SDK を使用したリスト prop の設定 list-props-web-sdk

XDM オブジェクト を使用する場合、リスト prop は xdm._experience.analytics.customDimensions.listProps.prop1.values[] ～ xdm._experience.analytics.customDimensions.listProps.prop75.values[] にマッピングされます。 Web SDK は、レポートスイート設定にリストされた正しい区切り文字を自動的に使用します。XDM フィールドで区切り文字を設定すると（例えば、xdm._experience.analytics.customDimensions.props.prop1.delimiter）、レポートスイート設定から自動的に取得された区切り文字が上書きされ、リスト prop 文字列の間違った解析につながる可能性があります。

data オブジェクト を使用する場合、list prop は標準 prop と同じフィールドを使用し、AppMeasurementの構文に従います。

Adobe Analytics 拡張機能および AppMeasurement を使用したリスト prop の設定

目的の区切り文字を使用してレポートスイートの設定でリスト prop を設定した後は、区切り文字を使用する以外に実装上の違いはありません。

// List prop delimited with a comma
s.prop1 = "value1,value2,value3";

リスト prop で同じ値を複数回設定した場合、レポートでは重複が排除されます。Analysis Workspace は、値が表示されたヒットの数をカウントし、値がデータに存在する回数はカウントしません。