ベータ版
UI での Customer.io ソース接続とデータフローの作成
作成対象:
- 開発者
このチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用して Customer.io ソース接続とデータフローを作成する手順について説明します。
はじめに
このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム:Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本:スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル:スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
前提条件
次の節では、Customer.io ソース接続を作成する前に完了すべき前提条件について説明します。
Customer.io のソーススキーマを定義するサンプル JSON
Customer.io ソース接続を作成する前に、ソーススキーマを指定する必要があります。 以下の JSON を使用できます。
{
"event_id": "01E4C4CT6YDC7Y5M7FE1GWWPQJ",
"object_type": "customer",
"metric": "subscribed",
"timestamp": 1613063089,
"data": {
"customer_id": "42",
"email_address": "test@example.com",
"identifiers": {
"id": "42",
"email": "test@example.com",
"cio_id": "d9c106000001"
}
}
}
Customer.io 用のExperience Platform スキーマの作成
また、ソースに使用するExperience Platform スキーマを必ず作成する必要があります。 スキーマの作成方法に関する包括的な手順については、Experience Platform スキーマの作成に関するチュートリアルを参照してください。
Customer.io アカウントを接続
Experience Platformの UI で、左側のナビゲーションから Sources を選択し、Sources ワークスペースにアクセスして、Experience Platformで使用可能なソースのカタログを表示します。
カテゴリ メニューを使用して、カテゴリ別にソースをフィルタリングします。 または、検索バーにソース名を入力して、カタログから特定のソースを検索します。
マーケティング自動化 カテゴリに移動して、Customer.io ソースカードを表示します。 開始するには、「データを追加」を選択します。
データの選択
データを選択 手順が表示され、Experience Platformに取り込むデータを選択するためのインターフェイスが表示されます。
- インターフェイスの左側は、アカウント内で利用可能なデータストリームを表示できるブラウザーです。
- インターフェイスの右側の部分では、JSON ファイルから最大 100 行のデータをプレビューできます。
ファイルをアップロード を選択して、ローカルシステムから JSON ファイルをアップロードします。 または、アップロードする JSON ファイルを ファイルをドラッグ&ドロップ パネルにドラッグ&ドロップすることもできます。
ファイルがアップロードされると、プレビューインターフェイスが更新され、アップロードしたスキーマのプレビューが表示されます。 プレビューインターフェイスを使用すると、ファイルの内容と構造を検査できます。 また、 フィールドを検索 ユーティリティを使用して、スキーマ内から特定の項目にアクセスすることもできます。
終了したら、「次へ」を選択します。
データフローの詳細
データフローの詳細 手順が表示され、既存のデータセットを使用するか、データフローの新しいデータセットを確立するかのオプションと、データフローの名前と説明を入力する機会が提供されます。 この手順では、プロファイルの取り込み、エラー診断、部分取り込み、アラートの設定も指定できます。
終了したら、「次へ」を選択します。
マッピング
マッピング手順が表示され、ソーススキーマのソースフィールドを、ターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが提供されます。
Experience Platformは、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに対してインテリジェントなレコメンデーションを提供します。 マッピングルールは、ユースケースに合わせて手動で調整できます。 必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッパーインターフェイスと計算フィールドの使用に関する包括的な手順については、 データ準備 UI ガイドを参照してください。
以下にリストされているすべてのマッピングは必須であり、「レビュー 段階に進む前に設定する必要があ ます。
test mode
で Webhook を実行する際は、cio_id
から送信され Customer.io 関連するフィールドがないので、Customer.io をマッピングしないでください。ソースデータが正常にマッピングされたら、「次へ」を選択します。
レビュー
レビュー 手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。
- 接続:ソースのタイプ、選択したソースファイルの関連パスおよびそのソースファイル内の列の数を表示します。
- データセットの割り当てとフィールドのマッピング:ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。
データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。
ストリーミングエンドポイント URL の取得
ストリーミングデータフローを作成したので、ストリーミングエンドポイント URL を取得できるようになりました。 このエンドポイントは、Webhook をサブスクライブするために使用され、ストリーミングソースがExperience Platformと通信できるようになります。
で Webhook の設定に使用する URL を作成するには Customer.io 次を取得する必要があります。
- データフロー ID
- ストリーミングエンドポイント
データフロー ID および ストリーミングエンドポイント を取得するには、作成したばかりのデータフローの データフローアクティビティ ページに移動し、 プロパティ パネルの下部から詳細をコピーします。
ストリーミングエンドポイントとデータフロー ID を取得したら、パターン {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}
に基づいて URL を作成します。 例えば、作成された Webhook URL は次のようになります。https://dcs.adobedc.net/collection/febc116d22ba0ea2868e9c93b199375302afb8a589617700991bb8f3f0341ad7?x-adobe-flow-id=439b3fc4-3042-4a3a-b5e0-a494898d3fb0
Customer.io でのレポート Webhook の設定
Webhook URL を作成したので、Customer.io ユーザーインターフェイスを使用してレポート Webhook を設定できるようになりました。 レポート Webhook の設定手順については、Webhook の設定に関する Customer.io ガイドを参照してください。
Customer.io ユーザーインターフェイスの WEBHOOK ENDPOINT フィールドに webhook URL を入力します。
次の手順
このチュートリアルでは、Customer.io データをExperience Platformに取り込むためのストリーミングデータフローを正常に設定しました。 取り込まれるデータを監視するには、Experience Platform UI を使用したストリーミングデータフローのモニタリングのガイドを参照してください。
その他のリソース
以下の節では、Customer.io ソースを使用する際に参照できるその他のリソースを示します。
ガードレール
ガードレールについて詳しくは、Customer.io タイムアウトとエラーのページを参照してください。
検証
ソースを正しく設定したことと、メッセージが取り込まれてい Customer.io ことを検証するには、次の手順に従います。
- Customer.io アクティビティログ ページをチェックすると、Customer.io によって取り込まれるイベントを特定できます。
- Experience Platform UI で、ソースカタログの Customer.io ーザーカードメニューの横にある データフローを表示 を選択します。 次に、「データセットをプレビュー」をクリックして、Customer.io で選択したイベントに対して取り込まれたデータを検証します。