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

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

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

NOTE

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

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

はじめに getting-started

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

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

前提条件 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 用の Platform スキーマの作成 create-platform-schema

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

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

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

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

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

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

Chatlio カードを使用した Platform UI カタログ

データの選択 select-data

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

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

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

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

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

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

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

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

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

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

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

マッピング mapping

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

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

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

ターゲットフィールド

説明

UUID

イベントの Chatlio 識別子。

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

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

レビュー review

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

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

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

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

ストリーミングエンドポイント URL の取得 get-streaming-endpoint-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