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

UIを使用してTalon.One データをExperience Platformにストリーミング

AVAILABILITY
Talon.One ソースはベータ版です。ベータ版のソースの使用について詳しくは、ソースの概要の条件を参照してください。

このガイドでは、UIのソースワークスペースを使用して、Talon.OneからAdobe Experience Platformにデータを接続してストリーミングする方法について説明します。

はじめに

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

IMPORTANT
アカウントをExperience Platformに接続する前に完了する必要がある前提条件の手順については、Talon.One 概要を参照してください。

ソースカタログを移動する

Experience Platform UIで、左側のナビゲーションから「Sources」を選択して、Sources ワークスペースにアクセスします。 Categories パネルで適切なカテゴリを選択します。 または、検索バーを使用して、使用する特定のソースに移動します。

Talon.Oneからデータをストリーミングするには、Talon.One Streaming Events​の下にある​Loyalty ソースカードを選択し、Add data​を選択します。

TIP
ソースカタログのソースには、特定のソースがまだ認証済みアカウントを持っていない場合、Set up オプションが表示されます。 認証済みアカウントが作成されると、このオプションは​ Add data ​に変更されます。

Talon.One ストリーミングイベントカードが選択されたUIのソースカタログ。

データの選択

次に、Select data インターフェイスを使用して、サンプル JSON ファイルをアップロードし、ソーススキーマを定義します。 この手順では、プレビューインターフェイスを使用して、ペイロードのファイル構造を表示できます。 終了したら「Next」を選択します。

ソースワークフローのデータを選択ステップ

データフローの詳細

次に、データセットとデータフローに関する情報を提供する必要があります。

データセットの詳細

データセットとは、スキーマ(列/フィールド)とレコード(行)を含むデータのコレクション(通常はテーブル)のストレージおよび管理構造です。 Experience Platformに正常に取り込まれたデータは、データセットとしてデータレイク内に保持されます。

この手順では、既存のデータセットを使用するか、新しいデータセットを作成できます。

NOTE
既存のデータセットを使用するか、新しいデータセットを作成するかに関係なく、プロファイル の取り込みに対してデータセットが​有効になっていることを確認する必要があります。
プロファイルの取り込み、エラー診断、および部分取り込みを有効にする手順を選択します。

データセットがリアルタイム顧客プロファイルに対して有効になっている場合、この手順では、Profile dataset​を切り替えて、プロファイル取り込み用のデータを有効にできます。 この手順を使用して、Error diagnostics​と​ Partial ingestion ​を有効にすることもできます。

  • Error diagnostics: データセットのアクティビティとデータフローのステータスを監視する際に、後で参照できるエラー診断を生成するようにソースに指示するには、Error diagnostics​を選択します。
  • Partial ingestion:部分的なバッチ取り込みは、特定の設定可能なしきい値まで、エラーを含むデータを取り込む機能です。 この機能を使用すると、正確なデータをすべてExperience Platformに正常に取り込むことができますが、誤ったデータはすべて、無効な理由に関する情報とともに個別にバッチ化されます。

データフローの詳細

データセットを設定したら、名前、オプションの説明、アラート設定など、データフローの詳細を指定する必要があります。

データフローの詳細インターフェイス

データフロー設定
説明
データフロー名
データフローの名前。 デフォルトでは、読み込まれるファイルの名前が使用されます。
説明
(オプション)データフローの簡単な説明。
アラート

Experience Platformは、ユーザーが購読できるイベントベースのアラートを生成できます。これらのオプションを使用すると、実行中のデータフローがこれらのアラートをトリガーできます。 詳しくは、​ アラートの概要を参照してください

  • ソースデータフロー実行開始:このアラートを選択すると、データフロー実行が開始されたときに通知を受け取ります。
  • ソースデータフローの実行成功:このアラートを選択すると、データフローがエラーなしで終了した場合に通知を受け取ります。
  • ソースデータフロー実行エラー: データフロー実行がエラーで終了した場合に通知を受け取るには、このアラートを選択します。

マッピング

マッピングインターフェイスを使用して、Experience Platformにデータを取り込む前に、ソースデータを適切なスキーマフィールドにマッピングします。 詳しくは、UI マッピングガイドを参照してください。

Talon.One ストリーミングのマッピングインターフェイス。

レビュー

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

  • Connection: アカウント名、ソースプラットフォーム、およびソース名を表示します。
  • Assign dataset and map fields: ターゲットデータセットと、データセットが準拠しているスキーマを表示します。

詳細が正しいことを確認したら、Finish​を選択します。

ソースワークフローのレビューステップ。

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

接続を作成すると、ソースの詳細ページが表示されます。 このページには、以前に実行したデータフロー、ID、ストリーミングエンドポイント URLなど、新しく作成した接続の詳細が表示されます。

ストリーミングエンドポイント URL。

データフローの監視

データフローを作成したら、そのデータフローを通じて取り込まれるデータをモニターすると、取り込み速度、成功、エラーに関する情報を確認できます。データフローを監視する方法について詳しくは、UIでのアカウントとデータフローの監視に関するチュートリアル ​を参照してください。

既知の制限事項

正確なデータ取り込みを確実にするには、Talon.Oneのロイヤルティポイントの変更、階層アップグレード、階層ダウングレード通知からコネクタにデータを送信する必要があります。 ロイヤルティポイント変更通知には階層情報が含まれていないので、これらの通知を別のプロファイルデータセットに送信する必要があります。 同じデータセット内でポイント変更されたデータを階層アップグレードまたはダウングレード通知と組み合わせる場合、階層情報はnull値で失われるか上書きされます。 階層のアップグレードとダウングレードの通知は、両方とも階層の詳細を含むため、同じデータセットを使用できます。 取り込み後、プロファイル結合ルールは、最新のポイントと階層情報を反映するように、結合プロファイルを自動的に更新します。

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