autoTrackPropositionInteractionsEnabled
autoTrackPropositionInteractionsEnabled
プロパティは、Web SDK が提案インタラクションを自動的に収集するかどうかを決定するオプション設定です。
この値は決定プロバイダーのマップで、各決定プロバイダーには、自動提案インタラクションの処理方法を示す値が設定されています。
サポートされている値 supported-values
デフォルトでは、自動提案インタラクションは、Adobe Journey Optimizer(AJO
)には 常に 収集され、Adobe Target(TGT
)には 収集されません。
デフォルト値の autoTrackPropositionInteractions
は次のとおりです。
{
"AJO": "always",
"TGT": "never"
}
各決定プロバイダーでサポートされる設定値について詳しくは、以下の表を参照してください。
always
interact
常に自動的に収集されます。never
interact
自動的に収集されることはありません。decoratedElementsOnly
interact
イベントを自動的に収集しますが、その要素にラベルまたはトークンを指定するデータ属性が含まれている場合に限ります。自動提案インタラクショントラッキング logic
自動提案インタラクショントラッキングを有効にすると、DOM にレンダリングされた提案要素内のクリックが、Web SDK によって自動的に収集されます。 これには、Web SDK によって DOM に自動的にレンダリングされたエクスペリエンスと、applyPropositions
コマンドを使用して DOM にレンダリングされたエクスペリエンスが含まれます。
データ属性 data-attributes
要素にデータ属性を使用して、インタラクションに特異性を追加できます。
data-aep-click-label
data-aep-click-token
data-aep-interact-id
例
データ属性の使用例を表示するには、以下のコードスニペットを参照してください。
<div class="row movies" data-aep-interact-id="5">
<div class="col-md-4 movie" data-aep-click-token="wlpk/z/qyDGoFGF1E47O0w">
<img src="/img/walle.jpg" class="poster" />
<h2>WALL·E</h2>
<p class="description"> In a distant, but not so unrealistic, future where mankind has abandoned earth because it has become covered with trash from products sold by the powerful multi-national Buy N Large corporation, WALL-E, a garbage collecting robot has been left to clean up the mess. </p>
<p>
<button class="btn btn-default" data-aep-click-label="view-movie-WALL·E"> View details >> </button>
</p>
</div>
<div class="col-md-4 movie" data-aep-click-token="6ZUrou9BVKIsINIAqxylzw">
<img src="/img/ratatouille.jpg" class="poster" />
<h2>Ratatouille</h2>
<p class="description"> A rat named Remy dreams of becoming a great French chef despite his family's wishes and the obvious problem of being a rat in a decidedly rodent-phobic profession. When fate places Remy in the sewers of Paris, he finds himself ideally situated beneath a restaurant made famous by his culinary hero, Auguste Gusteau. </p>
<p>
<button class="btn btn-default" data-aep-click-label="view-movie-Ratatouille"> View details >> </button>
</p>
</div>
<div class="col-md-4 movie" data-aep-click-token="QuuXntMRGnCP/AsZHf4pnQ">
<img src="/img/coco.jpg" class="poster" />
<h2>Coco</h2>
<p class="description"> Despite his family's baffling generations-old ban on music, Miguel dreams of becoming an accomplished musician like his idol, Ernesto de la Cruz. Desperate to prove his talent, Miguel finds himself in the stunning and colorful Land of the Dead following a mysterious chain of events. </p>
<p>
<button class="btn btn-default" data-aep-click-label="view-movie-Coco"> View details >> </button>
</p>
</div>
</div>
applyPropositions
コマンド apply-propositions
このコマンドの動作については、applyPropositions
のドキュメントを参照してください。
applyPropositions
コマンドは、DOM に提案をレンダリングする便利な方法です。 ただし、JSON
を使用したコードベースのキャンペーンの場合、このコマンドを使用して、既存の DOM 要素(または JSON
の値に基づいて画面にレンダリングされたアプリケーションコード)を提案に関連付けることができます。
この関連付けにより、その要素の自動インタラクショントラッキングがアクティブ化され、その要素に適切な提案が割り当てられます。 それには、actionType
を track
に設定します。
例
alloy("sendEvent", {
renderDecisions: true,
}).then((result) => {
const {
propositions = []
} = result;
const proposition = propositions.find(
(proposition) => proposition.scope === "web://mywebsite.com/#weather-widget"
);
if (proposition) {
renderWeatherWidget(proposition); // custom code that renders the weather widget based on the code-based campaign JSON
alloy("applyPropositions", {
propositions: [proposition],
metadata: {
"web://mywebsite.com/#weather-widget": {
selector: "#weather-widget",
actionType: "track",
},
},
});
}
});
Web SDK タグ拡張機能を使用した自動提案およびインタラクションのクリック追跡を有効にします tag-extension
- Adobe ID資格情報を使用して experience.adobe.com にログインします。
- データ収集/タグ に移動します。
- Desire タグプロパティを選択します。
- 拡張機能 に移動し、Adobe Experience Platform Web SDK カードで 設定 を選択します。
- 「データ収集」セクションまでスクロールし、「提案とインタラクションリンクトラッキングを有効にする」チェックボックスを選択します。
- 「保存」を選択して、変更を公開します。
Web SDK JavaScript ライブラリを介した自動提案およびインタラクション リンクトラッキングを有効にします library
Web SDK では、提案トラッキングがデフォルトで有効になっています。 ただし、configure
コマンドを実行する際に autoTrackPropositionInteractionsEnabled
値を使用すると、さらに設定できます。
Web SDK の設定時にこのプロパティを省略すると、デフォルトは {"AJO": "always", "TGT": "never"}
になります。 提案のインタラクションを自動的に追跡しない場合は、値を {"AJO": "never", "TGT": "never"}
に設定します。
alloy("configure", {
"edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
"orgId": "ADB3LETTERSANDNUMBERS@AdobeOrg",
"autoTrackPropositionInteractionsEnabled": {"AJO": "always", "TGT": "never"}
});