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

UI での Customer.io ソース接続とデータフローの作成

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

はじめに getting-started

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

前提条件 prerequisites

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

Customer.io のソーススキーマを定義するサンプル JSON 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"
    }
  }
}

Customer.io 用のExperience Platform スキーマの作成 create-platform-schema

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

Customer.io アカウントを接続 connect-account

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

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

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

データの選択 select-data

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

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

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

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

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

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

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

マッピング mapping

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

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

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

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

レビュー review

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

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

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

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

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

データフロー 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 の設定 set-up-webhook

Webhook URL を作成したので、Customer.io ユーザーインターフェイスを使用してレポート Webhook を設定できるようになりました。 レポート Webhook の設定手順については、Webhook の設定に関する Customer.io ガイド ​ を参照してください。

Customer.io ユーザーインターフェイスの WEBHOOK ENDPOINT フィールドに webhook URL を入力します。

次の手順 next-steps

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

その他のリソース additional-resources

以下の節では、Customer.io ソースを使用する際に参照できるその他のリソースを示します。

ガードレール guardrails

ガードレールについて詳しくは、Customer.io タイムアウトとエラーのページ ​ を参照してください。

検証 validation

ソースを正しく設定したことと、メッセージが取り込まれてい Customer.io ことを検証するには、次の手順に従います。