prop
このヘルプページでは、prop の実装方法について説明します。 prop がディメンションとして機能する方法について詳しくは、『コンポーネントユーザガイド』の prop を参照してください。
prop は、任意の用途に使用できるカスタム変数です。 prop は、設定されたヒットの後は保持されません。
ソリューションデザインドキュメントがある場合、これらのカスタムディメンションを組織に固有の値に割り当てることができます。 使用可能な prop の数は、アドビとの契約によって異なります。 アドビとの契約でサポートされている場合は、最大 75 個の prop を使用できます。
Web SDK を使用した prop
Propは次の変数にマッピングされます。
- XDM オブジェクト :
xdm._experience.analytics.customDimensions.props.prop1-xdm._experience.analytics.customDimensions.props.prop75- リスト propが個のフィールドのセット で指定されています。 - データオブジェクト :
data.__adobe.analytics.prop1-data.__adobe.analytics.prop75、またはdata.__adobe.analytics.c1-data.__adobe.analytics.c75- リスト propはこれらのフィールドに含まれています。
Adobe Analytics 拡張機能での prop
prop は、Analytics 拡張機能の設定時(グローバル変数)またはルールで設定できます。
- Adobe ID 資格情報を使用して、Adobe Experience Platform Data Collection にログインします。
- 目的のタグプロパティをクリックします。
- 「ルール」タブに移動し、目的のルールをクリックします(またはルールを作成します)。
- 「アクション」で、既存の「Adobe Analytics - 変数を設定」アクションをクリックするか、「+」アイコンをクリックします。
- 拡張機能ドロップダウンリストを Adobe Analytics に設定し、アクションタイプを変数を設定に設定します。
- Props セクションを見つけます。
Prop 値またはデータ要素に設定できます。 別の Adobe Analytics 変数から値をコピーすることもできます。
AppMeasurement および Analytics 拡張機能のカスタムコードエディターでの s.prop1 ~ s.prop75
各 prop 変数は、組織固有のカスタム値を含む文字列です。 最大長は 100 バイトです。100 バイトを超える値は、アドビに送信する際に自動的に切り捨てられます。
s.prop1 = "Example custom value";
リスト prop
リスト prop は、変数が同じヒット内の複数の値を保持できるようにする prop に適用される設定です。 この設定が有効でない場合、または誤った区切りが使用された場合、変数は単一の値として扱われます。
リスト prop の設定
レポートスイート設定のトラフィック変数でリスト prop を有効にします。 目的の区切りが正しく設定されていることを確認します。 アドビはデフォルトの区切りを提供していません。
,)、コロン(:)、セミコロン(;)、パイプ(|)です。 実装に最適な任意の非拡張 ASCII 区切りを使用できます。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 文字列の間違った解析につながる可能性があります。
データオブジェクトを使用する場合、リスト propは標準propと同じフィールドを使用し、AppMeasurementの構文に従います。
Adobe Analytics 拡張機能および AppMeasurement を使用したリスト prop の設定
目的の区切りを使用してレポートスイートの設定でリスト prop を設定した後は、区切りを使用する以外に実装上の違いはありません。
// List prop delimited with a comma
s.prop1 = "value1,value2,value3";
リスト prop で同じ値を複数回セットした場合、レポート上では重複が排除されます。 Analysis Workspace は、値が表示されたヒットの数をカウントし、値がデータに存在する回数はカウントしません。