UIを使用してAlgolia User Profiles データをExperience Platformに取り込む

最終更新日： 2025年10月14日

トピック：
Sources

作成対象：

Developer

このチュートリアルでは、ユーザーインターフェイスを使用して、Algolia User Profiles アカウントからAdobe Experience Platformにデータを取り込む方法について説明します。

基本を学ぶ

IMPORTANT

開始する前に、Algolia User Profiles 概要に記載されている前提条件を完了していることを確認してください。

このチュートリアルでは、次のExperience Platform コンポーネントに慣れていることを前提としています。

Experience Data Model (XDM) System：顧客体験データの整理にExperience Platformが使用する標準化されたフレームワーク。
- スキーマ構成の基本：主要な原則やベストプラクティスなど、スキーマ構成について説明します。
- スキーマエディターのチュートリアル：スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
Real-Time Customer Profile：複数のソースから集約されたデータに基づく、統合されたリアルタイムの顧客プロファイル。
ソース：様々なソースからデータを取り込み、Experience Platform サービスを使用してデータを構造化、ラベル付け、強化します。

必要な資格情報の収集

AlgoliaをAdobe Experience Platformに接続するには、次の資格情報を指定します。

資格情報

説明

アプリケーション ID

Algolia アカウントに割り当てられた一意のID。

API キー

Algoliaのサービスに対するAPI リクエストを認証および承認するための資格情報。

詳しくは、Algolia 認証ドキュメントを参照してください。

Algolia アカウントを接続

Experience Platform UIで、左側のナビゲーションから「ソース」を選択して、ソース ワークスペースを開きます。 カテゴリー パネルまたは検索バーを使用して、目的のソースを検索します。

Algoliaを接続するには、データとID パートナーの下にある Algolia のソースカードを選択し、セットアップを選択します。

TIP

ソースにまだ認証済みアカウントがない場合は、設定オプションが表示されます。認証されると、この操作は データを追加 に変更されます。

Algolia ユーザープロファイルソースを選択したソースカタログ。

認証

既存のアカウントの使用

既存のアカウントを使用するには、既存のアカウントを選択し、使用するAlgolia User Profiles アカウントを選択します。次に、次へを選択します。

既存のアカウントインターフェイス。

新しいアカウントを作成

新しいアカウントを作成するには、新しいアカウントを選択し、名前、オプションの説明、およびAlgolia資格情報を入力します。「ソースに接続」を選択し、接続が確立されるのを待ちます。

新しいアカウントインターフェイス。

データの追加

Algolia User Profiles アカウントを作成すると、「データを追加」ステップが表示されます。このツールを使用して、取り込むユーザープロファイルデータを選択およびプレビューします。

左側に、オプションの インデックス と 親和性 を入力します。
右側では、最大100行のユーザープロファイルをプレビューできます。

完了したら、次へを選択します。

ワークフローのデータ選択ステップ。

データフローの詳細を入力

既存のデータセットを使用する場合は、Algolia Profile フィールドグループを含むスキーマに関連付けられているデータセットを選択します。 Algolia User Token フィールドがAlgolia User Token ID名前空間を使用していることを確認してください。 Algolia User Tokenが現在作成または割り当てられていない場合は、次の手順を実行します。

既存のデータセット手順

新しいデータセットを作成する場合は、Algolia Profile フィールドグループを使用してスキーマを選択します。

新しいデータセット手順

Algolia User Token ID名前空間を作成

組織にAlgolia User Token ID名前空間がまだ存在しない場合は、作成する必要があります。

左側のナビゲーションを使用し、IDを選択してID サービス UI ワークスペースにアクセスし、ID名前空間の作成を選択します。

次に、カスタム名前空間に 表示名 と ID シンボル を指定します。この手順では、名前空間のタイプも設定する必要があります。完了したら、作成を選択します。

ID名前空間画面を作成します。

カスタム名前空間設定

値

表示名

Algolia User Token

ID シンボル

AlgoliaUserToken

種類を選択

Cookie ID

追加すると、名前空間がリストに表示されます。スキーマに適用できるようになりました。

Algolia ID名前空間が正常に作成されました。

スキーマへの名前空間の適用

左側のナビゲーションを使用し、スキーマを選択して、スキーマ UI ワークスペースにアクセスします。スキーマワークスペースを使用して、Algolia Profile Details フィールドグループを持つスキーマを作成または更新します。次に、ユーザートークン フィールドに移動し、右側のパネルを使用してID ボックスを選択します。さらに、入力ボックスを使用して、Algolia User Token ID名前空間を定義します。完了したら、保存を選択します。

フィールドにIDを設定します。

ユーザートークン フィールドにAlgolia User Token ID名前空間を割り当てると、IDは任意のプロファイルのユーザープロファイルに表示されます。

ユーザープロファイルインターフェイス。

XDM スキーマへのデータフィールドのマッピング

マッピングインターフェイスを使用して、ソースデータをスキーマフィールドにマッピングします。詳しくは、マッピングガイドを参照してください。

マッピング手順

取り込み実行のスケジュール

次に、スケジューリングインターフェイスを使用して、データフローの取り込みスケジュールを定義します。

ソースワークフローのスケジュール設定ステップ。

スケジュール設定

説明

頻度

データフローを実行する頻度を指定する頻度を設定します。頻度は次のように設定できます。

1回:1回限りの取り込みを作成するには、頻度をonceに設定します。 1回限りの取り込みデータフローを作成する場合、間隔とバックフィルの設定は使用できません。デフォルトでは、スケジュール頻度は1回に設定されます。
分:1分ごとにデータフローを取り込むようにスケジュールする頻度をminuteに設定します。
時間:1時間ごとにデータを取り込むようにデータフローをスケジュールする頻度をhourに設定します。
日: 1日ごとにデータフローを取り込むようにスケジュールする頻度をdayに設定します。
週：週ごとにデータフローを取り込むようにスケジュールする頻度をweekに設定します。

間隔

頻度を選択したら、インターバル設定を設定して、取り込みごとに時間枠を設定できます。例えば、頻度を1日に設定し、間隔を15に設定した場合、データフローは15日ごとに実行されます。間隔を0に設定することはできません。各周波数に対して許容される最小区間値は次のとおりです。

1回：なし
分: 15
時間: 1
日: 1
週: 1

開始時間

予測された実行のタイムスタンプ。UTC タイムゾーンで表示されます。

バックフィル

バックフィルによって、最初に取り込むデータが決まります。バックフィルが有効になっている場合、指定したパス内のすべての現在のファイルが、最初のスケジュールされた取り込み中に取り込まれます。バックフィルが無効になっている場合、取り込みの最初の実行時から開始時までの間に読み込まれたファイルのみが取り込まれます。開始時刻より前に読み込まれたファイルは取り込まれません。

データフローのレビュー

取り込み前のデータフローの概要については、レビューページを使用してください。詳細は、次のカテゴリにグループ化されます。

接続 - ソースタイプ、選択したソースファイルの関連パス、そのソースファイル内の列数を表示します。
データセットとマップフィールドの割り当て - ソースデータが取り込まれるデータセットを表示します。これには、データセットが準拠しているスキーマも含まれます。
スケジュール – 取り込みスケジュールのアクティブな期間、頻度、間隔を表示します。

データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。

ソースワークフローのレビュー手順。