環境変数の設定
手順に従う前に、Postman アプリケーションをダウンロードしたことを確認します。 それでは、始めましょう。
-
このチュートリアルに必要なすべてのファイルを含んだ platform-utils-main.zip ファイルをダウンロードします。
メモ
platform-utils-main.zip ファイルに含まれるユーザーデータは架空のもので、デモ目的でのみ使用されます。 -
ダウンロードフォルダーから
platform-utils-main.zip
ファイルをコンピューター上の目的の場所に移動し、解凍します。 -
luma-data
フォルダーで、すべてのjson
ファイルをテキストエディターで開き、_yourTenantId
のすべてのインスタンスを独自のテナント ID に置き換え、先頭にアンダースコアを付けます。 -
luma-offline-purchases.json
、luma-inventory-events.json
、luma-web-events.json
をテキストエディターで開き、先月のイベントが発生するようにすべてのタイムスタンプを更新します(例えば、"timestamp":"2022-11
を検索して年と月を置き換える) -
展開されたフォルダーの場所に注意してください。後で
FILE_PATH
Postman 環境変数を設定する際に必要になります。メモ
Macのファイルパスを取得するには、platform-utils-main
フォルダーに移動し、そのフォルダーを右クリックして 情報を取得 オプションを選択します。メモ
Windows でファイル パスを取得するには、目的のフォルダの場所をクリックして開き、アドレス バーのパスの右側を右クリックします。 アドレスをコピーしてファイルパスを取得します。 -
Postman を開き、ワークスペース ドロップダウンメニューからワークスペースを作成します。
-
ワークスペースの 名前 とオプションの 概要 を入力し、「Workspaceを作成」をクリックします。 新 Postman いワークスペースを作成すると、そのワークスペースに切り替わります。
-
次に、このワークスペースで Postman コレクションを実行するように、いくつかの設定を調整します。 Postman のヘッダーで、歯車アイコンをクリックし、「設定 を選択して、設定モーダルを開きます。 キーボードショートカット(CMD/CTRL +)を使用してモーダルを開くこともできます。
-
「
General
」タブで、リクエストタイムアウトをミリ秒単位で更新して、5000 ms
を有効にしallow reading file outside this directory
す。
メモ
作業ディレクトリ内からファイルを読み込むと、同じファイルが他のデバイスに保存されている場合、デバイス間でスムーズに実行されます。 ただし、作業ディレクトリの外部からファイルを実行する場合は、同じ意図を示す設定をオンにする必要があります。FILE_PATH
が Postman の作業ディレクトリパスと同じでない場合は、このオプションを有効にしてください。 -
設定 パネルを閉じます。
-
環境 を選択してから、「読み込み」を選択します。
-
ダウンロードした json 環境ファイル
DataInExperiencePlatform.postman_environment
を読み込みます。 -
Postmanで、右上のドロップダウンで環境を選択し、目のアイコンをクリックして、環境変数を表示します。
-
次の環境変数が入力されていることを確認します。 環境変数の値の取得方法について詳しくは、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
)を含めてください
-
更新した環境 保存
Postman コレクションのインポート
次に、コレクションをPostmanにインポートする必要があります。
-
コレクション を選択してから、読み込みオプションを選択します。
-
次のコレクションを読み込みます。
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はこの秘密鍵を保存しませんが、実稼働キーは誰とも共有しないでください。
-
0-Authentication
コレクションを開き、OAuth: Request Access Token
リクエストを選択し、「SEND
」をクリックして認証し、アクセストークンを取得します。 -
環境変数を確認し、
ACCESS_TOKEN
が入力されていることを確認します。
データのインポート
これで、データを準備して Platform サンドボックスに読み込むことができます。 読み込んだPostman コレクションで重作業がすべて行われます。
-
1-Luma-Loyalty-Data
コレクションを開き、「概要」タブで 実行 をクリックして、コレクションランナーを起動します。 -
コレクションランナーウィンドウで、必ずドロップダウンから環境を選択し、「遅延」を
4000ms
に更新して、「応答を保存」オプションをオンにし、実行順序が正しいことを確認します。 Luma ロイヤルティデータを実行 ボタンをクリックしますメモ
1-Luma-Loyalty-Data 顧客のロイヤルティデータのスキーマを作成します。 このスキーマは、XDM Individual Profile クラス、標準フィールドグループ、カスタムフィールドグループおよびデータタイプに基づいています。 コレクションは、スキーマを使用してデータセットを作成し、サンプルの顧客ロイヤルティデータをAdobe Experience Platformにアップロードします。メモ
Postman Collection Runner の実行中にコレクションリクエストが失敗した場合は、実行を停止し、コレクションリクエストを 1 つずつ実行します。 -
問題がなければ、
Luma-Loyalty-Data
コレクション内のすべてのリクエストが合格します。 -
次に、Adobe Experience Platform インターフェイスにログインしデータセットに移動します。
-
Luma Loyalty Dataset
データセットを開き、データセットアクティビティ ウィンドウで、1,000 件のレコードを取り込んだ正常なバッチ実行を表示できます。 「データセットをプレビュー」オプションをクリックして、取り込んだレコードを確認することもできます。 1,000 個の 新しいプロファイルフラグメント が作成されたことを確認するには、数分待つ必要がある場合があります。
-
手順 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 インターフェイス:
- プロファイル/参照 に移動します。
Luma Loyalty Id
ID 名前空間 として を選択します5625458
ID 値 として を検索しますDaniel Wright
プロファイルを開きます。
「属性」タブと イベント タブでデータを参照すると、プロファイルに様々なデータファイルのデータが含まれていることがわかります。
次の手順
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 サイトにログインし、このチュートリアルでアップロードされたデータとプロファイルフラグメントの結合を確認します。