Adobe AnalyticsのExperience Platformへの接続
このガイドでは、Adobe Analytics ソースを使用して Analytics レポートスイートデータをAdobe Experience Platformに取り込む方法を説明します。
基本を学ぶ
このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
- エクスペリエンスデータモデルl（XDM）システム：Experience Platform が顧客体験データを整理するための標準化されたフレームワークです。
- リアルタイム顧客プロファイル：複数のソースから集計したデータに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
- サンドボックス : Experience Platformには、1 つのExperience Platform インスタンスを別々の仮想環境に分割し、デジタルエクスペリエンスアプリケーションの開発と発展に役立つ仮想サンドボックスが用意されています。
主な用語
このドキュメントで使用される以下の主な用語を理解することが重要です。
- 標準属性：標準属性は、アドビで事前定義された任意の属性です。 これらはすべての顧客に対して同じ意味を持ち、Analytics ソースデータと Analytics スキーマフィールドグループで利用可能です。
- カスタム属性：カスタム属性とは、Analytics のカスタム変数階層にある任意の属性のことです。 カスタム属性は、Adobe Analyticsの実装内で特定の情報をレポートスイートに取り込むために使用され、レポートスイートごとに使用方法が異なる場合があります。 カスタム属性には、eVar、prop およびリストが含まれます。eVar について詳しくは、以下の コンバージョン変数に関する Analytics ドキュメント を参照してください。
- カスタムフィールドグループ内の任意の属性：顧客が作成したフィールドグループから派生する属性はすべてユーザー定義であり、標準属性でもカスタム属性でもないとみなされます。
ソースカタログのナビゲート
- データレイクへの履歴レポートスイートデータの 13 か月のバックフィルを行うデータフロー。 このデータフローは、バックフィルが完了すると終了します。
- ライブデータをデータレイクと Real-Time Customer Profile に送信するデータフローフロー。 このデータフローは継続的に実行されます。
Experience Platformの UI で、左側のナビゲーションから「Sources」を選択して、「Sources」ワークスペースにアクセスします。 Adobe applications カテゴリで、Adobe Analytics カードを選択し、「Add data」を選択します。
データの選択
- 画面に表示されるレポートスイートは、様々な地域のレポートスイートである可能性があります。 お客様は、お客様のデータの制限事項や義務およびAdobe Experience Platformのクロスリージョンにおけるデータの使用方法を理解する責任を負います。 会社で許可されていることを確認してください。
- 複数のレポートスイートのデータをリアルタイム顧客プロファイルに対して有効にできるのは、異なる意味を持つ 2 つのカスタムプロパティ（eVar、リスト、prop）など、データの競合がない場合のみです。
レポートスイートは、Analytics レポートの基礎を形成するデータのコンテナです。 組織は、それぞれに異なるデータセットを含む、多数のレポートスイートを持つことができます。
ソース接続が作成されているExperience Platform サンドボックスインスタンスと同じ組織にマッピングされている限り、任意の地域（米国、英国またはシンガポール）からレポートスイートを取り込むことができます。 レポートスイートは、1 つのアクティブなデータフローのみを使用して取り込むことができます。 レポートスイートがグレーで選択できない場合は、使用しているサンドボックスまたは別のサンドボックスで、既に取り込まれています。
複数のインバウンド接続を使用して、複数のレポートスイートを同じサンドボックスに取り込むことができます。 変数（eVar やイベントなど）のスキーマが異なるレポートスイートの場合は、カスタムフィールドグループの特定のフィールドにマッピングし、 データ準備 を使用してデータの競合を回避する必要があります。 レポートスイートは、1 つのサンドボックスにのみ追加できます。
「Report suite」を選択したあと、Analytics source add data インターフェイスを使用してリスト内を移動し、Experience Platformに取り込む Analytics レポートスイートを特定します。 「Next」を選択して次に進みます。
<!—Analytics レポートスイートは、一度に 1 つのサンドボックスに対して設定できます。 同じレポートスイートを別のサンドボックスに読み込むには、データセットフローを削除し、別のサンドボックスの設定を使用して再度インスタンス化する必要があります。—>
マッピング mapping
Analytics データをターゲット XDM スキーマをマッピングする前に、まずデフォルトのスキーマとカスタムのスキーマのどちらを使用するかを判断する必要があります。
デフォルトのスキーマは、ユーザーに代わって新しいスキーマを作成します。 この新しく作成されたスキーマには、Adobe Analytics ExperienceEvent Template フィールドグループが含まれます。 デフォルトのスキーマを使用するには、「Default schema」を選択します。
カスタムスキーマを使用すると、Analytics データに対して、Adobe Analytics ExperienceEvent Template フィールドグループを持つスキーマであれば、利用可能な任意のスキーマを選択することができます。 カスタムスキーマを使用するには、「Custom schema」を選択します。
Mapping インターフェイスを使用して、ソースフィールドを適切なターゲットスキーマフィールドにマッピングします。 カスタム変数を新しいスキーマフィールドグループにマッピングし、データ準備でサポートされている計算を適用できます。 ターゲットスキーマを選択してマッピングプロセスを開始します。
Map standard fields スト上の指標については、Standard mappings applied のパネルを参照してください。 Standard mappings with descriptor name conflicts、および Custom mappings。
標準マッピング standard-mappings
名前の競合が見つかった場合は、マッピングがExperience Platformによって自動的に検出されます。 マッピングと競合しない場合は、「Next」を選択して続行します。
カスタムマッピング custom-mappings
データ準備関数を使用して、カスタム属性の新しいカスタムマッピングまたは計算フィールドを追加できます。 カスタムマッピングを追加するには、「Custom」を選択します。
- Filter fields:Filter fields テキスト入力を使用して、マッピング内の特定のマッピングフィールドをフィルタリングします。
- Add new mapping：新しいソースフィールドとターゲットフィールドのマッピングを追加するには、「Add new mapping」を選択します。
- Add calculated field：必要に応じて、Add calculated field を選択して、マッピング用の新しい計算フィールドを作成できます。
- Import mapping: データ準備の読み込みマッピング機能を使用すると、データ取り込みプロセスの手動による設定時間を短縮し、ミスを制限できます。 既存のフローまたは書き出されたファイルからマッピングをインポートする Import mapping を選択します。 詳しくは、 マッピングのインポートとエクスポートに関するガイド を参照してください。
- Download template: マッピングの CSV コピーをダウンロードして、ローカルデバイスでマッピングを設定することもできます。 「Download template」を選択して、マッピングの CSV コピーをダウンロードします。 ソースファイルとターゲットスキーマで提供されるフィールドのみを使用していることを確認する必要があります。
データ準備について詳しくは、次のドキュメントを参照してください。
リアルタイム顧客プロファイルのフィルタリング filtering-for-profile
Analytics レポートスイートデータのマッピングが完了したら、フィルタリングルールと条件を適用して、リアルタイム顧客プロファイルへの取り込みにデータを選択的に含めるか除外することができます。 フィルタリングのサポートは、Analytics データに対してのみ使用でき、データは Profile. を入力する前にのみフィルタリングされます。すべてのデータは、データレイクに取り込まれます。
リアルタイム顧客プロファイルの分析データのデータ準備およびフィルタリングに関する追加情報
- フィルタリング機能は、プロファイルに送信されるデータには使用できますが、データレイクに送信されるデータには使用できません。
- ライブデータにはフィルターを使用できますが、バックフィルデータをフィルターすることはできません。
- Analytics ソースは、プロファイルにデータをバックフィルしません。
- Analytics フローの初期設定中にデータ準備設定を利用した場合、それらの変更は 13 か月の自動バックフィルにも適用されます。
- ただし、フィルタリングはライブデータのみに予約されているので、フィルタリングには該当しません。
- データ準備は、ストリーミングとバッチの両方の取り込みパスに適用されます。 既存の Data Prep 設定を変更すると、それらの変更はストリーミングとバッチの両方の取り込み経路を通じて新しい受信データに適用されます。
- ただし、Data Prep 設定は、ストリーミングデータかバッチデータかに関係なく、既にExperience Platformに取り込まれているデータには適用されません。
- Analytics の標準属性は、常に自動的にマッピングされます。 したがって、標準属性に変換を適用することはできません。
- ただし、ID サービスまたはプロファイルで必要でない限り、標準属性を除外できます。
- 列レベルのフィルタリングを使用して、必須フィールドおよび ID フィールドをフィルタリングすることはできません。
- セカンダリ ID （特に AAID と AACustomID）を除外することはできますが、ECID を除外することはできません。
- 変換エラーが発生すると、対応する列は NULL になります。
行レベルのフィルタリング
プロファイル取り込みのデータは、行レベルおよび列レベルでフィルタリングできます。 行レベルのフィルタリングを使用して、文字列に「次を含む」、「次と等しい」、「次で始まる」、「次で終わる」などの条件を定義します。 また、行レベルのフィルタリングを使用して、AND と OR を使用して条件を結合したり、NOT を使用して条件を否定したりできます。
行レベルで Analytics データをフィルタリングするには、「Row filter」を選択し、左パネルを使用してスキーマ階層内を移動し、選択するスキーマ属性を特定します。
設定する属性を特定したら、その属性を選択して、左側のパネルからフィルタリングパネルにドラッグします。
別の条件を設定するには、「equals」を選択し、表示されるドロップダウンウィンドウから条件を選択します。
設定可能な条件のリストを以下に示します。
- equals
- does not equal
- starts with
- ends with
- does not end with
- contains
- does not contain
- exists
- does not exist
次に、選択した属性に基づいて、含める値を入力します。 次の例では、Apple と Google が Manufacturer 属性の一部として取り込み用に選択されています。
フィルター条件をさらに指定するには、スキーマから別の属性を追加してから、その属性に基づいて値を追加します。 次の例では、Model 属性が追加され、iPhone 16 や Google Pixel 9 などのモデルが取り込み用にフィルタリングされます。
新しいコンテナを追加するには、フィルタリングインターフェイスの右上にある省略記号（...）を選択し、「Add container」を選択します。
新しいコンテナを追加したら、「Include」を選択し、ドロップダウンメニューから「Exclude」を選択します。 除外する属性と値を追加し、終了したら「Next」を選択します。
列レベルのフィルタリング
ヘッダーから「Column filter」を選択して、列レベルのフィルタリングを適用します。
ページが更新されてインタラクティブスキーマツリーになり、スキーマ属性が列レベルで表示されます。 ここから、プロファイルの取り込みから除外するデータの列を選択できます。 または、列を展開して、除外する特定の属性を選択することもできます。
デフォルトでは、すべての Analytics はプロファイルに移動しますが、このプロセスを使用すると、XDM データのブランチをプロファイルの取り込みから除外できます。
セカンダリ ID のフィルタリング
列フィルターを使用して、プロファイルの取り込みからセカンダリ ID を除外します。 セカンダリ ID をフィルタリングするには、「Column filter」を選択してから「_identities」を選択します。
フィルターは、ID がセカンダリとしてマークされている場合にのみ適用されます。 ID が選択されていても、プライマリとしてマークされた ID のいずれかがイベントに届いた場合、その ID は除外されません。
データフローの詳細を入力
Dataflow detail の手順が表示され、データフローの名前と説明（オプション）を入力する必要があります。 終了したら「Next」を選択します。
レビュー
Review の手順が表示され、新しい Analytics データフローを作成前に確認できます。 接続の詳細は、次のようなカテゴリ別にグループ化されます。
- Connection：接続のソースプラットフォームを表示します。
- Data type：選択したレポートスイートと、対応するレポートスイート ID が表示されます。
-
データのライフサイクル管理とストレージ効率を最適化するために、最初にエクスペリエンスイベントデータセットの保持有効期間（TTL）を設定します。 詳しくは、TTL を使用したデータレイクでのエクスペリエンスイベントデータセット保持の管理 に関するガイドを参照してください。
-
Analytics ソースデータフローを作成する場合は、まず、データレイクにのみデータを取り込むようにコネクタを設定します。 データフローが機能していることを確認したら、データセットのプロファイル取り込みを有効にできます。 この方法は、行と列のフィルターによってデータ量が効果的に削減される場合に最適です。
データフローの監視 monitor-your-dataflow
データフローが完了したら、Dataflows インターフェイスを使用して、Analytics データフローのステータスを監視できます。
Dataset activity インターフェイスを使用して、Analytics からExperience Platformに送信されるデータの進行状況に関する情報を取得します。 インターフェイスには、先月のレコードの合計、過去 7 日間に取り込んだレコードの合計、先月のデータのサイズなどの指標が表示されます。
ソースは、2 つのデータセットフローをインスタンス化します。 1 つのフローはバックフィルデータ、もう 1 つはライブデータのフローを表します。 バックフィルデータは、リアルタイム顧客プロファイルへの取り込み用に設定されていませんが、分析およびデータサイエンスのユースケース用にデータレイクへと送信されます。
バックフィル、ライブデータおよびそれぞれのレイテンシーの詳細については、Analytics ソースの概要 を参照してください。
データフローの削除 delete-dataflow
Analytics データフローを削除するには、ソース ワークスペースの上部のヘッダーから Dataflows を選択します。 データフローページを使用して、削除する Analytics データフローを見つけ、その横にある省略記号（...）を選択します。 次に、ドロップダウンメニューを使用して「Delete」を選択します。
- ライブ Analytics データフローを削除すると、基になるデータセットも削除されます。
- Analytics データフローのバックフィルを削除しても、基になるデータセットは削除されませんが、対応するレポートスイートのバックフィルプロセスは停止します。 バックフィルデータフローを削除した場合でも、取り込まれたデータはデータセットを使用して表示できます。
次の手順とその他のリソース
接続を作成すると、受信データを格納して選択したスキーマをデータセットに投入するデータフローが自動的に作成されます。さらに、データのバックフィルが発生し、最大 13 か月の履歴データを取り込みます。初回の取り込みが完了したら、Analytics データはダウンストリームのExperience Platform サービス（Real-Time Customer Profile やセグメント化サービスなど）で使用されるようになります。 詳しくは、次のドキュメントを参照してください。
次のビデオは、Adobe Analytics Source コネクタを使用したデータの取り込みに関する理解を深めることを目的としています。