prop

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

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

TIP
ほとんどの場合、eVar の使用をお勧めします。以前のバージョンの Adobe Analytics では、prop と eVar は互いに比べた利点と欠点がありました。ただし、Adobeは eVar を改善し、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.prop1data.__adobe.analytics.prop75、または data.__adobe.analytics.c1data.__adobe.analytics.c75 - リスト prop がこれらのフィールドに含まれます。

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

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

  1. Adobe ID 資格情報を使用して、Adobe Experience Platform Data Collection にログインします。
  2. 目的のタグプロパティをクリックします。
  3. 「ルール」タブに移動し、目的のルールをクリックします(またはルールを作成します)。
  4. 「アクション」で、既存の「Adobe Analytics - 変数を設定」アクションをクリックするか、「+」アイコンをクリックします。
  5. 「​ 拡張機能 ​」ドロップダウンリストをAdobe Analyticsに設定し、「​ アクションタイプ ​」を ​ 変数を設定 ​ に設定します。
  6. Props セクションを見つけます。

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

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

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

s.prop1 = "Example custom value";

リスト prop

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

リスト prop の設定

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

TIP
実装で使用される一般的な区切り文字は、コンマ(,)、コロン(:)、セミコロン(;)、パイプ(|)です。実装に最適な任意の非拡張 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 文字列の間違った解析につながる可能性があります。

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

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

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

// List prop delimited with a comma
s.prop1 = "value1,value2,value3";
IMPORTANT
リスト prop は、100 バイトの最大長に依存します。リスト prop は複数の値を含む可能性があるので、この制限に達しやすく切り捨てられます。この 100 バイトの制限に達した場合は、省略形や短縮値の使用を検討してください。

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

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690