ドキュメントExperience Platformソースコネクタガイド

[ベータ版]{class="badge informative"}

UI を使用して RainFocus アカウントをExperience Platformに接続する

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者
NOTE
RainFocus ソースはベータ版です。ベータラベル付きソースの使用について詳しくは、 ソースの概要を参照してください。

このチュートリアルでは、RainFocus アカウントを連携し、イベント管理と Analytics データをAdobe Experience Platformにストリーミングする方法について説明します。

IMPORTANT
このソースコネクタとドキュメントページは、RainFocus チームが作成および管理します。 お問い合わせや更新のリクエストについては、clientcare@rainfocus.comまで直接ご連絡いただくか、RainFocus ヘルプセンターをご覧ください。

はじめに

このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

前提条件

RainFocus アカウントをExperience Platformに接続する前に、まず次の前提条件のタスクを実行する必要があります。

前提条件の設定が完了したら、以下に示す手順に進むことができます。

RainFocus アカウントをExperience Platformに接続

Platform の UI で、左側のナビゲーションバーから Sources を選択し、Sources のワークスペースにアクセスします。 カタログ ​画面には、アカウントを作成できる様々なソースが表示されます。

画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。

Analytics カテゴリ内で、「RainFocus Experience」を選択し、次に「データを追加」を選択します。

RainFocus ソースが選択されたExperience PlatformUI のソースカタログ

データの選択

データを選択手順が表示され、Experience Platformに取り込むデータを選択するためのインターフェイスが表示されます。

  • インターフェイスの左側は、アカウント内で利用可能なデータストリームを表示できるブラウザーです。
  • インターフェイスの右側の部分では、JSON ファイルから最大 100 行のデータをプレビューできます。

ファイルをアップロード を選択して、ローカルシステムから JSON ファイルをアップロードします。 または、アップロードする JSON ファイルをファイルをドラッグ&ドロップ パネルにドラッグ&ドロップすることもできます。

RainFocus からダウンロードしたサンプル JSON ペイロードをアップロードします。

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

ファイルがアップロードされると、プレビューインターフェイスが更新され、アップロードしたスキーマのプレビューが表示されます。 プレビューインターフェイスを使用すると、ファイルの内容と構造を検査できます。 また、検索フィールドユーティリティを使用して、スキーマ内から特定の項目にアクセスすることもできます。

終了したら、「次へ」を選択します。

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

データフローの詳細

データフローの詳細 手順が表示され、既存のデータセットを使用するか、データフローの新しいデータセットを確立するかのオプションと、データフローの名前と説明を入力する機会が提供されます。 この手順では、プロファイルの取り込み、エラー診断、部分取り込み、アラートの設定も指定できます。

終了したら、「次へ」を選択します。

ソースワークフローのデータフローの詳細手順。

マッピング mapping

マッピング手順が表示され、ソーススキーマのソースフィールドを、ターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが提供されます。

Experience Platformは、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに対してインテリジェントなレコメンデーションを提供します。 マッピングルールは、ユースケースに合わせて手動で調整できます。 必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッパーインターフェイスと計算フィールドの使用に関する包括的な手順については、 データ準備 UI ガイドを参照してください。

ソースデータが正常にマッピングされたら、「次へ」を選択します。

ソースワークフローのマッピングステップ

レビュー

レビュー ​手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。

  • 接続：ソースのタイプ、選択したソースファイルの関連パスおよびそのソースファイル内の列の数を表示します。
  • データセットの割り当てとフィールドのマッピング：ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。

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

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

ストリーミングエンドポイント URL の取得 get-your-streaming-endpoint-url

ストリーミングデータフローを作成したので、ストリーミングエンドポイント URL を取得できるようになりました。 このエンドポイントは、Webhook をサブスクライブするために使用され、ストリーミングソースがExperience Platformと通信できるようになります。

ストリーミングエンドポイントを取得するには、作成したデータフローの データフローアクティビティ ページに移動し、プロパティ パネルの下部からエンドポイントをコピーします。

ストリーミングエンドポイント URL がハイライト表示されたソースワークスペースのデータフローアクティビティページ

RainFocus での統合プロファイルのアクティブ化

データフローが完了し、ストリーミングエンドポイント URL を取得したら、RainFocus で Integration Profile をアクティブ化できます。

  • RainFocus platform にログインします。 プライマリナビゲーションで、「Libraries」と「Integration Profiles」を選択します。
  • 前提条件の一部として、前の手順で作成した Integration Profile を開きます。
  • Experience Platformのデータフローからコピーした データフロー ID と ストリーミングエンドポイント を貼り付けて、「保存」を選択します。

次の手順

このチュートリアルでは、RainFocus ソースの接続を確立し、イベント管理と分析データをExperience Platformにストリーミングできるようにします。

その他のリソース

次のドキュメントでは、RainFocus ソースに関するニュアンスについて詳しく説明します。

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089