リレーショナルデータのミラー化と使用

このクイックスタートガイドでは、Experience Platform Data Mirror for Customer Journey Analyticsを使用して、Adobe Experience Platformのデータウェアハウスネイティブソリューションからリレーショナルデータをミラーリングする方法について説明します。 そのデータをCustomer Journey Analyticsで使用する必要があります。

このユースケースを実現するには、次のことが必要です。

  • データウェアハウスネイティブソリューション​を使用して、Experience Platformにミラーリングするデータを保存します。 Customer Journey Analyticsでそのデータを使用してレポートや分析を行います。

  • Experience Platformでスキーマ​を設定して、ミラーするデータのモデル(スキーマ)を定義します。

  • Experience Platformのソースコネクタ​を使用して、ミラーデータをデータセットに取り込みます。

  • Customer Journey Analytics で、接続を設定​します。 この接続には、(少なくとも)Experience Platform リレーショナルデータセットを含める必要があります。

  • Customer Journey Analytics で​ データ表示を設定 ​し、Analysis Workspace で使用する指標とディメンションを定義します。

  • Customer Journey Analytics で​ プロジェクトを設定 ​して、レポートとビジュアライゼーションを作成します。

Experience Platform Data Mirror Customer Journey Analytics版には、リレーショナルスキーマが必要です。

NOTE
このクイックスタートガイドは、Adobe Experience Platformでリレーショナルデータをミラーリングし、そのデータをCustomer Journey Analyticsで使用する方法に関する簡略化されたガイドです。 参照する際には、追加情報を調べることを強くお勧めします。
INFO
Customer Journey Analytics インターフェイスでは、リレーショナル​データセットは​ モデルベース ​としてラベル付けされる可能性があります。

データウェアハウスネイティブソリューションの使用

このクイック スタート ガイドでは、Google BigQueryをデータ ウェアハウス ネイティブ ソリューションとして使用します。 その他​ サポートされているソリューション ​SnowflakeAzure Databricksです。

Google BigQuery内では、次の例のデータが​ eventdata ​という名前のテーブルに定期的に保存および更新されます。

サンプルイベントデータの詳細
table 0-row-7 1-row-7 2-row-7 3-row-7 4-row-7 5-row-7 6-row-7 7-row-7 8-row-7 9-row-7 10-row-7 11-row-7 12-row-7 13-row-7 14-row-7 15-row-7 16-row-7 17-row-7 18-row-7 19-row-7 20-row-7 1-align-left 2-align-right 3-align-left 4-align-left 5-align-left 6-align-right 7-align-left 9-align-left 10-align-right 11-align-left 12-align-left 13-align-left 14-align-right 15-align-left 17-align-left 18-align-right 19-align-left 20-align-left 21-align-left 22-align-right 23-align-left 25-align-left 26-align-right 27-align-left 28-align-left 29-align-left 30-align-right 31-align-left 33-align-left 34-align-right 35-align-left 36-align-left 37-align-left 38-align-right 39-align-left 41-align-left 42-align-right 43-align-left 44-align-left 45-align-left 46-align-right 47-align-left 49-align-left 50-align-right 51-align-left 52-align-left 53-align-left 54-align-right 55-align-left 57-align-left 58-align-right 59-align-left 60-align-left 61-align-left 62-align-right 63-align-left 65-align-left 66-align-right 67-align-left 68-align-left 69-align-left 70-align-right 71-align-left 73-align-left 74-align-right 75-align-left 76-align-left 77-align-left 78-align-right 79-align-left 81-align-left 82-align-right 83-align-left 84-align-left 85-align-left 86-align-right 87-align-left 89-align-left 90-align-right 91-align-left 92-align-left 93-align-left 94-align-right 95-align-left 97-align-left 98-align-right 99-align-left 100-align-left 101-align-left 102-align-right 103-align-left 105-align-left 106-align-right 107-align-left 108-align-left 109-align-left 110-align-right 111-align-left 113-align-left 114-align-right 115-align-left 116-align-left 117-align-left 118-align-right 119-align-left 121-align-left 122-align-right 123-align-left 124-align-left 125-align-left 126-align-right 127-align-left 129-align-left 130-align-right 131-align-left 132-align-left 133-align-left 134-align-right 135-align-left 137-align-left 138-align-right 139-align-left 140-align-left 141-align-left 142-align-right 143-align-left 145-align-left 146-align-right 147-align-left 148-align-left 149-align-left 150-align-right 151-align-left 153-align-left 154-align-right 155-align-left 156-align-left 157-align-left 158-align-right 159-align-left 161-align-left 162-align-right 163-align-left 164-align-left 165-align-left 166-align-right 167-align-left
タイムスタンプ ID pagename personid トラッキングコード 注文件数 売上高
2025-03-06T19:15:39+00:00 10001 ホームページ person-1abc123 abc123
2025-03-06T19:15:39+00:00 10002 確認ページ person-1abc123 1 174.25
2025-03-06T19:15:39+00:00 10003 ホームページ person-2def123 def123
2025-03-06T19:15:39+00:00 10004 ホームページ person-3ghi123 ghi123
2025-03-06T19:15:39+00:00 10005 確認ページ person-3ghi123 1 149.25
2025-03-06T19:15:39+00:00 10006 ホームページ person-4abc456 abc456
2025-03-06T19:15:39+00:00 10007 ホームページ person-5def456 def456
2025-03-06T19:15:39+00:00 10008 ホームページ person-6ghi456 ghi456
2025-03-06T19:15:39+00:00 10009 確認ページ person-6ghi456 1 159.25
2025-03-06T19:15:39+00:00 10010 ホームページ person-7abc789 abc789
2025-03-06T19:15:39+00:00 10011 ホームページ person-8def789 def789
2025-03-06T19:15:39+00:00 10012 ホームページ person-9ghi789 ghi789
2025-03-06T19:15:39+00:00 10013 確認ページ person-9ghi789 1 124.25
2025-03-06T19:15:39+00:00 10014 ホームページ person-10abc987 abc987
2025-03-06T19:15:39+00:00 10015 ホームページ person-11def987 def987
2025-03-06T19:15:39+00:00 10016 ホームページ person-12ghi987 ghi987
2025-03-06T19:15:39+00:00 10017 ホームページ person-13abc654 abc654
2025-03-06T19:15:39+00:00 10018 ホームページ person-14def654 def654
2025-03-06T19:15:39+00:00 10019 ホームページ person-15ghi654 ghi654
2025-03-06T19:15:39+00:00 10020 確認ページ person-15ghi654 1 174.25

データは、関連するスキーマを持つデータベーステーブルに格納されます。 データベース・テーブルを検査するには、次の手順に従います。

  1. Google BigQueryにログインします。

  2. BigQuery > Studio​を選択します。

  3. プロジェクト、データセット、テーブルを選択します。 「スキーマ」タブに、イベントデータのスキーマの概要が表示されます。

    Google BigQuery - スキーマ ​

データを検査するには:

  1. クエリ​を選択します。

  2. クエリエディターでサンプルクエリを実行します。projectはプロジェクトの名前、datasetsはデータセットの名前です。

    code language-sql
    SELECT * FROM `project.datasets.eventdata` LIMIT 100
    

    Google BigQuery - サンプルクエリ ​

Experience Platform Data Mirror Customer Journey Analytics版の場合、データウェアハウスネイティブソリューションのテーブルを変更履歴に対して有効にする必要があります。 テーブルが変更履歴に対して有効になっていることを確認するには:

  1. クエリエディターで次のSQL ステートメントを実行して、設定を確認します。projectはプロジェクトの名前、datasetsはデータセットの名前です。

    code language-sql
    SELECT
       table_name,
       MAX(CASE WHEN option_name = 'enable_change_history' THEN option_value END) AS enable_change_history
    FROM `project.datasets.INFORMATION_SCHEMA.TABLE_OPTIONS`
    WHERE table_name = 'eventdata'
    GROUP BY table_name
    ORDER BY table_name;
    
  2. 結果が​ TRUE ​でない場合は、次のSQL ステートメントを使用して変更履歴を有効にします。ここで、projectはプロジェクトの名前、datasetsはデータセットの名前です。

    code language-sql
    ALTER TABLE `project.datasets.eventdata`
    SET OPTIONS (enable_change_history = TRUE);
    

データウェアハウスネイティブソリューションのテーブルにあるデータは、Customer Journey Analytics向けExperience Platform Data Mirrorの準備が整っています。

スキーマの設定

Experience Platformでデータをミラーリングするには、まずデータのスキーマを定義する必要があります。 Customer Journey Analyticsでミラーリングするデータと、Experience PlatformにExperience Platform Data Mirrorを使用するデータはすべて、リレーショナルスキーマに準拠している必要があります。

このデータをモデル化するスキーマを定義します。 スキーマを設定するには:

  1. Adobe Experience Platform UIの左側のパネルで、Data Management​内の​ Schemas ​を選択します。

  2. スキーマを作成」を選択します。

  3. ドロップダウンメニューから、リレーショナル​を選択します。

  4. 手動で作成​または​ DDL ファイルをアップロード ​のいずれかを選択するオプションを含むポップアップが表示される場合:

    1. 手動作成を選択」を選択します。

      ​ スキーマ設定 – 手動で作成

    2. 次へ」を選択します。

  5. スキーマ / リレーショナルスキーマ インターフェイスで、次の操作を行います。

    1. スキーマの表示名​を入力します。 例:Sample Event Feed Schema

    2. 説明​を入力します。 例:Sample event feed schema for a relational schema

    3. 時系列​を​ スキーマ動作 ​として選択します。 時系列ベース データには​ 時系列 ​を、レコードベース データには​ レコード ​を選択します。 ビヘイビアーは、スキーマの構造と含まれるプロパティを定義します。

      Customer Journey Analytics用Experience Platform Data Mirrorは、主に時系列データ(イベントデータなど)に使用されます。

      ​ スキーマ設定

    4. 完了」を選択します。

  6. スキーマ > サンプルイベントフィードスキーマ インターフェイスで、リレーショナルスキーマが変更行としての取り込みをサポートしているという警告が表示されます。

    ​ スキーマ設定

    変更行としての取り込みは、change data capture (CDC)とも呼ばれます。 変更データキャプチャをサポートするには、スキーマに次のものが必要です。

    • プライマリキー。
    • バージョン記述子。
    • 時系列データのタイムスタンプ記述子。
  7. サンプルイベントフィードスキーマ​の横にある AddCircle を選択して、スキーマにフィールドを追加します。 データタイプと追加属性を含む次のフィールドをスキーマに追加します。

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4
    フィールド名 表示名 タイプ 追加属性
    id Id 整数 SelectBox バージョン記述子
    orders Orders 整数
    pagename Page Name 文字列
    personid Person Id 文字列 SelectBox プライマリキー
    SelectBox ID
    ID名前空間にCRMIDを選択します。
    revenueamount Revenue Amount 倍精度浮動小数点
    timestamp Timestamp 日時 SelectBox タイムスタンプ記述子
    trackingcode Tracking Code 文字列
    • id フィールドは​ バージョン記述子 ​として設定されています。

      ​ バージョン記述子

      実際のシナリオでは、​ バージョン記述子としてより適切なフィールドを使用することをお勧めします。 例えば、最終更新時間を追跡するフィールドがあります。

    • personid フィールドが設定され、さらに​ timestamp ​が​ プライマリキー ​として設定されています。 追加 複合プライマリキーを作成​を選択して、複合キーを作成します。

      複合キー

      personid フィールドも​ ID ​として設定され、CRMID​が​ ID名前空間 ​として使用されます。

      人物記述子

      personid フィールドが​ プライマリキー ​である必要はありません。 実際のシナリオでは、personid​とは別に、プライマリキーを追跡するための異なるフィールドを持っている可能性が高いです。

    • タイムスタンプ フィールドが設定され、さらに​personid フィールドが​ プライマリキー ​として設定されています。 タイムスタンプ フィールドも​ タイムスタンプ記述子 ​として設定されます。 時系列リレーショナルデータのフィールドを​ タイムスタンプ記述子 ​として定義するだけで済みます。

      ​ タイムスタンプ記述子

    プライマリキーバージョン記述子タイムスタンプ記述子​を正しく定義すると、スキーマ定義の上の警告が消えます。

  8. 保存」を選択してスキーマを保存します。

同様に、レコードベースのリレーショナル ​ スキーマ ​を設定できます。 例えば、プロファイルとルックアップデータを含めるには。

ソースコネクタの使用

ソースコネクタを使用して、データウェアハウスネイティブソリューションをExperience Platformに接続します。

Experience Platformのインターフェイスで、次の操作を行います。

  1. ソース」を選択します。
  2. Google BigQuery​を選択または検索します。
  3. データを追加」を選択します。

データの追加ウィザードでは、次の手順に従って、Google BigQueryのテーブルからExperience Platformにデータを接続します。

認証

認証 ステップで、次を選択します。

  • Google BigQueryのアカウント設定が既にある場合の既存アカウント。 「​ データを選択」手順に進みます。

  • Google BigQueryに接続する必要がある場合は、新しいアカウント​を作成します。

    1. アカウント名​と(オプション) 説明​を指定します。

    2. 認証タイプ​を選択:基本認証​または​サービス認証。 選択内容に基づいて、必要な情報を入力します。

    3. ソースに接続」を選択

      Google BigQuery – 認証

      接続が確認されました。 CheckmarkCircleGreen Connected​は、接続が成功したことを示します。

    4. 次へ」を選択します。

    Snowflake DatabricksまたはAzure コネクタを使用する場合の接続方法と認証方法について詳しくは、Experience Platformのドキュメントを参照してください。

データを選択

データを選択​手順で、次の操作を行います。

  1. テーブルのリストからテーブルを選択します。 例:eventdata

    Experience Platform - Source コネクタ – データを選択

    確認のために表示されたデータのサンプルが表示されます。

  2. 次へ」をクリックして続行します。

データフローの詳細

データフローの詳細 ステップで、次の操作を行います。

  1. 変更データキャプチャを有効にする」を選択します。 詳細が記載された「データキャプチャ要件の変更」情報ボックスが表示されます。

  2. ターゲットデータセット​の​ 新しいデータセット ​を選択して、ミラーデータを含む新しいデータセットを作成します。

  3. 出力データセット名​を入力します。 例:event-data-mirror

  4. スキーマ ドロップダウンメニューから、以前に作成したリレーショナルスキーマを選択します。 例:サンプル イベント フィード スキーマ

    Experience Platform - Source コネクタ – データフローの詳細

  5. その他の詳細を指定してください。

  6. 次へ」を選択します。

マッピング

マッピング​手順で、以下を行います。

  1. Google BigQuery (Source data)のスキーマのフィールドを、Experience Platform (Target フィールド)で定義したスキーマのフィールドにマッピングします。

    Experience Platform - Source コネクタ – マッピング ​

  2. すべてのフィールドが正しくマッピングされている場合は、次へ​を選択して続行します。

スケジュール設定

スケジュール設定 ステップで、次の手順を実行します。

  1. 頻度​と​ 間隔 ​を指定して、ミラーデータの同期をスケジュールします。

  2. スケジュールの​ 開始時間 ​を指定します。

    Experience Platform - Source コネクタ – スケジュール ​

  3. 次へ」をクリックして続行します。

レビュー

レビュー​の手順で。

  1. ソースコネクタの設定を確認します。

    Experience Platform - Source コネクタ – レビュー

  2. 完了」を選択します。 設定されたデータフローに移動します。

    Experience Platform - Source コネクタ – データフロー

接続の設定

このクイックスタートガイドでは、Experience Platformのミラーデータを使用する新しい接続を作成します。 または、ミラー化されたデータを既存の接続に追加することもできます。

Customer Journey Analyticsのインターフェイスで、次の操作を行います。

  1. データ管理」メニューから「接続」を選択します。

  2. 新しい接続を作成」を選択します。

  3. 必要な​接続名サンドボックス1日のイベントの平均数​およびその他のオプションのパラメーターを指定します。

  4. データセットを追加」を選択します。

    1. データセットを追加​の​データセットを選択 ステップで:

      1. ミラーデータを含むデータセットを選択します。 例:event-data-mirror。 データセットには​ リレーショナル ​が​ データセットタイプ ​として含まれています。

        CJA - Connectons - データセットを追加

      2. 接続に関連する追加のデータセットを追加します。

      3. 次へ」を選択します。

    2. データセットを追加​の​データセット設定 ステップで:

      event-data-mirror リレーショナルデータセット

      1. イベント​を​ データセットタイプ ​として選択します。

      2. PersonId フィールドを​ Person ID ​として選択します。

      3. タイムスタンプ​は、タイムスタンプ​として自動的に入力されます。

      4. その他​を​ データソースタイプ ​として選択します。

      5. Google BigQuery Event Dataを​ データソースの説明 ​として入力します。

      6. すべての新しいデータの読み込みすべての既存データのバックフィル​など、その他の詳細を指定します。

        CJA – 接続 – データセット設定

      オプションで、他のデータセットの詳細を指定します。

    3. データセットを追加」を選択します。

  5. 保存」を選択します。

接続を作成した後、様々な管理タスクを実行できます。 ​ データセットの選択と結合接続のデータセットのステータスとデータ取り込みのステータス ​など。

データ表示の設定

データ表示を作成するには:

  1. Customer Journey Analytics インターフェイスの上部メニューで、Data views、オプションで​ Data management ​を選択します。

  2. 新しいデータ表示を作成」を選択します。

  3. 設定​手順で、次の操作を行います。

    1. 接続​リストで接続を選択します。

    2. 接続に名前を付け、(オプションで)説明します。

    3. 保存して続行」を選択します。

  4. コンポーネント​手順で、次の操作を行います。

    1. 指標​または​ ディメンション ​コンポーネントボックスに含めるスキーマフィールドや標準コンポーネントを追加します。 ミラーデータを含むデータセットから関連フィールドを追加します。 これらのフィールドにアクセスするには:

      1. イベントデータセット​を選択します。

      2. アドホックおよびリレーショナルフィールド」を選択します。

      3. リレーショナルスキーマから​ 指標 ​または​ ディメンション ​にフィールドをドラッグ&ドロップします。

        ​ リレーショナルフィールドをコンポーネントとして追加

    2. 適切なタイプを持たないフィールド、適切な形式でないフィールド、または他の理由で変更したいフィールドに対して、派生フィールドを定義します。 例えば、収益金額​の場合です。

      1. 派生フィールドを作成を選択します。

      2. 派生フィールドエディターで、次の操作を行います。

        1. 以下のように、新しいRevenue Amount (Numeric) フィールドを定義します。

          CJA - データビュー – 派生フィールド ​

        2. 保存」を選択します。

      3. 新しい​ 売上額(数値) ​派生フィールドをドラッグし、指標​にフィールドをドロップします。

        CJA - データビュー – リレーショナルフィールド ​

    3. 保存して続行」を選択します。

  5. 設定​手順で、次の操作を行います。

    設定をそのままにし、「保存して終了」を選択します。

データビューの作成および編集方法について詳しくは、​ データビューの概要を参照してください。 また、データビューで使用できるコンポーネントや、セグメントとセッションの設定の使用方法についても説明します。

プロジェクトの設定

Analysis Workspaceは、データにもとづいて分析データを迅速に構築し、インサイトを共有できる柔軟なブラウザーツールです。 ワークスペースプロジェクトでは、データコンポーネント、テーブル、およびビジュアライゼーションを組み合わせて、分析を作成し、組織内の任意のユーザーと共有できます。

プロジェクトを作成するには:

  1. Customer Journey Analytics インターフェイスで、上部メニューの​ Workspace ​を選択します。

  2. 左側のナビゲーションの「プロジェクト」を選択します。

  3. プロジェクトを作成」を選択します。 ポップアップで以下を行います。

    1. 空白のWorkspace プロジェクト​を選択します。

    2. 作成」を選択します。

  4. 新規プロジェクト ワークスペースで、​ データビューが選択されていることを確認します。 このデータビューは、ミラー化されたデータを含む接続にリンクしています。

  5. 最初のレポートを作成するには、自由形式 パネルの​ 自由形式テーブル ​にディメンションと指標をドラッグ&ドロップします。 例えば、売上額(数値)​を​ 指標をここにドラッグ ​します。 PersonId​をドラッグして、最初の列ヘッダーにフィールドをドロップします。 その他の調整も必要に応じて行います。

    最終的な結果は、Google BigQuery テーブルからのミラーデータに基づくプロファイルとその収益の概要です。

    Workspace - サンプルプロジェクト ​

コンポーネント、ビジュアライゼーション、パネルを使用してプロジェクトを作成し、分析を構築する方法について詳しくは、Analysis Workspace の概要を参照してください。

SUCCESS
すべての手順が完了しました。 まず、データウェアハウスネイティブソリューションから収集するミラーデータ(スキーマ)を定義することから始めました。 Experience Platformのどこにデータ(データセット)を保存するのかを指定できます。 適切なソースコネクタを設定して、Experience Platformのミラーデータを提供しました。 Customer Journey Analyticsで接続を定義して、ミラー化されたイベントデータと(オプションで)その他のデータを使用します。 データビュー定義では、ミラーデータから使用するディメンションと指標を指定できます。 そして、最初のプロジェクトは、ミラーデータの可視化と分析でした。
recommendation-more-help
analytics-platform-help-main