Adobe Experience Platformへのサンプルデータの読み込み
サンプルデータを使用して Experience Platform サンドボックス環境をセットアップする方法を説明します。Postman Collection を使用すると、フィールドグループ、スキーマ、データセットを作成して、Experience Platform にサンプルデータをインポートできます。
サンプルデータのユースケース
Experience Platformのビジネスユーザーは、多くの場合、フィールドグループの特定、スキーマの作成、データの準備、データセットの作成、データの取り込みなど、一連の手順を経て、Experience Platformが提供するマーケティング機能を調べる必要があります。 このチュートリアルでは、手順の一部を自動化して、できるだけ早くデータを Platform サンドボックスに取り込めるようにします。
このチュートリアルでは、Luma と呼ばれる架空の小売ブランドに焦点を当てます。 Adobe Experience Platformに投資して、ロイヤルティ、CRM、商品カタログ、オフラインの購入データをリアルタイムの顧客プロファイルに結合し、これらのプロファイルをアクティブ化してマーケティングを次のレベルに引き上げます。 Luma のサンプルデータを生成しました。このチュートリアルの残りの部分では、このデータをExperience Platform サンドボックス環境の 1 つに読み込みます。
前提条件
- Experience Platform API にアクセスし、認証方法を理解している。 そうでない場合は、この チュートリアル を確認してください。
- Experience Platform開発用サンドボックスにアクセスできます。
- Experience Platform テナント ID を把握している。 認証済みの API リクエスト を行うことで取得できます
または、Platform アカウントにログインする際に URL から抽出します。 例えば、次の URL では、テナントは「techmarketingdemos」https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/homeです。
使用 Postman postman
環境変数の設定
手順に従う前に、Postman アプリケーションをダウンロードしたことを確認します。 それでは、始めましょう。
-
このチュートリアルに必要なすべてのファイルを含んだ platform-utils-main.zip ファイルをダウンロードします。
note note NOTE 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_PATHPostman 環境変数を設定する際に必要になります。note note NOTE Macのファイルパスを取得するには、 platform-utils-mainフォルダーに移動し、そのフォルダーを右クリックして 情報を取得 オプションを選択します。
note note NOTE Windows でファイル パスを取得するには、目的のフォルダの場所をクリックして開き、アドレス バーのパスの右側を右クリックします。 アドレスをコピーしてファイルパスを取得します。
-
Postman を開き、ワークスペース ドロップダウンメニューからワークスペースを作成します。
-
ワークスペースの 名前 とオプションの 概要 を入力し、「Workspaceを作成」をクリックします。 新 Postman いワークスペースを作成すると、そのワークスペースに切り替わります。
-
次に、このワークスペースで Postman コレクションを実行するように、いくつかの設定を調整します。 Postman のヘッダーで、歯車アイコンをクリックし、「設定 を選択して、設定モーダルを開きます。 キーボードショートカット(CMD/CTRL +)を使用してモーダルを開くこともできます。
-
「
General」タブで、リクエストタイムアウトをミリ秒単位で更新して、5000 msを有効にしallow reading file outside this directoryす。
note note NOTE 作業ディレクトリ内からファイルを読み込むと、同じファイルが他のデバイスに保存されている場合、デバイス間でスムーズに実行されます。 ただし、作業ディレクトリの外部からファイルを実行する場合は、同じ意図を示す設定をオンにする必要があります。 FILE_PATHが Postman の作業ディレクトリパスと同じでない場合は、このオプションを有効にしてください。 -
設定 パネルを閉じます。
-
環境 を選択してから、「読み込み」を選択します。
-
ダウンロードした json 環境ファイル
DataInExperiencePlatform.postman_environmentを読み込みます。 -
Postmanで、右上のドロップダウンで環境を選択し、目のアイコンをクリックして、環境変数を表示します。
-
次の環境変数が入力されていることを確認します。 環境変数の値の取得方法について詳しくは、Experience Platform API への認証 チュートリアルを参照してください。
CLIENT_SECRETAPI_KEY—Adobe Developer ConsoleのClient IDSCOPESTECHNICAL_ACCOUNT_IDIMSIMS_ORG—Adobe Developer ConsoleのOrganization IDSANDBOX_NAMETENANT_ID– 必ずアンダースコアを付けてください(例:_techmarketingdemos)。CONTAINER_IDplatform_end_pointFILE_PATH-platform-utils-main.zipファイルを解凍したローカルフォルダーパスを使用します。 フォルダー名(例:/Users/dwright/Desktop/platform-utils-main)を含めてください
-
更新した環境 保存
Postman コレクションのインポート
次に、コレクションをPostmanにインポートする必要があります。
-
コレクション を選択してから、読み込みオプションを選択します。
-
次のコレクションを読み込みます。
0-Authentication.postman_collection.json1-Luma-Loyalty-Data.postman_collection.json2-Luma-CRM-Data.postman_collection.json3-Luma-Product-Catalog.postman_collection.json4-Luma-Offline-Purchase-Events.postman_collection.json5-Luma-Product-Inventory-Events.postman_collection.json6-Luma-Test-Profiles.postman_collection.json7-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 ロイヤルティデータを実行 ボタンをクリックします
note note NOTE 1-Luma-Loyalty-Data 顧客のロイヤルティデータのスキーマを作成します。 このスキーマは、XDM Individual Profile クラス、標準フィールドグループ、カスタムフィールドグループおよびデータタイプに基づいています。 コレクションは、スキーマを使用してデータセットを作成し、サンプルの顧客ロイヤルティデータをAdobe Experience Platformにアップロードします。 note note NOTE 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 IdID 名前空間 として を選択します5625458ID 値 として を検索します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 サイトにログインし、このチュートリアルでアップロードされたデータとプロファイルフラグメントの結合を確認します。
サンドボックス環境のリセット reset-sandbox
実稼動以外のサンドボックスをリセットすると、サンドボックスの名前と関連付けられた権限は保持されたまま、そのサンドボックスに関連付けられているすべてのスキーマ(リソース、データセットなど)が削除されます。この「クリーンな」サンドボックスは、引き続き、アクセス権を持つユーザーと同じ名前で使用できます。
サンドボックス環境をリセットするには、 こちら の手順に従います。