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

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

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

はじめに getting-started

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

前提条件 prerequisites

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

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

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

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

ChatlioのExperience Platform スキーマを作成 create-platform-schema

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

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

Chatlio アカウントを接続 connect-account

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

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

Marketing automation カテゴリに移動して、Chatlio ソースカードを確認します。 開始するには、Add data​を選択します。

データの選択 select-data

Select data ステップが表示され、Experience Platformに取り込むデータを選択するためのインターフェイスが提供されます。

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

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

終了したら「Next」を選択します。

データフローの詳細 dataflow-detail

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

終了したら「Next」を選択します。

マッピング mapping

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

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

以下に示すマッピングは必須であり、Review ステージに進む前に設定する必要があります。

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

レビュー review

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

データフローをレビューしたら、Finish​を選択し、データフローの作成に時間を割いてください。

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

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

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

Dataflow ID​と​ Streaming endpoint ​を取得するには、作成したばかりのデータフローのDataflow activity ページに移動し、Properties パネルの下部から詳細をコピーします。

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

ChatlioでWebhookを設定 set-up-webhook

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

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

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

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

次の手順 next-steps

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

その他のリソース additional-resources

以下の節では、Chatlio ソースを使用する際に参照できる追加のリソースについて説明します。

検証 validation

ソースを正しく設定し、Chatlio個のメッセージを取り込んでいることを検証するには、次の手順に従います。

チャット履歴を表示する

取り込まれたイベントを示す

Chatlioの詳細については、Chatlio ドキュメント ​およびFAQを参照してください。