データ収集の設定
この設定セクションでは、拡張機能全体でのデータの収集方法を指定できます。
- Adobe IDの資格情報を使用して experience.adobe.com にログインします。
- Data Collection／Tagsに移動します。
- 目的のタグプロパティを選択します。
- Extensions に移動し、Configure カードで Adobe Experience Platform Web SDK を選択します。
- Data collection セクションまで下にスクロールします。
次のオプションがあります。
On before event send callback
Adobeに送信されたペイロードを評価して変更するコールバック関数。 コードエディター内で、次の変数にアクセスできます。
content.xdm：イベントの XDM ペイロード。content.data：イベントのデータオブジェクトペイロード。return true：直ちにコールバックを終了し、contentオブジェクト内の現在の値を使用してデータをAdobeに送信します。return false：直ちにコールバックを終了し、Adobeへのデータの送信を中止します。
content 外で定義された変数は使用できますが、Adobeに送信されるペイロードには含まれません。
// Use nullish coalescing assignments to add objects if they don't yet exist
content.xdm.commerce ??= {};
content.xdm.commerce.order ??= {};
// Then add the purchase ID
content.xdm.commerce.order.purchaseID = "12345";
// Use optional chaining to prevent undefined errors when setting tracking code to lower case
if(content.xdm.marketing?.trackingCode) content.xdm.marketing.trackingCode = content.xdm.marketing.trackingCode.toLowerCase();
// Delete operating system version
if(content.xdm.environment) delete content.xdm.environment.operatingSystemVersion;
// Immediately end onBeforeEventSend logic and send the data to Adobe for this event type
if (content.xdm.eventType === "web.webInteraction.linkClicks") {
return true;
}
// Cancel sending data if it is a known bot
if (myBotDetector.isABot()) {
return false;
}
false を返さないようにします。 最初のイベントで false を返すと、パーソナライゼーションに悪影響を与える可能性があります。このコールバックは、JavaScript ライブラリの onBeforeEventSend と同等のタグです。
Collect internal link clicks
サイトまたはプロパティ内部のリンクトラッキングデータの収集を有効にするチェックボックス。 このチェックボックスは、JavaScript ライブラリの clickCollection.internalLinkEnabled と同等のタグです。 このチェックボックスを有効にすると、イベントのグループ化オプションが表示されます。
- No event grouping：リンクトラッキングデータは、別のイベントでAdobeに送信されます。 別々のイベントで送信されるリンククリック数は、Adobe Experience Platformに送信されるデータの契約上の使用を増やす可能性があります。
- Event grouping using session storage：次の「ページビュー」イベントまで、リンクトラッキングデータをセッションストレージに保存します。 「ページビュー」と見なされる次のイベントで、保存されたリンクトラッキングデータが「ページビュー」イベントペイロードと結合されます。 Adobeでは、内部リンクをトラッキングする場合にこの設定を有効にすることをお勧めします。
- Event grouping using local object：次の「ページビュー」イベントまで、リンクトラッキングデータをローカルオブジェクトに保存します。 訪問者が新しいブラウザーページに移動すると、リンクトラッキングデータが失われます。 この設定は、単一ページアプリケーションのコンテキストで最も役立ちます。
次の要素がペイロードに含まれる場合、タグライブラリは特定のイベントを「ページビュー」と見なします。
xdm.web.webPageDetails.nameに文字列値が含まれていますxdm.web.webPageDetails.pageViews.valueが0より大きい
Collect external link clicks
外部リンクの収集を有効にするチェックボックス。 このチェックボックスは、JavaScript ライブラリの clickCollection.externalLinkEnabled と同等のタグです。
Collect download link clicks
ダウンロードリンクの収集を有効にするチェックボックス。 このチェックボックスは、JavaScript ライブラリの clickCollection.downloadLinkEnabled と同等のタグです。
Download link qualifier
リンク URL をダウンロードリンクとして認定する正規表現。 この文字列は、JavaScript ライブラリの downloadLinkQualifier と同等のタグです。
Filter click properties
コレクションの前にクリック関連のプロパティを評価および変更するコールバック関数。 この関数は、On before event send callback の前に実行され、JavaScript ライブラリの clickCollection.filterClickDetails と同等のタグです。 コードエディター内で、次の変数にアクセスできます。
content.clickedElement：クリックされた DOM 要素。content.pageName：クリックが発生した際のページ名。content.linkName: クリックされたリンクの名前。content.linkRegion：クリックされたリンクの領域。content.linkType: リンクのタイプ（離脱、ダウンロードまたはその他）。content.linkURL：クリックされたリンクの宛先 URL。return true：現在の変数値でコールバックを直ちに終了します。return false：直ちにコールバックを終了し、データの収集を中止します。content外で定義された変数は使用できますが、Adobeに送信されるペイロードには含まれません。
onBeforeLinkClickSend と同等のタグです。 Filter click properties コールバックを使用してクリックデータをフィルタリングまたは調整するか、On before event send callback を使用してAdobeに送信されるペイロード全体をフィルタリングまたは調整します。 Filter click properties コールバックと On before link click send コールバックの両方が設定されている場合は、Filter click properties コールバックのみが実行されます。コンテキスト設定
特定の XDM フィールドに値を入力する訪問者情報を自動的に収集します。 All default context information または Specific context information を選択できます。 これは、JavaScript ライブラリの context と同等のタグです。
- Web：現在のページに関する情報を収集します。
- Device: ユーザーのデバイスに関する情報を収集します。
- Environment: ユーザーのブラウザーに関する情報を収集します。
- Place context: ユーザーの場所に関する情報を収集します。
- High entropy user-agent hints: ユーザーのデバイスに関する詳細情報を収集します。