UI を使用したExperience Platformへの Algolia User Profiles データの取り込み
このチュートリアルでは、ユーザーインターフェイスを使用して Algolia User Profiles アカウントからAdobe Experience Platformにデータを取り込む手順を説明します。
基本を学ぶ
重要このチュートリアルでは、次のExperience Platform コンポーネントに関する十分な知識があることを前提としています。
-
Experience Data Model (XDM) システム:Experience Platformがカスタマーエクスペリエンスデータの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本：主要な原則やベストプラクティスなど、スキーマ構成について学びます。
- スキーマエディターのチュートリアル：スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile：複数のソースから集計したデータに基づく、統合されたリアルタイム顧客プロファイル。
-
ソース：様々なソースからデータを取り込み、Experience Platform サービスを使用して、データの構造化、ラベル付け、拡張を行います。
必要な資格情報の収集
Algolia をAdobe Experience Platformに接続するには、次の資格情報を入力します。
| 資格情報 | 説明 |
|---|---|
| アプリケーション ID | Algolia アカウントに割り当てられた一意の ID。 |
| API キー | Algolia サービスへの API リクエストを認証および承認するための資格情報。 |
詳しくは、Algolia 認証ドキュメントを参照してください。
Algolia アカウントを接続
Experience Platform UI の左側のナビゲーションで「Sources」を選択し、「Sources」ワークスペースを開きます。 カテゴリ パネルまたは検索バーを使用して、目的のソースを見つけます。
Algolia に接続するには、「データと ID パートナー の下の Algolia ソースカードを選択し 「設定」を選択します。
ヒント
認証
既存のアカウントを使用
既存のアカウントを使用するには、「既存のアカウント」を選択し、使用する Algolia User Profiles アカウントを選択します。 次に 次へ を選択します。
新しいアカウントを作成
新しいアカウントを作成するには、「新しいアカウント」を選択し、名前、説明（オプション）、Algolia の資格情報を入力します。 ソースに接続 を選択し、接続が確立するのを待ちます。
データの追加
Algolia User Profiles アカウントが作成されると、データを追加 手順が表示されます。 これを使用して、取り込み用のユーザープロファイルデータを選択およびプレビューします。
- 左側で、オプションとして インデックス と アフィニティ を入力します。
- 右側で、最大 100 行のユーザープロファイルをプレビューします。
完了したら、「次へ」を選択します。
データフローの詳細を入力
既存のデータセットを使用する場合は、Algolia Profile フィールドグループを含むスキーマに関連付けられているデータセットを選択します。 Algolia User Token フィールドで Algolia User Token ID 名前空間が使用されていることを確認します。 Algolia User Token が現在作成または割り当てられていない場合は、以下の手順を参照してください。
新しいデータセットを作成する場合は、Algolia Profile フィールドグループを使用してスキーマを選択します。
ID 名前空間 Algolia User Token 作成
Algolia User Token ID 名前空間が組織内に存在しない場合は、作成する必要があります。
左側のナビゲーションを使用して「ID」を選択し、ID サービスUI ワークスペースにアクセスして「ID 名前空間を作成」を選択します。
次に、カスタム名前空間の 表示名 と ID 記号 を指定します。 この手順では、名前空間のタイプも設定する必要があります。 完了したら、「作成」をクリックします。
| カスタム名前空間設定 | 値 |
|---|---|
| 表示名 | Algolia User Token |
| ID シンボル | AlgoliaUserToken |
| タイプを選択 | Cookie ID |
追加すると、名前空間がリストに表示されます。 これで、スキーマに適用できます。
スキーマへの名前空間の適用
左側のナビゲーションを使用して「スキーマ」を選択し、 スキーマUI ワークスペースにアクセスします。 スキーマ ワークスペースを使用して、Algolia Profile Details フィールドグループでスキーマを作成または更新します。 次に、「ユーザートークン」フィールドに移動し、右側のパネルを使用して「ID」ボックスを選択します。 さらに、入力ボックスを使用して、Algolia User Token ID 名前空間を定義します。 完了したら「保存」を選択します。
ユーザートークン フィールドに Algolia User Token ID 名前空間を割り当てると、その ID は任意のプロファイルのユーザープロファイルに表示されます。
XDM スキーマへのデータフィールドのマッピング
マッピングインターフェイスを使用して、ソースデータをスキーマフィールドにマッピングします。 詳しくは、 マッピングガイドを参照してください。
取り込み実行のスケジュール
次に、スケジュールインターフェイスを使用して、データフローの取り込みスケジュールを定義します。
| スケジュール設定 | 説明 |
|---|---|
| 頻度 |
頻度を設定して、データフローの実行頻度を示します。 頻度は次のように設定できます。
|
| 間隔 |
頻度を選択したら、間隔設定を指定して、各取り込み間の時間枠を確立できます。 例えば、頻度を日に設定し、間隔を 15 に設定すると、データフローは 15 日ごとに実行されます。 間隔をゼロに設定することはできません。 各頻度で許容される最小のインターバル値は次のとおりです。
|
| 開始時間 | 見込み実行のタイムスタンプ（UTC タイムゾーンで表示）。 |
| バックフィル | バックフィルは、最初に取り込むデータを決定します。 バックフィルが有効になっている場合、指定されたパス内の現在のすべてのファイルが、最初にスケジュールされた取り込み時に取り込まれます。 バックフィルが無効になっている場合は、最初の取り込みの実行から開始時刻の間に読み込まれたファイルのみが取り込まれます。 開始時間より前に読み込まれたファイルは取り込まれません。 |
データフローのレビュー
取り込み前のデータフローの概要を確認するページを使用します。 詳細は、次のカテゴリにグループ化されます。
- 接続 - ソースのタイプ、選択したソースファイルの関連パスおよびそのソースファイル内の列数を表示します。
- データセットの割り当てとフィールドのマッピング - ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。
- スケジュール – 取り込みスケジュールのアクティブな期間、頻度、間隔を表示します。
データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。
