clickCollection
この clickCollection オブジェクトには、自動的に収集されたリンクデータの制御に役立つ変数がいくつか含まれています。 これらの変数は、データ収集にリンクタイプを含める場合や除外する場合に使用します。
それには次が必要です clickCollectionEnabled を有効にします。
Web SDK 2.25.0 以降でサポートされています。
では次の変数を使用できます。 clickCollection オブジェクト :
-
clickCollection.internalLinkEnabled：現在のドメイン内のリンクを自動的に追跡するかどうかを決定するブール値です。 例：https://example.com/index.html対象：https://example.com/product.html. -
clickCollection.downloadLinkEnabled：に基づいてダウンロードと認定されるリンクをライブラリが追跡するかどうかを決定するブール値downloadLinkQualifierプロパティ。 -
clickCollection.externalLinkEnabled：外部ドメインへのリンクを自動的に追跡するかどうかを決定するブール値です。 例：https://example.com対象：https://example.net. -
clickCollection.eventGroupingEnabled：リンクトラッキングデータを送信するために、次のページまでライブラリが待機するかどうかを決定するブール値です。 次のページが読み込まれたら、リンクトラッキングデータをページ読み込みイベントと組み合わせます。 このオプションを有効にすると、Adobeに送信されるイベントの数が減ります。 次の場合internalLinkEnabledが無効になっている場合は、この変数は何も行いません。 -
clickCollection.sessionStorageEnabled：リンクトラッキングデータをローカル変数ではなくセッションストレージに保存するかどうかを決定するブール値。 次の場合internalLinkEnabledまたはeventGroupingEnabledが無効になっている場合は、この変数は何も行いません。Adobeでは、を使用する場合にこの変数を有効にすることを強くお勧めします
eventGroupingEnabled. 次の場合eventGroupingEnabledは次の場合に有効になりますsessionStorageEnabledが無効になっている場合、セッションストレージに保持されないので、新しいページをクリックすると、リンクトラッキングデータが失われます。 無効にすることは可能ですがsessionStorageEnabled単一ページアプリケーションでは、非SPA ページに対しては理想的ではありません。 -
filterClickDetails：収集するリンクトラッキングデータを完全に制御できるコールバック関数。 このコールバック関数を使用して、リンクトラッキングデータの送信を変更、難読化または中止できます。 このコールバックは、リンク内の個人を特定できる情報など、特定の情報を省略する場合に役立ちます。
Web SDK タグ拡張機能を使用したコレクション設定のクリック
「」を選択します クリックデータ収集の有効化 次の場合にチェックボックス タグ拡張機能の設定. このチェックボックスをオンにすると、クリックコレクションに関する次のオプションが表示されます。
-
内部リンク
- イベント グループ化を有効にする
- セッションストレージの有効化
-
外部リンク
-
ダウンロードリンク
-
フィルタークリックのプロパティ
- へのログイン experience.adobe.com Adobe IDの資格情報を使用します。
- に移動します。 データ収集 > タグ.
- 目的のタグプロパティを選択します。
- に移動します。 拡張機能 を選択し、 設定 日 Adobe Experience Platform Web SDK カード。
- にスクロール ダウンします。 データ収集 「」セクションで、「」チェックボックスを選択します クリックデータ収集の有効化.
- 目的のクリックコレクション設定を選択します。
- クリック 保存 を作成してから、変更を公開します。
この フィルタークリックのプロパティ コールバックをクリックすると、目的のコードを挿入できるカスタムコードエディターが開きます。 コードエディター内で、次の変数にアクセスできます。
content.clickedElement：クリックされた DOM 要素。content.pageName：クリック時のページ名。content.linkName：クリックされたリンクの名前。content.linkRegion：クリックされたリンクの領域。content.linkType：リンクのタイプ（離脱、ダウンロードまたはその他）。content.linkURL：クリックされたリンクの宛先 URL。return true：現在の変数値でコールバックを直ちに終了します。return false：直ちにコールバックを終了し、データの収集を中止します。
の外部で定義された変数 content を使用できますが、Adobeに送信されるペイロードには含まれません。
Web SDK JavaScript ライブラリを使用したコレクション設定のクリック
内で必要な変数を設定します。 clickCollection を実行しているときのオブジェクト configure コマンド。 設定されていない場合、このオブジェクトのデフォルト設定は、 clickCollectionEnabled.
internalLinkEnabled：次に一致clickCollectionEnableddownloadLinkEnabled：次に一致clickCollectionEnabledexternalLinkEnabled：次に一致clickCollectionEnabledeventGroupingEnabled：デフォルトはfalse。明示的に有効にする必要がありますsessionStorageEnabled：デフォルトはfalse。明示的に有効にする必要がありますfilterClickDetails：関数が含まれていません。明示的に登録する必要があります
eventGroupingEnabledを使用できます。これは、契約上の使用状況にカウントされるイベントの数を減らすのに役立ちます。alloy("configure", {
edgeConfigId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
clickCollectionEnabled: true,
clickCollection: {
internalLinkEnabled: true,
downloadLinkEnabled: true,
externalLinkEnabled: true,
eventGroupingEnabled: true,
sessionStorageEnabled: true,
filterClickDetails: function(content) {
// If the link is a clickable telephone number, anonymize it
if(content.linkUrl?.includes("tel:")) {
content.linkName = content.linkUrl = "Phone number";
}
// If the link is an email address, anonymize it
if(content.linkUrl?.includes("mailto:")) {
content.linkName = content.linkUrl = "Email address";
}
}
}
});