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に接続するには、次の資格情報を入力します。
詳しくは、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 記号 を指定します。 この手順では、名前空間のタイプも設定する必要があります。 完了したら、「作成」をクリックします。
追加すると、名前空間がリストに表示されます。 これで、スキーマに適用できます。
スキーマへの名前空間の適用
左側のナビゲーションを使用して「スキーマ」を選択し、 スキーマ UI ワークスペースにアクセスします。 スキーマ ワークスペースを使用して、Algolia Profile Details フィールドグループでスキーマを作成または更新します。 次に、「ユーザートークン」フィールドに移動し、右側のパネルを使用して「ID」ボックスを選択します。 さらに、入力ボックスを使用して、Algolia User Token ID 名前空間を定義します。 完了したら「保存」を選択します。
ユーザートークン フィールドに Algolia User Token ID 名前空間を割り当てると、その ID は任意のプロファイルのユーザープロファイルに表示されます。
XDM スキーマへのデータフィールドのマッピング
マッピングインターフェイスを使用して、ソースデータをスキーマフィールドにマッピングします。 詳しくは、 マッピングガイド を参照してください。
取り込み実行のスケジュール
次に、スケジュールインターフェイスを使用して、データフローの取り込みスケジュールを定義します。
頻度を設定して、データフローの実行頻度を示します。 頻度は次のように設定できます。
- 1 回：頻度を
onceに設定して、1 回限りの取り込みを作成します。 1 回限りの取り込みデータフローを作成する場合、間隔とバックフィルの設定は使用できません。 デフォルトでは、スケジュールの頻度は 1 回に設定されています。 - 分：頻度を
minuteに設定して、1 分ごとにデータを取り込むようにデータフローをスケジュールします。 - 時間：頻度を
hourに設定して、1 時間ごとにデータを取り込むようにデータフローをスケジュールします。 - 日：頻度を
dayに設定して、1 日にデータを取り込むようにデータフローをスケジュールします。 - 週：頻度を
weekに設定して、データフローが週ごとにデータを取り込むようにスケジュールします。
頻度を選択したら、間隔設定を指定して、各取り込み間の時間枠を確立できます。 例えば、頻度を日に設定し、間隔を 15 に設定すると、データフローは 15 日ごとに実行されます。 間隔をゼロに設定することはできません。 各頻度で許容される最小のインターバル値は次のとおりです。
- 1 回：なし
- 分: 15
- 時間: 1
- 日: 1
- 週: 1
データフローのレビュー
取り込み前のデータフローの概要を確認するページを使用します。 詳細は、次のカテゴリにグループ化されます。
- 接続 - ソースのタイプ、選択したソースファイルの関連パスおよびそのソースファイル内の列数を表示します。
- データセットの割り当てとフィールドのマッピング - ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。
- スケジュール – 取り込みスケジュールのアクティブな期間、頻度、間隔を表示します。
データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。
次の手順
このチュートリアルでは、Algolia ソースからExperience Platformにインテントデータを取り込むデータフローを正常に作成しました。 その他のリソースについては、以下に概要を説明するドキュメントを参照してください。
データフローの監視
データフローを作成したら、そのデータフローを通じて取り込まれるデータを監視し、取り込み率、成功、エラーに関する情報を表示できます。 データフローのモニタリング方法について詳しくは、UI でのアカウントとデータフローのモニタリング のチュートリアルを参照してください。
データフローの更新
データフローのスケジュール、マッピング、一般情報の設定を更新するには、UI でのソースデータフローの更新 に関するチュートリアルを参照してください。
データフローの削除
不要になったデータフローや誤って作成されたデータフローは、データフローワークスペース内にある 削除 機能で削除できます。データフローの削除方法について詳しくは、UI でのデータフローの削除 のチュートリアルを参照してください。