[ベータ版]{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のスキーマの例を示す

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

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

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

Marketing automation カテゴリに移動して、Customer.io ソースカードを確認します。 開始するには、Add data​を選択します。

Customer.io カードを持つカタログの

データの選択 select-data

Select data ステップが表示され、Experience Platformに取り込むデータを選択するためのインターフェイスが提供されます。

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

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

終了したら「Next」を選択します。

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

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

終了したら「Next」を選択します。

マッピング mapping

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

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

以下に示すすべてのマッピングは必須であり、Review ステージに進む前に設定する必要があります。

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

レビュー review

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

データフローをレビューしたら、Finish​を選択し、データフローの作成に時間を割いてください。

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

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

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

Dataflow ID​と​ Streaming endpoint ​を取得するには、作成したばかりのデータフローのDataflow activity ページに移動し、Properties パネルの下部から詳細をコピーします。

ストリーミングエンドポイントとデータフロー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

Customer.ioでレポート Webhookを設定 set-up-webhook

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

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個のメッセージを取り込んでいることを検証するには、次の手順に従います。

アクティビティログを表示する

取り込まれたイベントを示す