Content Analytics データ収集
この記事では、Content Analytics でデータを収集する方法について詳しく説明します。
定義
この記事のコンテキストでは、次の定義を使用します。
-
エクスペリエンス:
- web チャネルの場合、エクスペリエンスはweb ページ全体のテキストコンテンツとして定義されます。 データ収集の場合、Content Analyticsはページ URLに基づくエクスペリエンス IDを記録します。 その後、ページ上のテキストが取得サービスを通じて取得されます。
- mobile チャネルでは、Adobe Experience Platform Mobile SDKのContent Analytics拡張機能を使用して、モバイルアプリでエクスペリエンスが定義および追跡されます。
-
エクスペリエンス ID:
-
Web チャネルの場合、エクスペリエンス IDは、関連するURL (ベース URLとページ上のコンテンツを駆動するパラメーター)と エクスペリエンス バージョン の一意の組み合わせです。
-
mobile チャネルの場合、エクスペリエンス IDは、
registerExperienceAPI呼び出しを使用したの戻り値です。
-
-
アセット:画像。 Content Analytics では、アセット URL を記録します。
-
アセット ID:アセットの URL。
-
関連 URL:ベース URL と、ページ上のコンテンツを駆動するパラメーター。
機能
Content Analyticsでは、コンテンツイベントデータを収集するには、Experience Platform Edge Network Web SDK(web チャネル用)とExperience Platform Edge Network モバイルSDK(モバイルチャネル用)が必要です。 このイベントデータは、Experience Platform Edge Network(Web SDK、モバイルSDK、またはServer API)またはAdobe AppMeasurementなどのAnalytics ソースコネクタを使用して、既存の行動データと組み合わされます。
Content Analytics ライブラリでは、次の場合にデータを収集します。
- Content Analyticsは、ページに読み込まれるか、モバイルアプリ内で使用されるタグライブラリに含まれています。
- ページ URLとアセット URLは、含まれるタグライブラリの一部であるContent Analytics web拡張機能で設定されます。
- アセット URL、アセットの場所またはエクスペリエンスの場所は、Content Analytics モバイル拡張機能では除外されません。
Content Analytics イベント
この節では、web Content Analytics イベントの詳細について説明します。 モバイル Content Analytics イベントの詳細については、 エクスペリエンスのトラッキング を参照してください。
Content Analytics イベントは、以下で構成されます。
-
標準フィールド
- タイムスタンプ
- ID
-
エクスペリエンスビュー数(存在する場合と設定されている場合)
-
エクスペリエンスクリック数(存在する場合と設定されている場合)
-
アセットビュー数(存在する場合と設定されている場合)
-
アセットクリック数(存在する場合と設定されている場合)
Content Analytics イベントは、次のシーケンスとして収集されます。
- 録画ビューまたはクリック 。
- Content Analytics イベントを送信するためのトリガー。
コンテンツ分析では、ビューまたはクリックを個別に収集し、そのビューまたはクリックの直後のイベントを収集する代わりに、シーケンスを反映するのにこの方法でデータを収集します。 また、コンテンツ分析データを収集するこの方法では、収集されるデータの量も削減されます。
記録されたビューまたはクリック
アセットビューは、次の場合に記録されます。
- Content Analytics 拡張機能の設定ごとにアセットが除外されていない。
- アセットの 75%が表示される。
- そのアセットがこのページにまだ記録されていない。
アセットクリックは、次の場合に記録されます。
- アセットが表示される。
- Content Analytics 拡張機能の設定ごとにアセットが除外されていない。
- リンクであるアセットを直接クリックすると、別のページに移動します。
エクスペリエンスビューは、次の場合に記録されます。
- エクスペリエンスが、Content Analytics 設定で有効になっている。
エクスペリエンスクリックは、次の場合に記録されます。
- 有効なリンクをクリックすると、エクスペリエンスがトリガーされます。
コンテンツ分析イベントを送信するトリガー
ページから送信されるネットワークリクエストの数を減らすために、Content Analyticsは情報を収集しますが、その情報をすぐに送信しません。 コンテンツインタラクション情報が収集され、その情報を含むイベントは、次のいずれかのトリガーが発生した場合にのみ送信されます。
-
Web SDKまたはAdobe AppMeasurementがイベントを送信します。
-
表示が非表示に変更される。例:
- ページのアンロード
- タブを切り替え
- ブラウザーを最小化
- ブラウザーを閉じる
- 画面をロック
-
URL が変更され、関連する URL が変更される。
-
記録され、送信可能なアセットビューは32を超えています。
ID
この節では、Content AnalyticsでのIDの処理方法について説明します。
Web
Content Analyticsは、次の方法でweb チャネルのIDを処理します。
- ECID は、コンテンツ分析スキーマの
identityMap部分に自動的に入力されます。 identityMapに他の ID 値が必要な場合は、Web SDK 拡張機能内のonBeforeEventSendコールバックでこれらの値を設定する必要があります。- スキーマはシステム所有なので、フィールドベースのステッチはサポートされていません。 したがって、フィールドベースのステッチをサポートするために、スキーマに別のフィールドを追加することはできません。
Content Analytics ID データとWeb SDK データ ID データがフィールドレベルで正しく結合されていることを確認するには、イベント send🔗 コールバックの前にWeb SDK を変更します。
-
Adobe Experience Platform Web SDK 拡張機能と Adobe コンテンツ分析拡張機能を含む タグ プロパティに移動します。
-
拡張機能 を選択します。 -
Adobe Experience Platform Web SDK 拡張機能を選択します。
-
「設定」を選択します。
-
「SDK インスタンス」セクションで、「データ収集 - 「イベント送信の前にオン」コールバック」までスクロールします。
-
「</> 「イベント送信の前にオン」コールバックコードを指定」を選択します。
-
次のコードを追加します。
code language-javascript window.adobeContentAnalytics?.forwardEvent(content); content.xdm.identityMap = _satellite.getVar('identityMap'); if ((content.xdm.eventType === "content.contentEngagement") && (_satellite.getVar('identityMap') != null)) { return true; }
-
「保存」を選択してコードを保存します。
-
「保存」を選択して拡張機能を保存します。
-
タグプロパティの更新を公開します。
モバイル
モバイルアプリでIDを操作する方法について詳しくは、Experience Cloud ID サービス拡張機能およびEdge Network モバイル拡張機能のIDを参照してください。
モバイルアプリでIDが変更されるとすぐに、Content Analytics データの現在の バッチ がリセットされ、新しいIDのContent Analytics データの新しいコレクションが開始されます。
スキーマ
Experience Platformは、特定のContent Analytics スキーマに基づいて、データセット内のContent Analytics データを収集します。 参照スキーマは、次の記事で公開されています。