ベータ版

UI での Chatlio ソース接続の作成

最終更新日： 2025年5月5日

トピック：

作成対象：

開発者

メモ

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

このチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用して Chatlio ソース接続を作成する手順について説明します。

はじめに

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

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

前提条件

次の節では、Chatlio ソース接続を作成する前に完了すべき前提条件について説明します。

Chatlio のソーススキーマを定義するサンプル JSON

Chatlio ソース接続を作成する前に、ソーススキーマを指定する必要があります。以下の JSON を使用できます。

{
  "visitor": {
    "email": "test@example.com",
    "UUID": "2d3f4260-2235-903b-0a82-a23d326cc257"
  },
   "message": "Hi",
  "channelId": "C04J7M7LCMQ",
  "slackChannelName": "aep",
  "slackChannelId": "C04JVR71WKS"
}

Chatlio 用のExperience Platform スキーマの作成

また、ソースに使用するExperience Platform スキーマを必ず作成する必要があります。スキーマの作成方法に関する包括的な手順については、Experience Platform スキーマの作成に関するチュートリアルを参照してください。

Chatlio のスキーマの例を示すExperience Platform UI

Chatlio アカウントを接続

Experience Platformの UI で、左側のナビゲーションから Sources を選択し、Sources ワークスペースにアクセスして、Experience Platformで使用可能なソースのカタログを表示します。

カテゴリ メニューを使用して、カテゴリ別にソースをフィルタリングします。または、検索バーにソース名を入力して、カタログから特定のソースを検索します。

マーケティング自動化カテゴリに移動して、Chatlio ソースカードを表示します。開始するには、「データを追加」を選択します。

Chatlio カード付きExperience Platform UI カタログ

データの選択

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

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

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

ソースワークフローのデータを追加ステップ

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

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

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

データフローの詳細

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

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

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

マッピング

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

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

以下にリストされているマッピングは必須であり、レビュー段階に進む前に設定する必要があります。

ターゲットフィールド

説明

UUID

イベントの Chatlio 識別子。

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

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

レビュー

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

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

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

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

ストリーミングエンドポイント URL の取得

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

で Webhook の設定に使用する URL を作成するには Chatlio 次を取得する必要があります。

データフロー ID
ストリーミングエンドポイント

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

データフローアクティビティのストリーミングエンドポイント。

ストリーミングエンドポイントとデータフロー ID を取得したら、パターン {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID} に基づいて URL を作成します。例えば、作成された Webhook URL は次のようになります。https://dcs.adobedc.net/collection/d56b47ee3985104beaf724efcd78a3e1a863d720471a482bebac0acc1ab95983

Chatlio での Webhook の設定

Webhook URL を作成したら、Chatlio ユーザーインターフェイスを使用して Webhook を設定できます。

Chatlio アカウントにログインし、セットアップとインストールに関するガイドに従ってウィジェットを作成します。

ウィジェットが作成されたら、ウィジェットの設定ページに移動して、そのウィジェットに Webhook URL を追加します。

Chatlio の Webhook 設定ページ

次に、「Behavior」タブを選択し、Webhook when a new conversation starts フィールドおよび購読する他の Webhook イベントフィールドに Webhook URL を追加します。

Webhook エンドポイントフィールドを表示する Chatlio UI。

TIP

Chatlio Webhook では、様々なイベントを購読できます。様々なイベントについて詳しくは、Chatlio イベントドキュメントを参照してください。

次の手順

このチュートリアルでは、Chatlio データをExperience Platformに取り込むためのストリーミングデータフローを正常に設定しました。取り込まれるデータを監視するには、Experience Platform UI を使用したストリーミングデータフローのモニタリングのガイドを参照してください。