[ベータ版]{class="badge informative"}
ユーザーインターフェイスを使用した、Stripe アカウントからExperience Platformへの支払いデータの取り込み
ユーザーインターフェイスを使用して Stripe アカウントからAdobe Experience Platformに支払いデータを取り込む方法については、次のチュートリアルを参照してください。
基本を学ぶ
このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム：Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本：スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル：スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile：複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
認証
認証資格情報の取得方法について詳しくは、Stripe 概要を参照してください。
Stripe アカウントを接続 connect
Platform UI の左側のナビゲーションバーで「ソース」を選択して、ソースワークスペースにアクセスします。画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。
支払い カテゴリで、「Stripe」を選択し、設定 を選択します。
Stripeアカウントを接続 ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。
新しいアカウントを作成するには、「新しいアカウント」を選択し、名前、説明（オプション）、の資格情報を入力します。
終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。
| table 0-row-2 1-row-2 | |
|---|---|
| 資格情報 | 説明 |
| アクセストークン | Stripe アクセストークン。 アクセストークンの取得方法について詳しくは、Stripe 認証ガイドを参照してください。 |
既存のアカウントを使用するには、「既存のアカウント」を選択し、既存のアカウントカタログから使用するアカウントを選択します。
「次へ」を選択して次に進みます。
データの選択 select-data
アカウントにアクセスできるようになったので、取り込む Stripe データへの適切なパスを特定する必要があります。 リソースパス を選択してから、データを取り込むエンドポイントを選択します。 使用できる Stripe エンドポイントは次のとおりです。
- 料金
- 購読
- 払戻
- 残高トランザクション
- 顧客
- 価格
エンドポイントが選択されると、インターフェイスがプレビュー画面に更新され、選択した Stripe エンドポイントのデータ構造が表示されます。 「次へ」を選択して次に進みます。
データセットとデータフローの詳細の指定 provide-dataset-and-dataflow-details
次に、データセットとデータフローに関する情報を指定する必要があります。
データセットの詳細 dataset-details
データセットは、スキーマ（列）とフィールド（行）で構成されるデータコレクション（通常はテーブル）を格納し管理するための構造です。Experience Platformに正常に取り込まれたデータは、データセットとしてデータレイク内に保存されます。 この手順では、新しいデータセットを作成するか、既存のデータセットを使用します。
新しいデータセットを使用するには、「新しいデータセット」を選択し、データセットの名前とオプションの説明を入力します。 また、データセットが準拠するエクスペリエンスデータモデル（XDM）スキーマを選択する必要があります。
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| 新しいデータセットの詳細 | 説明 |
| 出力データセット名 | 新規データセットの名前。 |
| 説明 | （任意）新しいデータセットの簡単な説明。 |
| スキーマ | 組織に存在するスキーマのドロップダウンリスト。 ソース設定プロセスの前に、独自のスキーマを作成することもできます。 詳しくは、UI での XDM スキーマの作成に関するガイドを参照してください。 |
既存のデータセットがある場合は、「既存のデータセット」を選択し、「詳細検索」オプションを使用すると、組織内のすべてのデータセットのウィンドウが表示されます。これには、リアルタイム顧客プロファイルへの取り込みが有効になっているかどうかなど、それぞれの詳細が含まれます。
データセットがリアルタイム顧客プロファイルに対して有効になっている場合、この手順の間に プロファイルデータセット を切り替えて、プロファイル取り込み用のデータを有効にすることができます。 また、この手順を使用して、エラー診断 および 部分取り込み を有効にすることもできます。
- エラー診断: エラー診断 を選択して、データセットアクティビティとデータフローステータスを監視する際に後で参照できるエラー診断を生成するようにソースに指示します。
- 部分取り込み：部分バッチ取り込みは、設定可能な特定のしきい値まで、エラーを含んだデータを取り込む機能です。 この機能を使用すると、正確なデータをすべてExperience Platformに正常に取り込みながら、不正なデータがすべて無効な理由に関する情報と共に個別にバッチ処理されます。
データフローの詳細 dataflow-details
データセットを設定したら、名前、説明（オプション）、アラート設定など、データフローの詳細を指定する必要があります。
Experience Platformは、ユーザーが購読できるイベントベースのアラートを作成できます。 これらのオプションをトリガーするには、すべて実行中のデータフローが必要です。 詳しくは、 アラートの概要を参照してください
- ソースデータフロー実行開始：データフロー実行が開始したときに通知を受け取るには、このアラートを選択します。
- ソースデータフロー実行成功：データフローがエラーなく終了した場合に通知を受け取るには、このアラートを選択します。
- ソースデータフロー実行の失敗：データフローの実行がエラーで終了した場合に通知を受け取るには、このアラートを選択します。
終了したら、「次へ を選択して続行します。
XDM スキーマへのフィールドのマッピング mapping
「マッピング」手順が表示されます。マッピングインターフェイスを使用して、データをExperience Platformに取り込む前に、ソースデータを適切なスキーマフィールドにマッピングします。 マッピングインターフェイスの使用方法に関するガイドについては、 データ準備 UI ガイドを参照してください。
取り込みスケジュールを設定 scheduling
次に、スケジュールインターフェイスを使用して、データフローの取り込みスケジュールを作成します。
頻度ドロップダウンを選択して、データフローの取り込み頻度を設定します。
また、カレンダーアイコンを選択し、ポップアップカレンダーを使用して取り込み開始時刻を設定することもできます。
頻度を設定して、データフローの実行頻度を示します。 頻度は次のように設定できます。
- 1 回：頻度を
onceに設定して、1 回限りの取り込みを作成します。 1 回限りの取り込みデータフローを作成する場合、間隔とバックフィルの設定は使用できません。 デフォルトでは、スケジュールの頻度は 1 回に設定されています。 - 分：頻度を
minuteに設定して、1 分ごとにデータを取り込むようにデータフローをスケジュールします。 - 時間：頻度を
hourに設定して、1 時間ごとにデータを取り込むようにデータフローをスケジュールします。 - 日：頻度を
dayに設定して、1 日にデータを取り込むようにデータフローをスケジュールします。 - 週：頻度を
weekに設定して、データフローが週ごとにデータを取り込むようにスケジュールします。
頻度を選択したら、間隔設定を指定して、各取り込み間の時間枠を確立できます。 例えば、頻度を日に設定し、間隔を 15 に設定すると、データフローは 15 日ごとに実行されます。 間隔をゼロに設定することはできません。 各頻度で許容される最小のインターバル値は次のとおりです。
- 1 回：なし
- 分: 15
- 時間: 1
- 日: 1
- 週: 1
データフローの取り込みスケジュールを設定したら、「次へ」を選択します。
データフローのレビュー
データフロー作成プロセスの最後の手順は、データフローを実行する前に確認することです。 レビュー ステップを使用すると、新しいデータフローを実行する前に詳細をレビューできます。 詳細は、次のカテゴリにグループ化されます。
- 接続：ソースのタイプ、選択したソースファイルの関連パスおよびそのソースファイル内の列の数を表示します。
- データセットの割り当てとフィールドのマッピング：ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。
- スケジュール：取り込みスケジュールのアクティブな期間、頻度、間隔を表示します。
データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。
次の手順
このチュートリアルでは、支払いデータを Stripe ソースからExperience Platformに取り込むデータフローを正常に作成しました。 その他のリソースについては、以下に概要を説明するドキュメントを参照してください。
データフローの監視
データフローを作成したら、そのデータフローを通じて取り込まれるデータを監視し、取り込み率、成功、エラーに関する情報を表示できます。 データフローのモニタリング方法について詳しくは、UI でのアカウントとデータフローのモニタリングのチュートリアルを参照してください。
データフローの更新
データフローのスケジュール、マッピング、一般情報の設定を更新するには、UI でのソースデータフローの更新に関するチュートリアルを参照してください。
データフローの削除
不要になったデータフローや誤って作成されたデータフローは、データフロー ワークスペース内にある 削除 機能で削除できます。データフローの削除方法について詳しくは、UI でのデータフローの削除のチュートリアルを参照してください。