[ベータ版]{class="badge informative"}
の作成 Customer.io UI でのソース接続とデータフロー
このチュートリアルでは、 Customer.io Adobe Experience Platformユーザーインターフェイスを使用したソース接続とデータフロー。
はじめに getting-started
このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム:Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本:スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル:スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
前提条件 prerequisites
次の節では、 Customer.io ソース接続。
のソーススキーマを定義するサンプル JSON Customer.io prerequisites-json-schema
を作成する前に 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"
}
}
}
用の Platform スキーマの作成 Customer.io create-platform-schema
また、ソースに使用する Platform スキーマを作成する必要があります。 に関するチュートリアルを参照してください。 Platform スキーマの作成 スキーマの作成方法に関する包括的な手順を参照してください。
Customer.io アカウントを接続 connect-account
Platform UI で、「 」を選択します。 ソース 左側のナビゲーションから、 ソース workspace を参照し、Experience Platformで使用可能なソースのカタログを確認します。
以下を使用します。 カテゴリ メニューを使用して、ソースをカテゴリでフィルタリングできます。 または、検索バーにソース名を入力して、カタログから特定のソースを検索します。
次に移動: マーケティングの自動化 表示するカテゴリ Customer.io ソースカード。 最初に、「 」を選択します。 データを追加.
データの選択 select-data
The データを選択 の手順が表示され、Platform に取り込むデータを選択するためのインターフェイスが提供されます。
- インターフェイスの左側には、アカウント内で使用可能なデータストリームを表示できるブラウザーがあります。
- インターフェイスの右側では、JSON ファイルから最大 100 行のデータをプレビューできます。
選択 ファイルをアップロード をクリックして、ローカルシステムから JSON ファイルをアップロードします。 または、アップロードする JSON ファイルをにドラッグ&ドロップすることもできます ファイルをドラッグ&ドロップ パネル。
ファイルがアップロードされると、プレビューインターフェイスが更新され、アップロードしたスキーマのプレビューが表示されます。 プレビューインターフェイスを使用すると、ファイルの内容と構造を検査できます。 また、 検索フィールド スキーマ内から特定の項目にアクセスするユーティリティ。
終了したら、「次へ」を選択します。
データフローの詳細 dataflow-detail
The データフローの詳細 手順が表示され、既存のデータセットを使用するか、データフローの新しいデータセットを確立するか、およびデータフローの名前と説明を指定する機会が提供されます。 この手順では、プロファイルの取り込み、エラー診断、部分取り込み、アラートの設定も指定できます。
終了したら、「次へ」を選択します。
マッピング mapping
マッピング手順が表示され、ソーススキーマのソースフィールドを、ターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが提供されます。
Platform は、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに対するインテリジェントなレコメンデーションを提供します。 マッピングルールは、ユースケースに合わせて手動で調整できます。必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッパーインターフェイスと計算フィールドを使用した包括的な手順については、 データ準備 UI ガイド.
以下に示すすべてのマッピングは必須で、 レビュー ステージ。
object_type
id
email
event_id
cio_id
metric
timestamp
cio_id
実行時 Customer.io ウェブフック test mode
関連付けられたフィールドが送信されないので Customer.io.ソースデータが正常にマッピングされたら、「 」を選択します。 次へ.
レビュー review
レビュー 手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。
- 接続:ソースのタイプ、選択したソースファイルの関連パスおよびそのソースファイル内の列の数を表示します。
- データセットの割り当てとフィールドのマッピング:ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。
データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。
ストリーミングエンドポイント URL を取得する get-streaming-endpoint
ストリーミングデータフローを作成したら、ストリーミングエンドポイント URL を取得できます。 このエンドポイントは、Webhook を購読するために使用され、ストリーミングソースとExperience Platformが通信できます。
Webhook の設定に使用する URL を構築するために Customer.io 次を取得する必要があります。
- データフロー ID
- ストリーミングエンドポイント
次の手順で データフロー ID および ストリーミングエンドポイント、に移動します。 データフローアクティビティ 作成したデータフローのページを開き、詳細を プロパティ パネル。
ストリーミングエンドポイントとデータフロー ID を取得したら、次のパターンに基づいて URL を作成します。 {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}
. 例えば、生成される Webhook URL は次のようになります。 https://dcs.adobedc.net/collection/febc116d22ba0ea2868e9c93b199375302afb8a589617700991bb8f3f0341ad7?x-adobe-flow-id=439b3fc4-3042-4a3a-b5e0-a494898d3fb0
でのレポート Webhook の設定 Customer.io set-up-webhook
Webhook URL を作成すると、 Customer.io ユーザーインターフェイス。 レポート用 Web フックの設定手順については、 Customer.io ガイド をクリックします。
Adobe Analytics の Customer.io ユーザーインターフェイス、 webhook URL (内) WEBHOOK ENDPOINT フィールドに入力します。
次の手順 next-steps
このチュートリアルに従うことで、 Customer.io データをExperience Platformに送信します。 取り込まれるデータを監視するには、 Platform UI を使用したストリーミングデータフローの監視.
その他のリソース additional-resources
以下の節では、 Customer.io ソース。
ガードレール guardrails
ガードレールについて詳しくは、 Customer.io タイムアウトと失敗のページ.
検証 validation
ソースとが正しく設定されていることを検証するには、以下を実行します。 Customer.io メッセージを取り込むには、次の手順に従います。
- 次の項目を確認できます。 Customer.io アクティビティログ がキャプチャしたイベントを識別するページ Customer.io.
- Platform UI で、「 」を選択します。 データフローを表示 の横に Customer.io ソースカタログのカードメニュー 次に、「 データセットをプレビュー で選択したイベントに対して取り込まれたデータを検証するには、以下を実行します。 Customer.io.