データ収集設定 data-collection

この設定セクションでは、拡張機能でデータが収集される方法を指定できます。

  1. Adobe IDの資格情報を使用してexperience.adobe.comにログインします。
  2. Data CollectionTags​に移動します。
  3. 目的のタグプロパティを選択します。
  4. Extensions​に移動し、Adobe Experience Platform Web SDK カードの​ Configure ​を選択します。
  5. Data collection セクションまでスクロールします。

タグ UIのWeb SDK タグ拡張機能のデータ収集設定を示す 画像。

次のオプションがあります。

On before event send callback

Adobeに送信されるペイロードを評価および変更するコールバック関数。 コードエディターでは、次の変数にアクセスできます。

  • content.xdm: イベントのXDM ペイロード。
  • content.data: イベントのデータオブジェクトペイロード。
  • return true: コールバックをすぐに終了し、content オブジェクトの現在の値を使用してAdobeにデータを送信します。
  • return false: コールバックをすぐに終了し、Adobeへのデータ送信を中止します。

content以外で定義された変数は使用できますが、Adobeに送信されるペイロードには含まれません。

WARNING
このコールバックでは、カスタムコードを使用できます。 コールバックに含めるコードで捕捉されない例外がスローされた場合、イベントの処理は停止します。 データは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;
}
TIP
ページの最初のイベントでfalseを返さないようにします。 最初のイベントでfalseを返すと、パーソナライゼーションに悪影響を及ぼす可能性があります。

このコールバックは、JavaScript ライブラリのonBeforeEventSendに相当するタグです。

サイトまたはプロパティ内のリンクトラッキングデータの収集を有効にするチェックボックス。 このチェックボックスは、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.value0より大きい

外部リンクの収集を有効にするチェックボックス。 このチェックボックスは、JavaScript ライブラリのclickCollection.externalLinkEnabledに相当するタグです。

ダウンロードリンクの収集を有効にするチェックボックス。 このチェックボックスは、JavaScript ライブラリのclickCollection.downloadLinkEnabledに相当するタグです。

リンク 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に送信されるペイロードには含まれません。
TIP
On before link click send フィールドは、既に設定されているプロパティにのみ表示される非推奨のコールバックです。 これは、JavaScript ライブラリの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: ユーザーのデバイスに関する詳細情報を収集します。
  • Send referrer to Adobe Analytics only once per page view:重複するリファラーデータがAdobe Analyticsに送信されないようにします。
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743