サンプルデータをAdobe Experience Platformに読み込む

一部のサンプルデータを使用してExperience Platformサンドボックス環境を設定する方法について説明します。 Postman コレクションを使用して、フィールドグループ、スキーマ、データセットを作成し、サンプルデータをExperience Platformに読み込むことができます。

データの使用例

Experience Platformのビジネスユーザーは、多くの場合、フィールドグループの識別、スキーマの作成、データの準備、データセットの作成、データの取り込みなど、一連の手順を実行してから、Experience Platformが提供する機能の一部を調べる必要があります。 このチュートリアルでは、いくつかの手順を自動化し、可能な限り早く Platform でデータを取得する簡単な方法を見つけることができます。

このチュートリアルでは、Luma という架空の小売ブランドに焦点を当てています。 Luma は、複数の国で実店舗を運営し、Web サイトやモバイルアプリとのオンラインプレゼンスを持っています。 ロイヤリティ、CRM、Web、オフラインの購入データをリアルタイム顧客プロファイルに組み合わせ、これらのプロファイルをアクティブ化して、マーケティングを次のレベルに引き上げます。 Luma 用にサンプルデータが生成され、次の節では、データをExperience Platformにインポートする方法を確認できます。

このチュートリアルを完了するには、Postman アプリケーションの UI を使用するか、コマンドライン Collection Runner for Postman (Newman) を使用します。

前提条件

  • 認証済みで、Experience PlatformAPI にアクセスできる。 そうでない場合は、この チュートリアル に従ってすばやく設定できます。
  • Experience Platformサンドボックス環境にアクセスできます。

Postman の使用

Postman コレクションの読み込みと環境変数の設定

手順に従う前に、Postman アプリケーションをダウンロードし、Experience PlatformAPI にアクセスできることを確認してください。 このチュートリアルでは、サンドボックス環境を使用します。 リソースとデータを実稼動環境に混在させることなく、機能を試すことができる孤立した環境を提供します。 始めましょう。

メモ

platform-utils-main.zip ファイルに含まれるユーザーデータは架空のもので、デモ目的でのみ使用します。

  1. platform-utils-main.zip ファイルをダウンロードします。このファイルには、このチュートリアルで必要なすべてのファイルが含まれています。

  2. ダウンロードフォルダーから、platform-utils-main.zip ファイルをコンピューター上の目的の場所に移動し、解凍します。

  3. 解凍したファイルの場所をメモしておいてください。後で FILE_PATH postman 環境変数を設定する際に必要になる可能性があります

    メモ

    Macのファイルパスを取得するには、platform-utils-main フォルダーに移動し、そのフォルダーを右クリックして「情報を取得」オプションを選択します。

    Macファイルパス

    メモ

    ウィンドウ上のファイルパスを取得するには、目的のフォルダの場所をクリックして開き、アドレスバーのパスの右側を右クリックします。 アドレスをコピーして、ファイルパスを取得します。

    Windows のファイルパス

  4. Postman を起動し、新しいワークスペースを作成します。 where メタデータ値を

  5. 新しいワークスペースを作成するには、Postman の左側にある Workspaces ドロップダウンメニューを使用します。 既存のワークスペースを選択するか、プロジェクト用の新しいワークスペースを作成できます。
    ワークスペースの作成

  6. ワークスペースに 名前 とオプションの 概要 を入力し、「ワークスペースを作成」をクリックします。 Postman は、新しいワークスペースを作成する際に、新しいワークスペースに切り替えます。
    ワークスペースの保存

  7. 次に、このワークスペースで Postman コレクションを実行するための追加の設定を行います。 Postman のヘッダーで、レンチアイコンをクリックし、「設定」を選択して、設定モーダルを開きます。 キーボードショートカット (CMD/CTRL + ,) を使用して、モーダルを開くこともできます。

  8. General」タブで、リクエストのタイムアウト(ミリ秒)を 5000 ms に更新し、allow reading file outside this directory を有効にします。

    設定

    メモ

    作業ディレクトリ内からファイルが読み込まれる場合、同じファイルが他のデバイスに格納されていれば、デバイス間でスムーズに実行されます。 ただし、外部の作業ディレクトリからファイルを実行する場合は、同じ意図を示す設定を有効にする必要があります。 FILE_PATH がポストマンの作業ディレクトリパスと同じでない場合は、このオプションを有効にする必要があります。

  9. 設定パネルを閉じます。

  10. 「環境」オプションを選択し、「インポート」オプションをクリックします。
    環境のインポート

  11. ダウンロードした JSON 環境ファイル DataInExperiencePlatform.postman_environment をインポートし、インポート をクリックします。

  12. Postman で、右上のドロップダウンから環境を選択し、目のアイコンをクリックして環境変数を表示します。
    環境の選択

  13. 次の環境変数が設定されていることを確認します。 Experience Platform変数の値を取得する方法については、 環境 API に対する認証 のチュートリアルで、手順を確認してください。

    • CLIENT_SECRET
    • API_KEY
    • TECHNICAL_ACCOUNT_ID
    • META_SCOPE
    • IMS
    • IMS_ORG
    • PRIVATE_KEY
    • SANDBOX_NAME
    • CONTAINER_ID
    • TENANT_ID
    • platform_end_point
    • FILE_PATH
    • PRIVATE_KEY
  14. FILE_PATH 変数を、platform-utils-main.zip ファイルを解凍したローカルフォルダーのパスに更新します。 変数を編集するには、左側の「環境」から環境を開くか、Postman の右上にある環境のクイックルック(目のボタン)を開いて「編集」をクリックします。
    ファイルパス

  15. 次に、次の環境変数の値を設定する必要があります。 それには、収集ファイルをワークスペースにアップロードする必要があります。

    • JWT_TOKEN
    • ACCESS_TOKEN
  16. コレクションを選択して、読み込みオプションを選択します。

    コレクション

  17. 次のコレクションファイルを Postman に読み込みます。

    • Authentication.postman_collection.json
    • Luma-Loyalty-Data.postman_collection.json
    • Luma-CRM-Data.postman_collection.json
    • Luma-Product-Catalog.postman_collection.json
    • Luma-Offline-Purchase-Events.postman_collection.json

    コレクションの読み込み

  18. Authentication コレクションを開き、IMS: JWT Generate + Auth via User TokenPOSTリクエストを選択し、SEND をクリックして認証し、アクセストークンを取得します。

    コレクションの読み込み

  19. 環境変数を確認すると、JWT_TOKENACCESS_TOKEN が設定されていることがわかります。

  20. Luma-Loyalty-Data コレクションを開き、「概要」タブの「実行」をクリックして、コレクションランナーを起動します。

    コレクションの読み込み

  21. コレクションランナーウィンドウで、ドロップダウンから環境を選択し、4000 ms の遅延を指定し、「応答を保存」オプションをチェックして、実行順序が正しいことを確認します。 「Luma ロイヤリティデータを実行」ボタンをクリックします

    コレクションの読み込み

    メモ

    Luma-Loyalty-Datacollection を実行す ると、顧客の忠誠度データを格納するスキーマが作成されます。このスキーマは、カスタムフィールドグループとデータタイプで構成される XDM Individual Profile クラスに基づいています。 また、コレクションは、スキーマを使用してデータセットを作成し、顧客の忠誠度のサンプルデータをAdobe Experience Platformにアップロードします。

    メモ

    Postman 収集ランナーでコレクションリクエストが失敗した場合は、実行を停止し、コレクションリクエストを 1 つずつ実行します。

  22. すべて正常に動作する場合は、Luma-Loyalty-Data コレクション内のすべてのリクエストが渡されます。

    Loyalty Result

  23. 次に、Adobe Experience Platform UI にログインし、データセットに移動します。

  24. Luma Loyalty Dataset データセットを開き、データセットアクティビティウィンドウで、1,000 件のレコードを取り込んだ正常なバッチ実行を確認できます。 「データセットのプレビュー」オプションをクリックして、取得したレコードを確認することもできます。
    ロイヤルティデータセット

  25. 手順 21~23 を繰り返して、次のコレクションを実行します。

    • Luma-CRM-Data.postman_collection.json :収集の実行によって、顧客の CRM データを含むスキーマが作成されます。このスキーマは、人口統計の詳細、個人の連絡先の詳細、Luma ID プロファイルのフィールドグループで構成される XDM Individual Profile クラスに基づいています。 また、コレクションは、スキーマを使用してデータセットを作成し、サンプルの顧客 CRM データをAdobe Experience Platformにアップロードします。
    • Luma-Product-Catalog.postman_collection.json :コレクションの実行によって、製品カタログ情報を含むスキーマが作成されます。このスキーマは、製品カタログの mixin、コマースの詳細、消費者エクスペリエンスイベントの mixin で構成されるカスタムクラスに基づいています。 また、コレクションは、スキーマを使用してデータセットを作成し、製品データをAdobe Experience Platformにアップロードします。
    • Luma-Offline-Purchase-Events.postman_collection.json:収集の実行では、顧客のオフライン購入イベントデータを含むスキーマを作成します。このスキーマは XDM ExperienceEvent クラスに基づいており、顧客の忠誠度情報とそのオフライン購入イベントをキャプチャするためのフィールドグループで構成されます。 また、コレクションは、スキーマを使用してデータセットを作成し、オフラインの購入イベントデータをAdobe Experience Platformにアップロードします。

Newman の使用

手順に従う前に、Experience PlatformAPI にアクセスできることを確認してください。 このチュートリアルでは、サンドボックス環境を使用します。サンドボックス環境は、リソースとデータを実稼動環境に混在させずに機能を試すことができる独立した環境を提供します。

NodeJs と Newman のインストール

  1. Newman を実行するには、Node.js >= v10 があることを確認します。 パッケージマネージャーを使用して Node.js をインストールします

  2. コマンド node -v を実行して、ノードがインストールされていることを確認します。

  3. Newman をインストールする最も簡単な方法は、NPM を使用することです。 Node.js がインストールされている場合は、NPM もインストールされている可能性が高くなります。

  4. こちら の手順に従って、システムに新しいメンバーをインストールします。

  5. コマンド newman -v を実行して、newman がインストールされていることを確認します。

  6. platform-utils-main.zip ファイルをダウンロードします。このファイルには、このチュートリアルで必要なすべてのファイルが含まれています。

  7. ダウンロードフォルダーから、platform-utils-main.zip ファイルをコンピューター上の目的の場所に移動し、解凍します。

  8. 解凍したファイルの場所をメモしておいてください。後で FILE_PATH postman 環境変数を設定する際に必要になる可能性があります

  9. ターミナルウィンドウで platform-utils-main フォルダを開きます。

  10. Luma-Loyalty-Data.postman_collection.json を実行して、フィールドグループ、スキーマ、データセットを作成し、サンプルのロイヤルティデータをAdobe Experience Platformに取り込みます

    • newman run Luma-Loyalty-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json —insecure --delay-request 4000
  11. すべて正常に動作する場合は、Luma-Loyalty-Data コレクション内のすべてのリクエストが渡されます。

  12. 次に、Adobe Experience Platform UI にログインし、データセットに移動します。

  13. Luma Loyalty Dataset データセットを開き、データセットアクティビティウィンドウで、1,000 件のレコードを取り込んだ正常なバッチ実行を確認できます。 「データセットのプレビュー」オプションをクリックして、取得したレコードを確認することもできます。

    ロイヤルティデータセット

  14. 手順 10 ~ 13 を繰り返して、次のコレクションの下で実行します。

    • Luma-CRM-Data.postman_collection.json を実行して、フィールドグループ、スキーマ、データセットを作成し、サンプルの CRM データをAdobe Experience Platformに取り込みます
      • newman run Luma-CRM-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Luma-Product-Catalog.postman_collection.json を実行して、フィールドグループ、スキーマ、データセットを作成し、サンプルの製品データをAdobe Experience Platformに取り込みます。
      • newman run Luma-Product-Catalog.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Luma-Offline-Purchase-Events.postman_collection.json を実行して、フィールドグループ、スキーマ、データセットを作成し、サンプルの製品データをAdobe Experience Platformに取り込みます。
      • newman run Luma-Offline-Purchase-Events.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000

サンドボックス環境のリセット

非実稼動用サンドボックスをリセットすると、そのサンドボックスに関連付けられているすべてのリソース(スキーマ、データセットなど)が削除され、サンドボックスの名前と関連する権限が維持されます。 この「クリーン」なサンドボックスは、引き続き、アクセス権を持つユーザーと同じ名前で使用できます。

サンドボックス環境をリセットするには、 ここ の手順に従います。

このページ