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

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

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

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

Customer.io のスキーマの例を示す Platform UI のスクリーンショット

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

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

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

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

Customer.io カードを含むカタログの Platform UI のスクリーンショット

データの選択 select-data

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

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

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

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

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

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

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

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

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

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

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

マッピング mapping

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

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

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

ターゲットフィールド
説明
object_type
オブジェクトタイプ。サポートされるタイプについては、Customer.io events のドキュメントを参照してください。
id
オブジェクトの識別子。
email
オブジェクトに関連付けられた電子メールアドレス。
event_id
イベントの一意の ID。
cio_id
イベントの Customer.io 識別子。
metric
イベントタイプ。 詳しくは、Customer.io events ドキュメントでサポートされるタイプを参照してください。
timestamp
イベントが発生したときのタイムスタンプ。
IMPORTANT
test mode で Webhook を実行する際は、cio_id から送信され Customer.io 関連するフィールドがないので、Customer.io をマッピングしないでください。

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

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

レビュー review

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

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

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

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

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

ストリーミングデータフローを作成したので、ストリーミングエンドポイント 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 の設定 set-up-webhook

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

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

Webhook エンドポイントフィールドを表示する Customer.io ユーザーインターフェイス

TIP
レポート Webhook 用に様々なイベントを購読できます。 Customer.io のアクションイベントトリガー条件が満たされると、各イベントのメッセージが Platform に取り込まれます。 様々なイベントについて詳しくは、Customer.io イベントドキュメントを参照してください。

次の手順 next-steps

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

その他のリソース additional-resources

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

ガードレール guardrails

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

検証 validation

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

  • Customer.io アクティビティログ ページをチェックすると、Customer.io によって取り込まれるイベントを特定できます。

アクティビティログを示す Customer.io UI のスクリーンショット

  • Platform UI で、ソースカタログの Customer.io ーザーカードメニューの横にある データフローを表示 を選択します。 次に、「データセットをプレビュー」をクリックして、Customer.io で選択したイベントに対して取り込まれたデータを検証します。

取り込んだイベントを示す Platform UI のスクリーンショット

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089