UI での Adobe Analytics ソースコネクタの作成

最終更新日: 2024-02-21
  • トピック:
  • Sources
    このトピックの詳細を表示
  • 作成対象:
  • Developer

このチュートリアルでは、UI でAdobe Analyticsソース接続を作成してAdobe AnalyticsレポートスイートデータをAdobe Experience Platformに取り込む手順を説明します。

はじめに

このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

  • エクスペリエンスデータモデルl(XDM)システム:Experience Platform が顧客体験データを整理するための標準化されたフレームワークです。
  • リアルタイム顧客プロファイル:複数のソースから集計したデータに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
  • サンドボックス:Experience Platform には、単一の Platform インスタンスを別々の仮想環境に分割し、デジタルエクスペリエンスアプリケーションの開発と発展に役立つ仮想サンドボックスが用意されています。

主な用語

このドキュメントで使用される以下の主な用語を理解することが重要です。

  • 標準属性:標準属性は、アドビで事前定義された任意の属性です。 これらはすべての顧客に対して同じ意味を持ち、Analytics ソースデータと Analytics スキーマフィールドグループで利用可能です。
  • カスタム属性:カスタム属性とは、Analytics のカスタム変数階層にある任意の属性のことです。カスタム属性は、Adobe Analytics実装内で特定の情報をレポートスイートに取り込むために使用され、レポートスイートごとに使用方法が異なる場合があります。 カスタム属性には、eVar、prop およびリストが含まれます。eVars の詳細については、以下のAnalytics コンバージョン変数に関するドキュメントを参照してください。
  • カスタムフィールドグループ内の任意の属性:顧客が作成したフィールドグループから派生する属性はすべてユーザー定義であり、標準属性でもカスタム属性でもないとみなされます。
  • フレンドリ名:フレンドリ名は、Analytics 実装のカスタム変数用に、人間がつけたラベルです。フレンドリ名の詳細については、以下のAnalytics コンバージョン変数に関するドキュメントを参照してください。

Adobe Analytics でのソース接続の作成

メモ

実稼働用サンドボックスで Analytics ソースのデータフローを作成する場合、2 つのデータフローが作成されます。

  • 13 か月間にわたって履歴レポートスイートデータをデータレイクにバックフィルするデータフロー。 このデータフローは、バックフィルが完了すると終了します。
  • ライブデータをデータレイクとに送信するデータフロー Real-Time Customer Profile. このデータフローは継続的に実行されます。

Platform の UI で、左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。

画面の左側にあるカタログから適切なカテゴリを選択することができます。また、検索バーを使用して、表示されるソースを絞り込むこともできます。

Adobe アプリケーション​カテゴリから、Adobe Analytics、「データの追加」の順に選択します。

カタログ

データの選択

重要

画面に表示されるレポートスイートは、様々な地域からのものです。 お客様は、データの制限事項と義務、およびAdobe Experience Platformの複数の地域でのデータの使用方法について理解する必要があります。 会社で許可されていることを確認してください。

The Analytics ソースデータの追加 手順に従って、 Analytics ソース接続を作成するレポートスイートデータ。

レポートスイートは、 Analytics レポート。 組織は、様々なデータセットを含む多数のレポートスイートを持つことができます。

ソース接続が作成されているExperience Platformサンドボックスインスタンスと同じ組織にマッピングされている限り、任意の地域(米国、英国、シンガポール)からレポートスイートを取り込むことができます。 レポートスイートは、1 つのアクティブなデータフローのみを使用して取り込むことができます。 選択できないレポートスイートは、使用しているサンドボックスまたは別のサンドボックスで、既に取り込まれています。

複数のインバウンド接続を作成して、複数のレポートスイートを同じサンドボックスに取り込むことができます。 レポートスイートの変数(eVar やイベントなど)のスキーマが異なる場合は、カスタムフィールドグループの特定のフィールドにマッピングし、 データ準備. レポートスイートは 1 つのサンドボックスにのみ追加できます。

メモ

複数のレポートスイートのデータをリアルタイム顧客プロファイルに対して有効にできるのは、意味が異なる 2 つのカスタムプロパティ(eVar、リストおよび prop)など、データの競合がない場合のみです。

次の手順で、 Analytics ソース接続を選択し、レポートスイートを選択して、 次へ をクリックして続行します。

<! —Analytics レポートスイートは、一度に 1 つのサンドボックスに対して設定できます。 同じレポートスイートを別のサンドボックスに読み込むには、データセットフローを削除し、別のサンドボックスの設定を使用して再びインスタンス化する必要があります。—>

マッピング

重要

データ準備変換を実行すると、データフロー全体に遅延が生じる場合があります。 追加される待ち時間は、変換ロジックの複雑さに応じて異なります。

Analytics データをターゲット XDM スキーマをマッピングする前に、まずデフォルトのスキーマとカスタムのスキーマのどちらを使用するかを選択する必要があります。

デフォルトのスキーマは、Adobe Analytics ExperienceEvent Template フィールドグループを含む新しいスキーマをユーザーに代わって作成します。デフォルトのスキーマを使用するには、デフォルトのスキーマ​を選択してください。

default-schema

カスタムスキーマを使用すると、Analytics データに対して、Adobe Analytics ExperienceEvent Template フィールドグループを持つスキーマであれば、利用可能な任意のスキーマを選択することができます。カスタムスキーマを使用するには、「カスタムスキーマ」を選択してください。

custom-schema

マッピングページには、ソースフィールドを適切なターゲットスキーマフィールドにマッピングするためのインターフェイスが用意されています。 ここから、カスタム変数を新しいスキーマフィールドグループにマッピングし、データ準備でサポートされている計算を適用できます。 ターゲットスキーマを選択してマッピングプロセスを開始します。

ヒント

Adobe Analytics ExperienceEvent Template フィールドグループを持つスキーマのみがスキーマ選択メニューに表示されます。 その他のスキーマは省略されます。 お使いのレポートスイートデータに適したスキーマがない場合は、新しいスキーマを作成する必要があります。 スキーマの作成手順について詳しくは、UI でのスキーマの作成と編集ガイドを参照してください。

select-schema

標準フィールドをマッピングセクションには、適用された標準マッピング、一致しない標準マッピングおよびカスタムマッピングのパネルが表示されます。各カテゴリに関する詳細は、次の表を参照してください。

標準フィールドをマッピング 説明
適用された標準マッピング 適用された標準マッピングパネルには、マッピングされた属性の総数が表示されます。標準マッピングとは、ソース Analytics データ内の全属性と Analytics フィールドグループ内の対応する属性との間のマッピングセットを指します。これらは事前にマッピングされており、編集できません。
一致しない標準マッピング 一致しない標準マッピングパネルは、フレンドリ名の競合を含むマッピング済み属性の数を参照します。 これらの競合は、別のレポートスイートからフィールド記述子のセットが既に入力されているスキーマを再利用する場合に発生します。 フレンドリ名が競合していても、Analytics データフローを進めることができます。
カスタムマッピング カスタムマッピングパネルには、マッピングされたカスタム属性(eVar、prop、リストを含む)の数が表示されます。 カスタムマッピングとは、ソース Analytics データ内のカスタム属性と、選択したスキーマに含まれるカスタムフィールドグループの属性との間のマッピングセットを指します。

map-standard-fields

AnalyticsExperienceEvent テンプレートスキーマフィールドグループのプレビューを行うには、適用された標準マッピングパネルで「表示」を選択します。

表示

この Adobe Analytics ExperienceEvent テンプレートスキーマフィールドグループページには、スキーマの構造を調べるためのインターフェイスが用意されています。 終了したら、「閉じる」をクリックします。

field-group-preview

Platform は、マッピングセットにフレンドリ名の競合がないかを自動的に検出します。 マッピングセットと競合しない場合は、「次へ」をクリックして続行します。

マッピング

ヒント

ソースレポートスイートと選択したスキーマ間でフレンドリ名の競合がある場合も、フィールド記述子は変更されないことを確認すれば、Analytics データフローを続行することが可能です。または、空の記述子セットで新しいスキーマを作成することもできます。

カスタムマッピング

Data Prep 関数を使用して、カスタム属性に新しいカスタムマッピングまたは計算フィールドを追加できます。 カスタムマッピングを追加するには、「 カスタム.

カスタム

必要に応じて、次のいずれかを選択できます。 新しいマッピングを追加 または 計算フィールドを追加 カスタム属性のカスタムマッピングの作成に進みます。 Data Prep 関数の使用方法に関する包括的な手順については、 データ準備 UI ガイド.

次のドキュメントでは、データ準備、計算フィールド、およびマッピング機能について理解するための詳細なリソースを提供します。

リアルタイム顧客プロファイルのフィルタリング

マッピングを完了したら、 Analytics レポートスイートのデータを使用する場合、フィルタリングルールと条件を適用して、リアルタイム顧客プロファイルへの取り込みからデータを選択的に含めたり除外したりできます。 フィルタリングのサポートは、次の場合にのみ使用できます。 Analytics データとデータは、 Profile. すべてのデータがデータレイクに取り込まれます。

リアルタイム顧客プロファイル用の Analytics データのデータ準備とフィルタリングに関する追加情報

  • プロファイルに移動するデータに対してはフィルタリング機能を使用できますが、データレイクに移動するデータに対しては使用できません。
  • ライブデータに対してフィルタリングを使用することはできますが、バックフィルのデータに対してはフィルタリングできません。
    • The Analytics ソースは、データをプロファイルにバックフィルしません。
  • の初期設定時に Data Prep 構成を利用する場合 Analytics フローの場合、その変更は 13 ヶ月の自動バックフィルにも適用されます。
    • ただし、フィルタリングはライブデータ用にのみ予約されているので、フィルタリングには当てはまりません。
  • データ準備は、ストリーミング取り込みパスとバッチ取り込みパスの両方に適用されます。 既存の Data Prep 構成を変更すると、その変更は、ストリーミングとバッチの取り込み経路の両方で新しい受信データに適用されます。
    • ただし、Data Prep の設定は、ストリーミングデータかバッチデータかに関係なく、Experience Platformに取り込まれたデータには適用されません。
  • Analytics の標準属性は、常に自動的にマッピングされます。 したがって、標準のアトリビュートに変換を適用することはできません。
    • ただし、標準属性が ID サービスまたはプロファイルで必要でない限り、標準属性を除外できます。
  • 列レベルのフィルタリングを使用して、必須フィールドと ID フィールドをフィルタリングすることはできません。
  • セカンダリ ID(特に AAID と AACustomID)を除外できますが、ECID を除外することはできません。
  • 変換エラーが発生した場合、対応する列は NULL になります。

行レベルのフィルター

重要

行レベルのフィルタリングを使用して、条件を適用し、プロファイルの取り込みに含める​データを指示します。列レベルのフィルターを使用して、データの列を選択します プロファイル取り込み用に除外.

データをフィルターできます。 Profile 行レベルおよび列レベルでの取り込み。 行レベルのフィルタリングでは、文字列の含む、等しい、始まる、次で終わるなどの条件を定義できます。 また、行レベルのフィルターを使用して、 AND 同様に ORを使用して、条件を無効にする NOT.

次の手順で Analytics 行レベルのデータで、 行フィルター.

row-filter

左側のレールを使用してスキーマ階層間を移動し、選択したスキーマ属性を選択して、特定のスキーマをさらに詳しく掘り下げます。

左レール

設定する属性を特定したら、左側のパネルから属性を選択し、フィルタリングパネルにドラッグします。

filtering-panel

異なる条件を設定するには、「 次と等しい 次に、表示されるドロップダウンウィンドウから条件を選択します。

設定可能な条件のリストは次のとおりです。

  • equals
  • 次と等しくない
  • 次で始まる
  • 次の語句で終わる
  • 次で終わらない
  • 次を含む
  • 次を含まない
  • exists
  • 存在しない

条件

次に、選択した属性に基づいて、含める値を入力します。 次の例では、 Apple および Google は、 製造元 属性。

include-manufacturer

フィルター条件をさらに指定するには、スキーマから別の属性を追加してから、その属性に基づく値を追加します。 次の例では、 モデル 属性が追加され、 iPhone 13 および Google Pixel 6 は、取り込み用にフィルタリングされます。

include-model

新しいコンテナを追加するには、省略記号 (...) をクリックし、「 コンテナを追加.

add-container

新しいコンテナを追加したら、「 」を選択します。 次を含む 次に、「 除外 をクリックします。

除外

次に、スキーマ属性をドラッグし、フィルタリングから除外する値を追加して、同じ手順を完了します。 次の例では、 iPhone 12, iPhone 12 mini、および Google Pixel 5 はすべて、次の項目から除外されます。 モデル 属性、横置きは 画面の向き、およびモデル番号 A1633 次から除外: モデル番号.

終了したら、「次へ」を選択します。

exclude-examples

列レベルのフィルター

選択 列フィルター 列レベルのフィルターを適用するには、ヘッダーからを選択します。

column-filter

ページがインタラクティブスキーマツリーに更新され、列レベルでスキーマ属性が表示されます。 ここから、除外するデータの列を選択できます Profile 取り込み。 または、列を展開して、除外する特定の属性を選択することもできます。

デフォルトでは、すべて Analytics に移動します。 Profile このプロセスにより、XDM データのブランチをから除外できます。 Profile 取り込み。

終了したら、「次へ」を選択します。

列 — 選択済み

セカンダリ ID のフィルタリング

列フィルターを使用して、プロファイル取り込みからセカンダリ ID を除外します。 セカンダリ ID をフィルタリングするには、「 」を選択します 列フィルター 次に、「 _identities.

このフィルターは、ID がセカンダリとしてマークされている場合にのみ適用されます。 ID が選択されているが、イベントが発生し、その ID の 1 つがプライマリとしてマークされている場合、それらは除外されません。

secondary-identities

データフローの詳細を入力

データフローの詳細​手順が表示され、データフローの名前と説明(オプション)を入力する必要があります。 完了したら、「次へ」をクリックします。

dataflow-detail

レビュー

レビュー手順が表示され、新しい Analytics データフローを作成前にレビューすることができます。 接続の詳細は、次のようなカテゴリ別にグループ化されます。

  • 接続:接続のソースプラットフォームを表示します。
  • データタイプ:選択したレポートスイートと、対応するレポートスイート ID が表示されます。

レビュー

データフローの監視

データフローが完了したら、「 」を選択します。 データフロー を使用して、データのアクティビティとステータスを監視します。

データフロータブが選択されたソースカタログ。

組織内の既存の Analytics データフローのリストが表示されます。 ここから、ターゲットデータセットを選択し、それぞれの取り込みアクティビティを表示します。

組織内の既存のAdobe Analyticsデータフローのリスト。

The データセットアクティビティ ページには、Analytics からExperience Platformに送信されるデータの進行状況に関する情報が表示されます。 インターフェイスには、取り込まれたレコードの数、取り込まれたバッチの数、失敗したバッチの数などの指標が表示されます。

ソースは、2 つのデータセットフローをインスタンス化します。 1 つのフローはバックフィルデータ、もう 1 つはライブデータのフローを表します。 バックフィルデータは、リアルタイム顧客プロファイルに取り込むように設定されていませんが、分析およびデータサイエンスの使用例のためにデータレイクに送信されます。

バックフィル、ライブデータおよびそれぞれの待ち時間について詳しくは、 Analytics ソースの概要.

Adobe Analyticsデータの特定のターゲットデータセットのデータセットアクティビティページ。

 レガシー監視インターフェイスを使用した個々のバッチの表示

データセットアクティビティページには、個々のバッチのリストは表示されません。 個々のバッチのリストを表示するには、データセットアクティビティインターフェイスでグラフを選択します。

グラフが選択されたデータセットアクティビティページ。

「監視」ダッシュボードが表示されます。 次に、「 取り込みエラーのみ:はい をクリックして、フィルターをクリアし、個々のバッチのリストを表示します。

失敗フィルターが選択された監視ダッシュボード。

インターフェイスは、個々のバッチのリスト(それぞれの指標に関する情報を含む)を更新します。

バッチデータの従来の監視ページ。

指標 説明
バッチ ID 特定のバッチの ID。 この値は内部的に生成されます。
データセット名 Analytics データに使用される特定のデータセットの名前。
ソース 取り込んだデータのソース。
更新済み 最新のフロー実行反復の日付。
データセット内のレコード データセット内のレコードの合計数。 注意:このパラメーターは、場合によっては in-progress. このステータスは、レコードの取り込み処理がまだ完了していないことを示します。
新しいプロファイルフラグメント 取り込まれた新しいプロファイルフラグメントの合計数です。
既存のプロファイルフラグメント 既存のプロファイルフラグメントの合計数です。
ステッチされた ID レコード 取得後に結合された ID レコードの合計数。
プロファイル内のレコード リアルタイム顧客プロファイルに取り込まれたレコードの合計数です。

次の手順とその他のリソース

接続を作成すると、受信データを格納して選択したスキーマをデータセットに投入するデータフローが自動的に作成されます。さらに、データのバックフィルが発生し、最大 13 か月の履歴データを取り込みます。初回の取り込みが完了したら、Analytics データはダウンストリームの Platform サービス(Real-Time Customer Profileやセグメント化サービスなど)で使用されるようになります。詳しくは、次のドキュメントを参照してください。

次のビデオは、Adobe Analytics Source コネクタを使用したデータの取り込みに関する理解を深めることを目的としています。

警告

次のビデオに示す Platform UI は旧式のものです。最新の UI のスクリーンショットと機能については、上記のドキュメントを参照してください。

このページ