Adobe Experience Platformへのサンプルデータの読み込み

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

サンプルデータの使用例

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

このチュートリアルでは、Lumaという架空の小売ブランドに焦点を当てています。 Lumaは、複数の国で実店舗を運営し、Webサイトやモバイルアプリでオンラインプレゼンスを発揮します。 Adobe Experience Platformに投資し、ロイヤリティ、CRM、Web、オフライン購入のデータをリアルタイム顧客プロファイルに組み合わせ、これらのプロファイルをアクティブ化して、マーケティングを次のレベルに進めます。 Luma用にサンプルデータが生成され、次の節では、データを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にアップロードします。

    メモ

    ポストマンコレクションランナーでコレクションリクエストが失敗した場合は、実行を停止し、コレクションリクエストを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

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

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

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

このページ