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

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

データの使用例

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

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

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

前提条件

  • 認証済みで、Experience PlatformAPI へのアクセス権がある。 そうでない場合は、次の手順を実行してすばやく設定できます チュートリアル.
  • Experience Platformサンドボックス環境にアクセスできます。
  • 使用するExperience Platformテナント ID がわかります。 テナント ID は、Platform アカウントにログインする際に URL に表示されます。 次の URL では、テナントは「techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home. また、 API リクエスト.

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

  6. を入力します。 名前 およびオプション 概要 (ワークスペースの場合)、 ワークスペースを作成. Postman は、作成時に新しいワークスペースに切り替わります。
    ワークスペースを保存

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

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

    設定

    メモ

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

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

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

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

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

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

    • 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 Token POSTリクエストを表示し、 SEND をクリックして、アクセストークンを認証および取得します。

    コレクションの読み込み

  19. 環境変数を確認すると、 JWT_TOKEN および ACCESS_TOKEN が設定されました。

  20. luma-data フォルダー、すべての json ファイルを編集し、 _techmarketingdemos 前にアンダースコアが付いた独自のテナント id が付きます。

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

    コレクションの読み込み

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

    コレクションの読み込み

    メモ

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

    メモ

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

  23. すべてが正常に動作する場合、 Luma-Loyalty-Data コレクションが渡されます。

    ロイヤルティ結果

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

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

  26. 手順 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

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

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

手順に従います。 ここ :サンドボックス環境をリセットする場合。

このページ