ベータ

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

このチュートリアルでは、 Customer.io Adobe Experience Platformユーザーインターフェイスを使用したソース接続とデータフロー。

はじめに

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

• Experience Data Model (XDM) システム：Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
  • スキーマ構成の基本：スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
  • スキーマエディターのチュートリアル：スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
• Real-Time Customer Profile：複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。

前提条件

次の節では、 Customer.io ソース接続。

のソーススキーマを定義するサンプル JSON Customer.io

を作成する前に 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

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

Customer.io アカウントを接続

Platform UI で、「 ソース 左側のナビゲーションから ソース workspace を参照し、Experience Platformで使用可能なソースのカタログを確認します。

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

次に移動： マーケティングの自動化 表示するカテゴリ Customer.io ソースカード。 最初に、 データを追加.

データの選択

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

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

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

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

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

データフローの詳細

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

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

マッピング

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

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

以下に示すすべてのマッピングは必須で、 レビュー ステージ。

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

レビュー

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

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

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

ストリーミングエンドポイント URL の取得

ストリーミングデータフローを作成したら、ストリーミングエンドポイント 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

Webhook URL を作成すると、 Customer.io ユーザーインターフェイス。 レポート用 Web フックの設定手順については、 Customer.io ガイド をクリックします。

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

次の手順

このチュートリアルに従うことで、 Customer.io データをExperience Platformに送信します。 取り込まれるデータを監視するには、 Platform UI を使用したストリーミングデータフローの監視.

その他のリソース

以下の節では、 Customer.io ソース。

ガードレール

ガードレールについて詳しくは、 Customer.io タイムアウトと失敗のページ.

検証

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

• 次の項目を確認できます。 Customer.io アクティビティログ キャプチャされたイベントを識別するページ Customer.io.

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

Business.Adobe.com リソース