UI での Adobe Analytics ソースコネクタの作成
このチュートリアルでは、Adobe Analytics レポートスイートデータをAdobe Experience Platformに取り込むために、UI でAdobe Analytics ソース接続を作成する手順について説明します。
はじめに
このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
- エクスペリエンスデータモデルl（XDM）システム：Experience Platform が顧客体験データを整理するための標準化されたフレームワークです。
- リアルタイム顧客プロファイル：複数のソースから集計したデータに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
- サンドボックス：Experience Platform には、単一の Platform インスタンスを別々の仮想環境に分割し、デジタルエクスペリエンスアプリケーションの開発と発展に役立つ仮想サンドボックスが用意されています。
主な用語
このドキュメントで使用される以下の主な用語を理解することが重要です。
- 標準属性：標準属性は、アドビで事前定義された任意の属性です。 これらはすべての顧客に対して同じ意味を持ち、Analytics ソースデータと Analytics スキーマフィールドグループで利用可能です。
- カスタム属性：カスタム属性とは、Analytics のカスタム変数階層にある任意の属性のことです。カスタム属性は、Adobe Analyticsの実装内で特定の情報をレポートスイートに取り込むために使用され、レポートスイートごとに使用方法が異なる場合があります。 カスタム属性には、eVar、prop およびリストが含まれます。eVars の詳細については、以下のAnalytics コンバージョン変数に関するドキュメントを参照してください。
- カスタムフィールドグループ内の任意の属性：顧客が作成したフィールドグループから派生する属性はすべてユーザー定義であり、標準属性でもカスタム属性でもないとみなされます。
- フレンドリ名：フレンドリ名は、Analytics 実装のカスタム変数用に、人間がつけたラベルです。フレンドリ名の詳細については、以下のAnalytics コンバージョン変数に関するドキュメントを参照してください。
Adobe Analytics でのソース接続の作成
- データレイクへの履歴レポートスイートデータの 13 か月のバックフィルを行うデータフロー。 このデータフローは、バックフィルが完了すると終了します。
- ライブデータをデータレイクと Real-Time Customer Profile に送信するデータフローフロー。 このデータフローは継続的に実行されます。
Platform の UI で、左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。また、検索バーを使用して、表示されるソースを絞り込むこともできます。
Adobe アプリケーション カテゴリから、Adobe Analytics、「データの追加」の順に選択します。
データの選択
Analytics ソースのデータの追加 手順には、ソース接続を作成す Analytics レポートスイートデータのリストが表示されます。
レポートスイートは、レポートの基礎を形成するデータ Analytics コンテナです。 組織は、それぞれに異なるデータセットを含む、多数のレポートスイートを持つことができます。
ソース接続が作成されているExperience Platformサンドボックスインスタンスと同じ組織にマッピングされている限り、任意の地域（米国、英国またはシンガポール）からレポートスイートを取り込むことができます。 レポートスイートは、1 つのアクティブなデータフローのみを使用して取り込むことができます。 選択できないレポートスイートは、使用しているサンドボックスまたは別のサンドボックスで既に取り込まれています。
複数のインバウンド接続を使用して、複数のレポートスイートを同じサンドボックスに取り込むことができます。 変数（eVar やイベントなど）のスキーマが異なるレポートスイートの場合は、カスタムフィールドグループの特定のフィールドにマッピングし、 データ準備を使用してデータの競合を回避する必要があります。 レポートスイートは、1 つのサンドボックスにのみ追加できます。
Analytics ソース接続を作成するには、レポートスイートを選択してから「次へ を選択して続行します。
<! —Analytics レポートスイートは、一度に 1 つのサンドボックスに対して設定できます。 同じレポートスイートを別のサンドボックスに読み込むには、データセットフローを削除し、別のサンドボックスの設定を使用して再度インスタンス化する必要があります。—>
マッピング
Analytics データをターゲット XDM スキーマをマッピングする前に、まずデフォルトのスキーマとカスタムのスキーマのどちらを使用するかを選択する必要があります。
デフォルトのスキーマは、Adobe Analytics ExperienceEvent Template フィールドグループを含む新しいスキーマをユーザーに代わって作成します。デフォルトのスキーマを使用するには、デフォルトのスキーマ を選択してください。
カスタムスキーマを使用すると、Analytics データに対して、Adobe Analytics ExperienceEvent Template フィールドグループを持つスキーマであれば、利用可能な任意のスキーマを選択することができます。カスタムスキーマを使用するには、「カスタムスキーマ」を選択してください。
マッピングページには、ソースフィールドを適切なターゲットスキーマフィールドにマッピングするためのインターフェイスが用意されています。 ここから、カスタム変数を新しいスキーマフィールドグループにマッピングし、データ準備でサポートされている計算を適用できます。 ターゲットスキーマを選択してマッピングプロセスを開始します。
標準フィールドをマッピングセクションには、適用された標準マッピング、一致しない標準マッピングおよびカスタムマッピングのパネルが表示されます。各カテゴリに関する詳細は、次の表を参照してください。
AnalyticsExperienceEvent テンプレートスキーマフィールドグループのプレビューを行うには、適用された標準マッピングパネルで「表示」を選択します。
この Adobe Analytics ExperienceEvent テンプレートスキーマフィールドグループページには、スキーマの構造を調べるためのインターフェイスが用意されています。 終了したら、「閉じる」をクリックします。
Platform は、マッピングセットにフレンドリ名の競合がないかを自動的に検出します。 マッピングセットと競合しない場合は、「次へ」をクリックして続行します。
カスタムマッピング
データ準備関数を使用して、カスタム属性の新しいカスタムマッピングまたは計算フィールドを追加できます。 カスタムマッピングを追加するには、「カスタム」を選択します。
必要に応じて、「新しいマッピングを追加」または 計算フィールドを追加 を選択し、カスタム属性のカスタムマッピングの作成に進むことができます。 データ準備機能の使用方法に関する包括的な手順については、 データ準備 UI ガイドを参照してください。
次のドキュメントでは、データ準備、計算フィールド、およびマッピング機能について理解するための詳細なリソースを提供します。
リアルタイム顧客プロファイルのフィルタリング filtering-for-profile
Analytics レポートスイートデータのマッピングが完了したら、フィルタリングルールと条件を適用して、リアルタイム顧客プロファイルへの取り込みにデータを選択的に含めるか除外することができます。 フィルタリングのサポートは、Analytics のデータに対してのみ使用でき、データは Profile. を入力する前にのみフィルタリングされます。すべてのデータは、データレイクに取り込まれます。
リアルタイム顧客プロファイルの分析データのデータ準備およびフィルタリングに関する追加情報
- フィルタリング機能は、プロファイルに送信されるデータには使用できますが、データレイクに送信されるデータには使用できません。
- ライブデータにはフィルターを使用できますが、バックフィルデータをフィルターすることはできません。
- Analytics ソースは、プロファイルにデータをバックフィルしません。
- Analytics フローの初期設定中に Data Prep 設定を利用した場合、それらの変更は 13 か月の自動バックフィルにも適用されます。
- ただし、フィルタリングはライブデータのみに予約されているので、フィルタリングには該当しません。
- データ準備は、ストリーミングとバッチの両方の取り込みパスに適用されます。 既存の Data Prep 設定を変更すると、それらの変更はストリーミングとバッチの両方の取り込み経路を通じて新しい受信データに適用されます。
- ただし、Data Prep 設定は、ストリーミングデータかバッチデータかに関係なく、既にExperience Platformに取り込まれているデータには適用されません。
- Analytics の標準属性は、常に自動的にマッピングされます。 したがって、標準属性に変換を適用することはできません。
- ただし、ID サービスまたはプロファイルで必要でない限り、標準属性を除外できます。
- 列レベルのフィルタリングを使用して、必須フィールドおよび ID フィールドをフィルタリングすることはできません。
- セカンダリ ID （特に AAID と AACustomID）を除外することはできますが、ECID を除外することはできません。
- 変換エラーが発生すると、対応する列は NULL になります。
行レベルのフィルタリング
取り込みのデータ Profile、行レベルと列レベルでフィルタリングできます。 行レベルのフィルタリングでは、文字列に「次を含む」、「次と等しい」、「次で始まる」、「次で終わる」などの条件を定義できます。 また、行レベルのフィルタリングを使用して、AND と OR を使用して条件を結合したり、NOT を使用して条件を否定したりできます。
行レベルで Analytics データをフィルタリングするには、「行フィルター」を選択します。
左側のパネルを使用してスキーマ階層内を移動し、目的のスキーマ属性を選択して、特定のスキーマをさらにドリルダウンします。
設定する属性を特定したら、その属性を選択して、左側のパネルからフィルタリングパネルにドラッグします。
様々な条件を設定するには、「に等しい」を選択し、表示されるドロップダウンウィンドウから条件を選択します。
設定可能な条件のリストを以下に示します。
- equals
- 次と等しくない
- 次で始まる
- 次で終わる
- 次で終わらない
- contains
- 次を含まない
- exists
- 存在しません
次に、選択した属性に基づいて、含める値を入力します。 次の例では、Apple と Google が Manufacturer 属性の一部として取り込み用に選択されています。
フィルター条件をさらに指定するには、スキーマから別の属性を追加してから、その属性に基づいて値を追加します。 次の例では、モデル 属性が追加され、iPhone 13 や Google Pixel 6 などのモデルが取り込み用にフィルタリングされます。
新しいコンテナを追加するには、フィルタリングインターフェイスの右上にある省略記号（...）を選択し、「コンテナを追加 を選択します。
新しいコンテナを追加したら、「含める」を選択し、表示されるドロップダウンウィンドウから「除外」を選択します。
次に、同じプロセスを完了して、スキーマ属性をドラッグし、フィルタリングから除外する対応する値を追加します。 次の例では、iPhone 12、iPhone 12 mini、Google Pixel 5 はすべて モデル 属性からの除外からフィルタリングされ、横は 画面の向き から除外され、モデル番号 A1633 は モデル番号 から除外されています。
終了したら、「次へ」を選択します。
列レベルのフィルタリング
ヘッダーから 列フィルター を選択して、列レベルのフィルタリングを適用します。
ページが更新されてインタラクティブスキーマツリーになり、スキーマ属性が列レベルで表示されます。 ここから、取り込みから除外するデータの列 Profile 選択できます。 または、列を展開して、除外する特定の属性を選択することもできます。
デフォルトでは、すべての Analytics は Profile に移動します。このプロセスを使用すると、XDM データのブランチを取り込みから除外 Profile きます。
終了したら、「次へ」を選択します。
セカンダリ ID のフィルタリング
列フィルターを使用して、プロファイルの取り込みからセカンダリ ID を除外します。 セカンダリ ID をフィルタリングするには、「列フィルター」を選択してから、「_identities」を選択します。
フィルターは、ID がセカンダリとしてマークされている場合にのみ適用されます。 ID が選択されていても、プライマリとしてマークされた ID のいずれかがイベントに届いた場合、その ID は除外されません。
データフローの詳細を入力
データフローの詳細 手順が表示され、データフローの名前と説明（オプション）を入力する必要があります。 完了したら、「次へ」をクリックします。
レビュー
レビュー手順が表示され、新しい Analytics データフローを作成前にレビューすることができます。 接続の詳細は、次のようなカテゴリ別にグループ化されます。
- 接続：接続のソースプラットフォームを表示します。
- データタイプ：選択したレポートスイートと、対応するレポートスイート ID が表示されます。
データフローの監視 monitor-your-dataflow
データフローが完了したら、ソースカタログで データフロー を選択し、データのアクティビティとステータスを監視できます。
組織内の既存の Analytics データフローのリストが表示されます。 ここから、ターゲットデータセットを選択して、それぞれの取り込みアクティビティを表示します。
データセットアクティビティ ページには、Analytics からExperience Platformに送信されるデータの進行状況に関する情報が表示されます。 このインターフェイスには、取り込まれたレコード数、取り込まれたバッチ数、失敗したバッチ数などの指標が表示されます。
ソースは、2 つのデータセットフローをインスタンス化します。 1 つのフローはバックフィルデータ、もう 1 つはライブデータのフローを表します。 バックフィルデータは、リアルタイム顧客プロファイルへの取り込み用に設定されていませんが、分析およびデータサイエンスのユースケース用にデータレイクへと送信されます。
バックフィル、ライブデータおよびそれぞれのレイテンシーの詳細については、Analytics ソースの概要を参照してください。
データセットアクティビティページに個々のバッチのリストが表示されません。 個々のバッチのリストを表示するには、データセットアクティビティインターフェイスでグラフを選択します。
監視ダッシュボードが表示されます。 次に、「失敗の取り込みのみ：はい」を選択して、フィルターをクリアし、個々のバッチのリストを表示します。
インターフェイスは、個々のバッチのリスト（それぞれの指標に関する情報を含む）に対して更新されます。
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto | |
|---|---|
| 指標 | 説明 |
| バッチ ID | 指定されたバッチの ID。 この値は内部的に生成されます。 |
| データセット名 | Analytics データに使用される特定のデータセットの名前。 |
| ソース | 取り込まれたデータのソース。 |
| 更新済み | 最新のフロー実行イテレーションの日付。 |
| データセットのレコード | データセット内のレコードの合計数。 メモ：このパラメーターには、場合によっては in-progress のステータスが表示されます。 このステータスは、レコードの取り込みプロセスがまだ完了していないことを示します。 |
| 新しいプロファイルフラグメント | 取り込まれた新しいプロファイルフラグメントの合計数。 |
| 既存のプロファイルフラグメント | 既存のプロファイルフラグメントの合計数。 |
| ステッチされた ID レコード | 取り込み後にステッチされた ID レコードの合計数。 |
| プロファイル内のレコード | リアルタイム顧客プロファイルに取り込まれたレコードの合計数。 |
次の手順とその他のリソース
接続を作成すると、受信データを格納して選択したスキーマをデータセットに投入するデータフローが自動的に作成されます。さらに、データのバックフィルが発生し、最大 13 か月の履歴データを取り込みます。初回の取り込みが完了したら、Analytics データはダウンストリームの Platform サービス（Real-Time Customer Profileやセグメント化サービスなど）で使用されるようになります。詳しくは、次のドキュメントを参照してください。
次のビデオは、Adobe Analytics Source コネクタを使用したデータの取り込みに関する理解を深めることを目的としています。