レポートスイートデータ用のAdobe Analytics ソースコネクタ
Adobe Experience Platformでは、Analytics ソースコネクタを使用してAdobe Analytics データを取り込むことができます。 コネクターは、レポートスイートデータをリアルタイムでPlatform データセットにストリーミングし、XDM形式に変換します。
Analytics ソースコネクタの仕組み
AppMeasurementやAdobe Analytics タグ拡張機能など、既存のAdobe Analyticsの実装を引き続き使用して、レポートスイートにデータを収集します。 ソースコネクタは、そのデータの収集またはレポート方法を変更しません。 データがAnalytics データ収集サーバーに到達すると、コネクタはそのデータのコピーをキャプチャします。
このコピーは、mid-valuesと呼ばれる、各ヒットの部分的に処理された形式です。 Analyticsは、事前処理（処理ルールなど）の後、訪問レベルおよび訪問者レベルの処理の前に中間値を生成します。 そのため、訪問番号などの後処理されたコンテキストは含まれません。 元のヒットは、通常どおりレポートスイートに書き込まれるようにパイプライン内を進みます。
コネクタは、これらの中間値をリアルタイムでExperience Platformのデータセットにストリーミングします。 データレイクからは、Query Serviceやその他のデータ検出アプリケーションでデータを利用でき、リアルタイム顧客プロファイルを充実させることもできます。
中値段階を含め、Analyticsがデータを収集および処理する方法について詳しくは、Adobe Analyticsでのデータの処理順序を参照してください。
Adobe Analytics フィールドのXDMへのマッピング
Experience Platform ユーザーインターフェイスでソース接続を作成すると、Analytics フィールドは自動的にXDMにマッピングされ、Platform データセットに取り込まれます。 手順については、Analytics ソースコネクタのチュートリアル を参照してください。
AnalyticsとExperience Platform間で行われるフィールドマッピングについて詳しくは、Adobe Analytics フィールドマッピング ガイドを参照してください。
Analytics データ内のプライマリID
Analytics ソースコネクタからのすべてのヒットには、ECIDまたはAAIDの有無に応じたプライマリ IDが含まれます。 ECIDがある場合、ECIDはプライマリ識別子として指定されます。 AAIDがある場合は、AAIDがプライマリとして指定されます。
次の表に、Analytics データのID フィールドの詳細を示します。
s_vi Cookie IDと呼ばれることもあります。 それでも、s_vi Cookieが存在しない場合でも、AAIDが作成されます。 AAIDは、Analytics データフィード のpost_visid_high列とpost_visid_low列で表されます。 任意のイベントで、AAID フィールドに単一のIDが含まれます。これは、Analytics ID🔗の操作順で説明されているいくつかの異なるタイプの1つです。 注: AAIDには、レポートスイート全体で、イベント間で様々なタイプが混在している場合があります。mcvisidで表されます。 ECIDについて詳しくは、ECIDの概要を参照してください。 ECIDとAnalyticsの連携について詳しくは、AnalyticsおよびExperience Cloud ID リクエスト のドキュメントを参照してください。Analytics ソースでのIDの処理方法
Analytics ソースは、これらのIDをXDM フォームのExperience Platformに次のように渡します。
endUserIDs._experience.aaid.idendUserIDs._experience.mcid.idendUserIDs._experience.aacustomid.id
これらのフィールドはIDとしてマークされていません。 代わりに、同じID （イベントに存在する場合）がキーと値のペアとしてXDMのidentityMapにコピーされます。
{ "key": "AAID", "value": [ { "id": "<identity>", "primary": <true or false> } ] }{ "key": "ECID", "value": [ { "id": "<identity>", "primary": <true or false> } ] }{ "key": "AACUSTOMID", "value": [ { "id": "<identity>", "primary": false } ] }
IDまたはIDがidentityMapにコピーされると、endUserIDs._experience.mcid.namespace.codeも同じイベントに設定されます。
- AAIDが存在する場合、
endUserIDs._experience.aaid.namespace.codeは「AAID」に設定されます。 - ECIDが存在する場合、
endUserIDs._experience.mcid.namespace.codeは「ECID」に設定されます。 - AACUSTOMIDが存在する場合、
endUserIDs._experience.aacustomid.namespace.codeは「AACUSTOMID」に設定されます。
ID マップでは、ECIDが存在する場合、イベントのプライマリ IDとしてマークされます。 この場合、AAIDは訪問者ID サービス猶予期間により、ECIDに基づいている可能性があります。 それ以外の場合、AAIDはイベントのプライマリ IDとしてマークされます。 AACUSTOMIDは、イベントのプライマリ IDとしてマークされることはありません。 ただし、AACUSTOMIDが存在する場合、AAIDはExperience Cloudの操作の順序により、AACUSTOMIDに基づいています。
プライバシー処理の移行 privacy
Adobe Experience Platform Privacy Serviceを使用して、Adobe Analytics ソースデータセットのプライバシーリクエストを処理します。 まず、レポートスイートラベルを確認します。 次に、スキーマ IDとデータ使用ラベルを手動で設定します。 最後に、データフローのプライバシーソースを切り替えます。
プライバシーリクエストの処理については、Privacy Serviceの概要を参照してください。
レポートスイートラベルの確認 review-analytics-privacy-rules
移行する前に、データセットを提供するレポートスイートのラベルとID名前空間を確認してください。 Adobe Analyticsには データガバナンス の管理者権限が必要です。
- Adobe Analyticsで、管理者 > すべての管理者 > データ設定と収集 > データガバナンスに移動します。
- レポートスイートを選択します。
- ID、機密性、アクセス、削除の変数ラベルと、設定されたID名前空間を確認します。
ラベルについて詳しくは、 プライバシーラベル付けの概要を参照してください。 手順に従って、 レポートスイートのプライバシーラベルを割り当てまたは編集します。 変数🔗の データプライバシーラベルの定義を確認します。
プライバシー設定の再作成 configure-platform-privacy
Analytics ソースデータセットのスキーマでIDとラベルを手動で設定します。 Experience Platformは、Adobe Analyticsからラベルを自動的にコピーしません。
データ使用ラベルとは別にスキーマ IDを設定します。 この表を使用して、Analytics ラベルをExperience Platform設定にマッピングします。
ID-DEVICEID-PERSONI1I1 データ使用ラベルを適用します。I2I2 データ使用ラベルを適用します。S1S1 データ使用ラベルを適用します。S2S2 データ使用ラベルを適用します。ACC-ALL, ACC-PERSONDEL-DEVICE, DEL-PERSONC1からC12、PSPDおよびRHDを含む追加の データ使用ラベル を、該当する場合に適用します。 追加のラベルには、直接Analyticsに相当するものはありません。 ラベル I1、I2、S1およびS2には対応する意味がありますが、製品は異なる目的のために使用します。
プライバシーソースを切り替える前に、IDとデータ使用ラベルを設定します。
-
Experience Platformで、「スキーマ」を選択し、Analytics ソースデータセットのスキーマを開きます。
-
Adobe Analytics フィールドマッピング を使用して、ラベル付きAnalytics変数のスキーマフィールドを検索します。
-
ID-DEVICEまたはID-PERSON変数からマッピングされたスキーマフィールドをIDとしてマークします。ID フィールドと名前空間を設定するには、 スキーマ ID設定手順に従います。
-
「ラベル」タブで、データ使用ラベルが必要なフィールドを選択します。
-
「アクセスおよびデータガバナンスラベルを適用」を選択し、マッピングテーブルから該当するラベルを選択します。
-
「保存」を選択します。
詳細な手順については、「 スキーマにラベルを適用する方法」を参照してください。
カスタム Analytics プライバシー設定、VISTA ルール、コンテンツに応じた設定とマーケティングチャネル設定を確認します。 データ準備の変換も確認します。 IDとラベルを必要な追加フィールドに設定します。
プライバシーソースの切り替え switch-privacy-source
IDとラベルを設定したら、Experience Platform ソース ワークスペースでプライバシーソースを切り替えます。 移行は、組織全体ではなく、選択したデータフローに関連付けられているデータセットに影響します。
-
ソースで、データフローを選択し、移行するデータフローのメニューを開きます。
-
「AEPにプライバシーを移行」を選択して、確認ダイアログを開きます。
続行する前に、確認ダイアログで設定リマインダーを確認します。
-
確認チェックボックスを選択して、データセットプライバシー設定を確認します。
-
「移行を開始」を選択します。
データフローでは、プライバシー処理列に「AEPへの移行」と表示され、移行通知が表示されます。
![ プライバシー処理]列には、AEPへの移行と移行通知(./images/migrating-transition-notice.png)が表示されます。
ヒットのタイムスタンプ精度とイベントの順序
コネクタは、Analytics データをミッド値として受け取り、2次レベルのヒットタイムスタンプを保持します。 Analyticsは時間を2番目の精度で記録し、サブセカンドタイミングを追跡しないので、同じ2秒内に収集されたヒットの順序は決定論的ではありません。 その結果、コネクタを通じて取り込まれた同じ秒のイベントの順序が、Analytics レポートに表示される順序と異なる場合があります。
Customer Journey Analyticsはタイムスタンプを ミリ秒に解決しますが、Analyticsから取得したデータは数秒しか入力されません。 したがって、タイムスタンプだけでは、同じ秒を共有するイベントの相対的な順序を確立することはできません。 これは、同じ秒間に複数のヒットが収集された場合（ページビューやAdobe Target（A4T）ヒットなど）に最も顕著です。
Analyticsのタイムスタンプ精度について詳しくは、Adobe Analytics timestamp変数と ヒット数のドキュメントを参照してください。 コネクタがXDM （hit_time_gmtおよびpost_cust_hit_time_gmt）にマッピングするタイムスタンプフィールドについては、Adobe Analytics フィールドマッピング ガイドを参照してください。
タイムスタンプ精度のオプションには、次のものが含まれます。
- 同じ秒の順序の小さな違いを受け入れます。 ほとんどのレポートでは、効果は同じ秒を共有し、集計指標に影響を与えないイベントに限定されます。 これは、混在ページビューとAdobe Target（A4T）のシナリオを含め、推奨されるアプローチです。
- 順序に応じたユースケースでは、Web SDKを優先します。 Adobe Experience Platform Web SDKを通じてExperience PlatformおよびCustomer Journey Analyticsに直接データを送信すると、秒単位（ミリ秒単位）のタイムスタンプ精度が保持され、Analyticsの再処理が回避されます。 この方法は、イベントの順序が重要な場合に推奨されます。
データの遅延とバックフィル
Experience PlatformでのAnalytics データの予想される待ち時間は、次の表に示されています。 待ち時間は、顧客設定、データボリューム、コンシューマアプリケーションによって異なります。 例えば、Analyticsの実装がA4Tで設定されている場合、パイプラインへの待ち時間は5～10分増加します。
Customer Journey Analyticsの遅延について詳しくは、Customer Journey Analytics ガードレール を参照してください。
実稼動サンドボックスのAnalytics バックフィルは、デフォルトで13か月に設定されます。 実稼動以外のサンドボックスのAnalytics データの場合、バックフィルは3か月に設定されます。 上記の表に記載されている100億件のイベントの制限は、厳密に予想される遅延に関して適用されます。
実稼動サンドボックスでAnalytics ソースデータフローを作成すると、次の2つのデータフローが作成されます。
- 履歴レポートスイートのデータをデータレイクに13か月間バックフィルするデータフロー。 このデータフローは、バックフィルが完了すると終了します。
- ライブデータをデータレイクとリアルタイム顧客プロファイルに送信するデータフロー。 このデータフローは継続的に実行されます。
ベストプラクティス
ライセンスの使用権限を超え、ストレージとデータリッチネスの総指標に負担がかかることを避けるために、次のベストプラクティスに従ってください。
- データライフサイクル管理とストレージ効率を最適化するために、最初にExperience Event データセットの保持有効期間（TTL）を設定します。 詳しくは、TTLを使用したデータレイクでのエクスペリエンスイベントデータセット保持の管理に関するガイドを参照してください。
- Analytics ソースデータフローを作成する場合は、まず、データレイクにのみデータを取り込むようにコネクタを設定します。 データフローが機能していることを確認したら、データセットのプロファイル取り込みを有効にできます。 この方法は、行と列のフィルターによってデータ量が効果的に削減される場合に最適です。 詳しくは、Adobe AnalyticsとExperience Platformの接続 ドキュメントを参照してください。