サンプルデータをAdobe Experience Platformにインポート
サンプルデータを使用して Experience Platform サンドボックス環境をセットアップする方法を説明します。Postman Collection を使用すると、フィールドグループ、スキーマ、データセットを作成して、Experience Platform にサンプルデータをインポートできます。
データの使用例
Experience Platformのビジネスユーザーは、多くの場合、Experience Platformが提供するマーケティング機能を調査する前に、フィールドグループの識別、スキーマの作成、データの準備、データセットの取り込みなど、一連の手順を実行する必要があります。 このチュートリアルでは、データを可能な限り迅速に Platform サンドボックスに取り込めるように、いくつかの手順を自動化します。
このチュートリアルでは、Luma という架空の小売ブランドに焦点を当てています。 Adobe Experience Platformに投資して、ロイヤリティ、CRM、製品カタログ、オフライン購入データをリアルタイムの顧客プロファイルに組み合わせ、これらのプロファイルをアクティブ化して、マーケティングを次のレベルに引き上げます。 Luma のサンプルデータを生成しました。このチュートリアルの残りの部分で、このデータをExperience Platformサンドボックス環境の 1 つに読み込みます。
前提条件
- Experience PlatformAPI にアクセスでき、認証方法がわかっている。 そうでない場合は、確認します チュートリアル.
- 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
ファイルをコンピューター上の目的の場所に移動し、解凍します。 -
Adobe Analytics の
luma-data
フォルダーを開き、すべてのjson
ファイルを編集し、_yourTenantId
前にアンダースコアが付いた独自のテナント id が付きます。 -
開く
luma-offline-purchases.json
,luma-inventory-events.json
、およびluma-web-events.json
テキストエディターで、過去 1 か月のイベントが発生するようにすべてのタイムスタンプを更新します ( 例えば、「"timestamp":"2022-11
とを置き換えます )。 -
解凍されたフォルダーの場所をメモしておきます。この場所は、後で
FILE_PATH
Postman 環境変数:note note NOTE Macでファイルパスを取得するには、 platform-utils-main
フォルダーを右クリックし、「 」を選択します。 情報を取得 オプション。note note NOTE ウィンドウでファイルパスを取得するには、目的のフォルダの場所をクリックして開き、アドレスバーでパスの右側を右クリックします。 アドレスをコピーして、ファイルパスを取得します。 -
開く Postman をクリックし、 Workspaces ドロップダウンメニュー:
-
を入力します。 名前 およびオプション 概要 (ワークスペースの場合)、 ワークスペースを作成. 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 PlatformAPI に対する認証 手順を説明するチュートリアルです。
CLIENT_SECRET
API_KEY
—Client ID
Adobe Developer Console でSCOPES
TECHNICAL_ACCOUNT_ID
IMS
IMS_ORG
—Organization ID
Adobe Developer Console で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 ロイヤリティデータの実行 ボタンnote note NOTE 1-Luma-Loyalty-Data は顧客の忠誠度データのスキーマを作成します。 スキーマは、XDM Individual Profile クラス、標準フィールドグループ、カスタムフィールドグループおよびデータタイプに基づいています。 このコレクションは、スキーマを使用してデータセットを作成し、顧客の忠誠度のサンプルデータをAdobe Experience Platformにアップロードします。 note note NOTE Postmanコレクションランナーでコレクションリクエストが失敗した場合は、実行を停止し、コレクションリクエストを 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 Individual Profile クラスに基づいています。3-Luma-Product-Catalog.postman_collection.json
は、製品カタログ情報のスキーマを作成し、入力されたデータセットを作成します。 このスキーマは、カスタムの製品カタログクラスに基づき、カスタムの製品カタログフィールドグループを使用します。4-Luma-Offline-Purchase-Events.postman_collection.json
は、顧客のオフライン購入イベントデータのスキーマを作成し、入力されたデータセットを作成します。 スキーマは、XDM ExperienceEvent クラスに基づいており、カスタムの ID およびコマースの詳細フィールドグループで構成されます。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 Analytics の Adobe Experience Platformインターフェイス:
- に移動します。 プロファイル > 参照
- 選択
Luma Loyalty Id
として ID 名前空間 - を検索
5625458
として ID 値 - を開きます。
Daniel Wright
profile
データを参照して 属性 および イベント 「 」タブに移動すると、プロファイルに様々なデータファイルのデータが含まれていることがわかります。
次の手順
Adobe Journey Optimizerについて学習したい場合、このサンドボックスには、 Journey Optimizerの課題
結合ポリシー、データガバナンス、クエリサービス、セグメントビルダーについて学習する場合は、次のリンクをクリックしてください: 「データアーキテクトおよびデータエンジニア向けスタートガイド」チュートリアルのレッスン 11. この他のチュートリアルの前のレッスンでは、Postmanコレクションによって生成されたものすべてを手動で作成し、優れたスタートをお楽しみください。
このサンドボックスにリンクするサンプルの Web SDK 実装を作成する場合は、
Web SDK を使用したAdobe Experience Cloudの実装のチュートリアル. Web SDK チュートリアルの「初期設定」、「タグ設定」、「Experience Platformの設定」の各レッスンを設定したら、 luma-crm.json
パスワードを使用したファイル test
を使用して、プロファイルフラグメントを、このチュートリアルでアップロードしたデータと結合して表示できます。
このサンドボックスにリンクする Mobile SDK 実装のサンプルを作成する場合は、
モバイルアプリでのAdobe Experience Cloudの実装のチュートリアル. Web SDK チュートリアルの「初期設定」、「アプリケーションの実装」、「Experience Platform」のレッスンを設定したら、 luma-crm.json
ファイルを参照して、このチュートリアルでアップロードしたデータとのプロファイルフラグメントの結合を確認します。
サンドボックス環境をリセット reset-sandbox
実稼動以外のサンドボックスをリセットすると、サンドボックスの名前と関連付けられた権限は保持されたまま、そのサンドボックスに関連付けられているすべてのスキーマ(リソース、データセットなど)が削除されます。この「クリーンな」サンドボックスは、引き続き、アクセス権を持つユーザーと同じ名前で使用できます。
手順に従います。 ここ :サンドボックス環境をリセットする場合に使用します。