環境変数の設定

手順に従う前に、Postman アプリケーションをダウンロードしたことを確認します。 それでは、始めましょう。

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

    メモ
    platform-utils-main.zip ファイルに含まれるユーザーデータは架空のもので、デモ目的でのみ使用されます。
  2. ダウンロードフォルダーから platform-utils-main.zip ファイルをコンピューター上の目的の場所に移動し、解凍します。

  3. luma-data フォルダーで、すべての json ファイルをテキストエディターで開き、_yourTenantId のすべてのインスタンスを独自のテナント ID に置き換え、先頭にアンダースコアを付けます。

  4. luma-offline-purchases.jsonluma-inventory-events.jsonluma-web-events.json をテキストエディターで開き、先月のイベントが発生するようにすべてのタイムスタンプを更新します(例えば、"timestamp":"2022-11 を検索して年と月を置き換える)

  5. 展開されたフォルダーの場所に注意してください。後で FILE_PATH Postman 環境変数を設定する際に必要になります。

    メモ
    Macのファイルパスを取得するには、platform-utils-main フォルダーに移動し、そのフォルダーを右クリックして 情報を取得 オプションを選択します。
    MAC ファイル パス
    メモ
    Windows でファイル パスを取得するには、目的のフォルダの場所をクリックして開き、アドレス バーのパスの右側を右クリックします。 アドレスをコピーしてファイルパスを取得します。
    Windows ファイルパス
  6. Postman を開き、ワークスペース ドロップダウンメニューからワークスペースを作成します。
    ワークスペースを作成

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

  8. 次に、このワークスペースで Postman コレクションを実行するように、いくつかの設定を調整します。 Postman のヘッダーで、歯車アイコンをクリックし、「設定 を選択して、設定モーダルを開きます。 キーボードショートカット(CMD/CTRL +)を使用してモーダルを開くこともできます。

  9. General」タブで、リクエストタイムアウトをミリ秒単位で更新して、5000 ms を有効にし allow reading file outside this directory す。
    設定

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

  11. 環境 を選択してから、「読み込み」を選択します。
    環境のインポート

  12. ダウンロードした json 環境ファイル DataInExperiencePlatform.postman_environment を読み込みます。

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

  14. 次の環境変数が入力されていることを確認します。 環境変数の値の取得方法について詳しくは、Experience Platform API への認証チュートリアルを参照してください。

    • CLIENT_SECRET
    • API_KEY—Adobe Developer Consoleの Client ID
    • SCOPES
    • TECHNICAL_ACCOUNT_ID
    • IMS
    • IMS_ORG—Adobe Developer Consoleの Organization ID
    • SANDBOX_NAME
    • TENANT_ID – 必ずアンダースコアを付けてください(例:_techmarketingdemos)。
    • CONTAINER_ID
    • platform_end_point
    • FILE_PATH - platform-utils-main.zip ファイルを解凍したローカルフォルダーパスを使用します。 フォルダー名(例:/Users/dwright/Desktop/platform-utils-main)を含めてください
  15. 更新した環境 保存

Postman コレクションのインポート

次に、コレクションをPostmanにインポートする必要があります。

  1. コレクション を選択してから、読み込みオプションを選択します。

    コレクション

  2. 次のコレクションを読み込みます。

    • 0-Authentication.postman_collection.json
    • 1-Luma-Loyalty-Data.postman_collection.json
    • 2-Luma-CRM-Data.postman_collection.json
    • 3-Luma-Product-Catalog.postman_collection.json
    • 4-Luma-Offline-Purchase-Events.postman_collection.json
    • 5-Luma-Product-Inventory-Events.postman_collection.json
    • 6-Luma-Test-Profiles.postman_collection.json
    • 7-Luma-Web-Events.postman_collection.json

    コレクションのインポート

認証

次に、ユーザートークンを認証および生成する必要があります。 このチュートリアルで使用するトークン生成方法は、実稼動以外での使用にのみ適しています。 ローカル署名は、サードパーティホストからJavaScript ライブラリを読み込み、リモート署名は、秘密鍵をAdobeが所有および運用する web サービスに送信します。 Adobeはこの秘密鍵を保存しませんが、実稼働キーは誰とも共有しないでください。

  1. 0-Authentication コレクションを開き、OAuth: Request Access Token リクエストを選択し、「SEND」をクリックして認証し、アクセストークンを取得します。

    コレクションのインポート

  2. 環境変数を確認し、ACCESS_TOKEN が入力されていることを確認します。

データのインポート

これで、データを準備して Platform サンドボックスに読み込むことができます。 読み込んだPostman コレクションで重作業がすべて行われます。

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

    コレクションのインポート

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

    コレクションのインポート

    メモ
    1-Luma-Loyalty-Data 顧客のロイヤルティデータのスキーマを作成します。 このスキーマは、XDM Individual Profile クラス、標準フィールドグループ、カスタムフィールドグループおよびデータタイプに基づいています。 コレクションは、スキーマを使用してデータセットを作成し、サンプルの顧客ロイヤルティデータをAdobe Experience Platformにアップロードします。
    メモ
    Postman Collection Runner の実行中にコレクションリクエストが失敗した場合は、実行を停止し、コレクションリクエストを 1 つずつ実行します。
  3. 問題がなければ、Luma-Loyalty-Data コレクション内のすべてのリクエストが合格します。

    ロイヤルティの結果

  4. 次に、Adobe Experience Platform インターフェイスにログインしデータセットに移動します。

  5. Luma Loyalty Dataset データセットを開き、データセットアクティビティ ウィンドウで、1,000 件のレコードを取り込んだ正常なバッチ実行を表示できます。 「データセットをプレビュー」オプションをクリックして、取り込んだレコードを確認することもできます。 1,000 個の ​ 新しいプロファイルフラグメント ​ が作成されたことを確認するには、数分待つ必要がある場合があります。
    ロイヤルティデータセット

  6. 手順 1 ~ 3 を繰り返し、他のコレクションを実行します。

    • 2-Luma-CRM-Data.postman_collection.json は、顧客の CRM データ用のスキーマと入力されたデータセットを作成します。 このスキーマは、デモグラフィックの詳細、個人の連絡先の詳細、環境設定の詳細、カスタム ID フィールドグループで構成される XDM 個人プロファイル クラスに基づいています。
    • 3-Luma-Product-Catalog.postman_collection.json は、製品カタログ情報のスキーマと入力されたデータセットを作成します。 このスキーマは、カスタム製品カタログクラスに基づいており、カスタム製品カタログフィールドグループを使用します。
    • 4-Luma-Offline-Purchase-Events.postman_collection.json は、顧客のオフライン購入イベントデータ用にスキーマと入力されたデータセットを作成します。 スキーマは XDM ExperienceEvent クラスに基づいており、カスタム ID とCommerceの詳細フィールドグループで構成されます。
    • 5-Luma-Product-Inventory-Events.postman_collection.json は、在庫の出入りする製品に関連するイベントのスキーマと入力されたデータセットを作成します。 このスキーマは、カスタムビジネスイベントクラスとカスタムフィールドグループに基づいています。
    • 6-Luma-Test-Profiles.postman_collection.json は、Adobe Journey Optimizerで使用するテストプロファイルを含むスキーマと入力されたデータセットを作成します
    • 7-Luma-Web-Events.postman_collection.json は、単純な履歴 web データを含むスキーマと入力されたデータセットを作成します。

検証

サンプルデータは、コレクションを実行すると、複数のシステムからのデータを組み合わせたリアルタイム顧客プロファイルが構築されるように設計されています。 この良い例としては、ロイヤルティ、CRM、オフライン購入の各データセットの最初のレコードがあります。 そのプロファイルを検索して、データが取り込まれたことを確認します。 Adobe Experience Platform インターフェイス:

  1. プロファイル/参照 に移動します。
  2. Luma Loyalty IdID 名前空間 として を選択します
  3. 5625458ID 値 として を検索します
  4. Daniel Wright プロファイルを開きます。
ヒント
プロファイルが表示されない場合は、「​ データセット ​」ページをチェックして、すべてのデータセットが正常に作成されてデータを取り込んだことを確認します。 問題がないようであれば、15 分待って、プロファイルがビューアで使用できるかどうかを確認します。 データの取り込みに問題があった場合は、エラーメッセージを確認して問題を見つけます。 また、​ データセット ​ ページでエラー診断を有効にし、json データファイルをドラッグ&ドロップしてデータを再度取り込むこともできます。

プロファイルを開く

属性」タブと イベント タブでデータを参照すると、プロファイルに様々なデータファイルのデータが含まれていることがわかります。
オフライン購入イベントファイルからのイベントデータ

次の手順

Adobe Journey Optimizerについて学びたい場合は、このサンドボックスに、Journey Optimizerの課題に取り組むために必要なすべてが含まれています

結合ポリシー、データガバナンス、クエリサービス、セグメントビルダーについて詳しくは、 データアーキテクトおよびデータエンジニア向けスタートガイド チュートリアルのレッスン 11 に進んでください。 この他のチュートリアルの前のレッスンでは、これらのPostman コレクションで入力されたすべてのものを手動で構築しました。すぐに始めましょう。

このサンドボックスにリンクする web SDKのサンプル実装を作成する場合は、
Web SDKを使用したAdobe Experience Cloudの実装チュートリアル。 Web SDK チュートリアルの「初期設定」、「タグ設定」、「Experience Platformの設定」の各レッスンを設定したら、パスワード luma-crm.json を使用して、test ファイルの最初の 10 個のメールアドレスで Luma web サイトにログインし、プロファイルフラグメントがこのチュートリアルでアップロードしたデータと結合されることを確認します。

サンプルの Mobile SDK実装を作成して、このサンドボックスにリンクするには、以下を実行します
モバイルアプリでのAdobe Experience Cloudの実装のチュートリアル。 Web SDK チュートリアルの「初期設定」、「アプリの実装」、「Experience Platform」のレッスンを設定したら、luma-crm.json ファイルの最初のメールアドレスを使用して Luma web サイトにログインし、このチュートリアルでアップロードされたデータとプロファイルフラグメントの結合を確認します。