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

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

サンプルデータの使用例

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

このチュートリアルでは、Lumaという架空の小売ブランドに焦点を当てています。 Lumaは、複数の国でレンガ型店舗を展開し、Webサイトやモバイルアプリを使ってオンラインでプレゼンスを得ています。 彼らは、忠誠度、CRM、Web、オフライン購入データをリアルタイムの顧客プロファイルに組み合わせて、これらのプロファイルをアクティブ化し、マーケティングを次のレベルに進めるために、Adobe Experience Platformに投資しています。 Luma用にサンプルデータを生成し、次のセクションでは、Experience Platformにデータをインポートする方法を検討できます。

このチュートリアルを完了するには、ポストマンアプリケーションのUIを使用するか、またはポストマン用のコレクションランナー(Newman)を使用します

前提条件

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

ポストマンを使用

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

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

  1. DataInExperiencePlatformという名前のローカルマシン上にフォルダーを作成し、チュートリアルで使用するファイルの保存に使用します

  2. このチュートリアルに必要なファイルを含むdata.zipファイルをダウンロードします。

  3. 解凍してDataInExperiencePlatformフォルダーの下に保存します。

  4. 後でfile_path環境変数を設定する際に必要になる可能性があるので、場所をメモしておいてください。

  5. Postmanを起動し、新しいワークスペースを作成します。

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

  7. ワークスペースの​名前​とオプションの​概要​を入力し、ワークスペースを作成​をクリックします。 ポストマンは、作成時に新しいワークスペースに切り替わります。
    ワークスペースの保存

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

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

    設定

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

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

    環境のインポート

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

  13. 次の環境変数が入力されていることを確認します。 以下の環境変数の値は、Adobe開発者コンソールプロジェクトから取得できます

    • 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変数を、zip.fileをダウンロードしたローカルフォルダーに更新します。 変数を編集するには、左側の環境から環境を開くか、ポストマンの右上にある環境のクイックルック(目のボタン)を開いて「編集」をクリックします。
    File Path

  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の遅延を指定し、「応答を保存」オプションをチェックし、実行順序が正しいことを確認します。 「ルーマ忠誠度データを実行」ボタンをクリックします

    コレクションの読み込み

    メモ

    ルーマ忠誠度 — データ収集を実行すると、顧客忠誠度データを含むスキーマが作成されます。このスキーマは、カスタムミックスインとデータタイプを含むXDM個々のプロファイルクラスに基づいています。 コレクションはまた、スキーマを使用してデータセットを作成し、サンプルの顧客忠誠度データをAdobe Experience Platformにアップロードします。

    メモ

    ポストマン収集ランナーの実行中に収集リクエストが失敗した場合は、実行を停止し、収集リクエストを1つずつ実行します。

  22. すべての処理が正常に完了した場合は、Luma-Loyalty-Dataコレクション内のすべてのリクエストが渡されます。

    忠誠度の結果

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

  24. Luma Loyalty Datasetデータセットを開き、データセットアクティビティウィンドウの下で、1000レコードを取り込んだ正常なバッチ実行を表示できます。 また、「プレビューデータセット」オプションをクリックして、取り込むレコードを確認することもできます。
    忠誠度データセット

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

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

Newmanを使う

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

NodeJsとNewmanのインストール

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

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

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

  4. ここの手順に従って、新しいマニュアルをシステムにインストールします。

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

  6. DataInExperiencePlatformという名前のローカルマシン上にフォルダーを作成し、チュートリアルで必要なファイルの保存に使用します

  7. data.zipファイルをダウンロードします。このファイルには、このチュートリアルに必要なファイルが含まれています。

  8. 解凍してDataInExperiencePlatformフォルダーの下に置きます。

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

  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 PlatformUIにログインし、データセットに移動します。

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

  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

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

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

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

このページ

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now