データ収集設定 data-collection
この設定セクションでは、拡張機能でデータが収集される方法を指定できます。
- Adobe IDの資格情報を使用してCX Enterpriseにログインします。
- データ収集 > タグに移動します。
- 目的のタグプロパティを選択します。
- Extensionsに移動し、Adobe Experience Platform Web SDK カードの Configure を選択します。
- 「データ収集」セクションまでスクロールします。
タグ UIのWeb SDK タグ拡張機能のデータ収集設定を示す
次のオプションがあります。
イベントがコールバックを送信する前
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に相当するタグです。
内部リンクのクリックを収集
サイトまたはプロパティ内のリンクトラッキングデータの収集を有効にするチェックボックス。 このチェックボックスは、JavaScript ライブラリのclickCollection.internalLinkEnabledに相当するタグです。 このチェックボックスを有効にすると、イベントのグループ化オプションが表示されます。
- イベントグループ化なし: リンクトラッキングデータは別々のイベントでAdobeに送信されます。 別のイベントで送信されたリンククリックは、Adobe Experience Platformに送信されたデータの契約上の使用率を高めることができます。
- セッションストレージを使用したイベントのグループ化:次の「ページビュー」イベントまで、セッションストレージにリンク追跡データを保存します。 「ページビュー」と見なされる次のイベントでは、保存されたリンク追跡データが「ページビュー」イベントペイロードと結合されます。 Adobeでは、内部リンクをトラッキングする際にこの設定を有効にすることをお勧めします。
- ローカルオブジェクトを使用したイベントグループ化:次の「ページビュー」イベントまで、リンクトラッキングデータをローカルオブジェクトに保存します。 訪問者が新しいブラウザーページに移動すると、リンク追跡データが失われます。 この設定は、シングルページアプリケーションのコンテキストで最も有益です。
タグライブラリは、ペイロードに次の要素が含まれている場合、特定のイベントを「ページビュー」と見なします。
xdm.web.webPageDetails.nameには文字列値が含まれていますxdm.web.webPageDetails.pageViews.valueが0より大きい
外部リンクのクリックを収集
外部リンクの収集を有効にするチェックボックス。 このチェックボックスは、JavaScript ライブラリのclickCollection.externalLinkEnabledに相当するタグです。
ダウンロードリンクのクリック数を収集
ダウンロードリンクの収集を有効にするチェックボックス。 このチェックボックスは、JavaScript ライブラリのclickCollection.downloadLinkEnabledに相当するタグです。
リンク修飾子のダウンロード
リンク URLをダウンロードリンクとして修飾する正規表現。 この文字列は、JavaScript ライブラリのdownloadLinkQualifierに相当するタグです。
クリックのプロパティをフィルター
コレクションの前に、クリック関連のプロパティを評価および変更するコールバック関数。 この関数は、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に相当するタグです。 クリックプロパティをフィルター コールバックを使用してクリックデータをフィルターまたは調整するか、イベント送信前のコールバックを使用して、Adobeに送信されるペイロード全体をフィルターまたは調整します。 フィルタークリックのプロパティ コールバックとOn before link click send コールバックの両方が設定されている場合、フィルタークリックのプロパティ コールバックのみが実行されます。コンテキスト設定
特定のXDM フィールドに情報を入力する訪問者情報を自動的に収集します。 すべてのデフォルトのコンテキスト情報または 特定のコンテキスト情報 を選択できます。 これは、JavaScript ライブラリのcontextに相当するタグです。
- Web:現在のページに関する情報を収集します。
- デバイス: ユーザーのデバイスに関する情報を収集します。
- 環境: ユーザーのブラウザーに関する情報を収集します。
- 場所コンテキスト: ユーザーの場所に関する情報を収集します。
- 高エントロピーのuser-agent ヒント: ユーザーのデバイスに関するより詳細な情報を収集します。
- Adobe Analyticsにリファラーを送信するのは、ページビューごとに1回のみです:重複するリファラーデータがAdobe Analyticsに送信されるのを防ぎます。