[ベータ版]{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
Experience Platform UIで、左側のナビゲーションから「ソース」を選択して、 ソース ワークスペースにアクセスします。 画面の左側にあるカタログから適切なカテゴリを選択することができます。 または、使用する特定のソースを検索オプションを使用して探すこともできます。
「支払い」カテゴリで、「Stripe」を選択し、「設定」を選択します。
Connect Stripe アカウント ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。
新しいアカウントを作成するには、新しいアカウントを選択し、名前、オプションの説明、資格情報を指定します。
完了したら、「ソースに接続」を選択し、新しい接続が確立されるまでしばらく時間を空けます。
| table 0-row-2 1-row-2 | |
|---|---|
| 資格情報 | 説明 |
| アクセストークン | Stripe アクセストークン。 アクセストークンの取得方法について詳しくは、Stripe 認証ガイド を参照してください。 |
既存のアカウントを使用するには、既存のアカウントを選択し、既存のアカウントカタログから使用するアカウントを選択します。
続行するには、次へを選択してください。
データの選択 select-data
アカウントにアクセスできるようになったので、取り込むStripe データへの適切なパスを特定する必要があります。 「リソースパス」を選択し、データの取り込み元となるエンドポイントを選択します。 使用可能なStripe エンドポイントは次のとおりです。
- 課金
- 購読
- 返金
- 残高取引
- 顧客
- 価格
エンドポイントを選択すると、インターフェイスがプレビュー画面に更新され、選択したStripe エンドポイントのデータ構造が表示されます。 続行するには、次へを選択してください。
データセットとデータフローの詳細を提供 provide-dataset-and-dataflow-details
次に、データセットとデータフローに関する情報を提供する必要があります。
データセットの詳細 dataset-details
データセットは、スキーマ（列）とフィールド（行）で構成されるデータコレクション（通常はテーブル）を格納し管理するための構造です。 Experience Platform に正常に取り込まれたデータは、データレイク内にデータセットとして保存されます。 この手順では、新しいデータセットを作成するか、既存のデータセットを使用できます。
新しいデータセットを使用するには、新しいデータセットを選択し、データセットの名前とオプションの説明を指定します。 データセットが準拠するExperience Data Model （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回:1回限りの取り込みを作成するには、頻度を
onceに設定します。 1回限りの取り込みデータフローを作成する場合、間隔とバックフィルの設定は使用できません。 デフォルトでは、スケジュール頻度は1回に設定されます。 - 分:1分ごとにデータフローを取り込むようにスケジュールする頻度を
minuteに設定します。 - 時間:1時間ごとにデータを取り込むようにデータフローをスケジュールする頻度を
hourに設定します。 - 日: 1日ごとにデータフローを取り込むようにスケジュールする頻度を
dayに設定します。 - 週：週ごとにデータフローを取り込むようにスケジュールする頻度を
weekに設定します。
頻度を選択したら、インターバル設定を設定して、取り込みごとに時間枠を設定できます。 例えば、頻度を1日に設定し、間隔を15に設定した場合、データフローは15日ごとに実行されます。 間隔を0に設定することはできません。 各周波数に対して許容される最小区間値は次のとおりです。
- 1回：なし
- 分: 15
- 時間: 1
- 日: 1
- 週: 1
データフローの取り込みスケジュールを設定したら、次へを選択します。
データフローのレビュー
データフロー作成プロセスの最後の手順は、データフローを実行する前に確認することです。 新しいデータフローが実行される前に、レビュー手順を使用して、新しいデータフローの詳細を確認します。 詳細は、次のカテゴリにグループ化されます。
- 接続: ソースタイプ、選択したソースファイルの関連パス、そのソースファイル内の列数を表示します。
- データセットの割り当てとフィールドのマッピング：ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。
- スケジュール：取り込みスケジュールのアクティブな期間、頻度、間隔を表示します。
データフローをレビューしたら、「終了」を選択し、データフローが作成されるまでしばらく待ちます。
次の手順
このチュートリアルに従うことで、Stripe ソースからExperience Platformに支払いデータを取り込むデータフローを正常に作成しました。 その他のリソースについては、以下に概説するドキュメントを参照してください。
データフローの監視
データフローを作成したら、そのデータフローを通じて取り込まれるデータを監視し、取り込み率、成功、エラーに関する情報を表示できます。 データフローの監視方法について詳しくは、UIでのアカウントとデータフローの監視に関するチュートリアル を参照してください。
データフローの更新
データフローのスケジュール設定、マッピングおよび一般情報の設定を更新するには、UIでのソースデータフローの更新に関するチュートリアルを参照してください。
データフローの削除
データフロー ワークスペースで使用できる 削除 関数を使用して、不要になった、または誤って作成されたデータフローを削除できます。 データフローの削除方法について詳しくは、UIでのデータフローの削除に関するチュートリアルを参照してください。