を作成 Marketo Engage ui のソース接続とデータフロー
このチュートリアルでは、UI で Marketo Engage（以下「Marketo」）ソースコネクタを作成し、B2B データを Adobe Experience Platform に取り込む手順について説明します。
基本を学ぶ
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
- B2B 名前空間とスキーマ自動生成ユーティリティ:B2B 名前空間とスキーマ自動生成ユーティリティを使用すると、次のことを使用できます Postman b2B 名前空間とスキーマの値を自動生成します。 を作成する前に、まず B2B 名前空間とスキーマを完了する必要があります Marketo ソース接続とデータフロー。
- ソース：Experience Platform を使用すると、データを様々なソースから取得しながら、Platform サービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。
- Experience Data Model（XDM）：Adobe Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- UI でのスキーマの作成と編集：UI でスキーマを作成および編集する方法について説明します。
- ID 名前空間：ID 名前空間は Identity Service のコンポーネントで、ID の関連先コンテキストのインジケーターとして機能します。完全修飾 ID には、ID 値と名前空間が含まれます。
- Real-Time Customer Profile：複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
- サンドボックス：Experience Platform は、単一の Platform インスタンスを個別の仮想環境に分割する仮想サンドボックスを提供し、デジタル体験アプリケーションの開発および進化を支援します。
必要な資格情報の収集
にアクセスするには Marketo Experience Platform時にアカウント。次の値を指定する必要があります。
munchkinIdclientIdclientSecretこれらの値の取得について詳しくは、Marketo 認証ガイドを参照してください。
必要な資格情報を収集したら、次の節の手順に従います。
Marketo アカウントの接続
Platform UI の左側のナビゲーションバーで「ソース」を選択して、ソースワークスペースにアクセスします。画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。
の下 Adobeアプリケーション カテゴリ、選択 Marketo Engage を選択してから、 データを追加.
Marketo Engage アカウントの接続 ページが表示されます。このページでは、新しいアカウントを使用するか、既存のアカウントにアクセスできます。
新しいアカウントを作成するには、を選択します 新しいアカウント に加えて、名前、説明（オプション）、の認証情報を指定します。
終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。
既存のアカウントを使用するには、を選択します 既存のアカウント 次に、既存のアカウントカタログから使用するアカウントを選択します。
「次へ」を選択して次に進みます。
データセットの選択
Marketo アカウントを作成したら、次の手順では Marketo のデータセットを調べるためのインターフェースを利用できます。
インターフェイスの左半分はディレクトリブラウザーで、Marketo データセットが 10 種類表示されています。Marketo ソース接続を完全に機能させるには、9 種類の異なるデータセットを取り込む必要があります。また、 Marketo Account-Based Marketing（ABM）機能を使用する場合は、10 個目のデータフローを作成して指定顧客のデータセットを取り込む必要があります。
取得するデータセットを選択します。 これにより、インターフェイスが更新され、データセットのプレビューが表示されます。 終了したら、「次へ」を選択します。
データセットとデータフローの詳細の指定 provide-dataset-and-dataflow-details
次に、データセットとデータフローに関する情報を指定する必要があります。
データセットの詳細 dataset-details
データセットは、スキーマ（列）とフィールド（行）で構成されるデータコレクション（通常はテーブル）を格納し管理するための構造です。Experience Platformに正常に取り込まれたデータは、データセットとしてデータレイク内に保存されます。 この手順では、新しいデータセットを作成するか、既存のデータセットを使用します。
新しいデータセットを使用するには、以下を選択します。 新しいデータセット 次に、データセットの名前と説明（オプション）を入力します。 また、データセットが準拠するエクスペリエンスデータモデル（XDM）スキーマを選択する必要があります。
既存のデータセットがある場合は、 既存のデータセット 次に、 詳細検索 リアルタイム顧客プロファイルへの取り込みが有効かどうかなど、組織内のすべてのデータセットのそれぞれの詳細を含むウィンドウを表示するオプション。
データフロー設定 dataflow-configurations
リアルタイム顧客プロファイルに対してデータセットが有効になっている場合は、この手順の間に切り替えることができます プロファイルデータセット でプロファイル取り込み用のデータを有効にします。 また、この手順を使用してを有効にすることもできます エラー診断 および 部分取り込み.
- エラー診断：を選択 エラー診断 データセットアクティビティとデータフローステータスを監視する際に後で参照できるエラー診断を生成するようにソースに指示する。
- 部分取り込み: 部分バッチ取り込み は、設定可能な特定のしきい値まで、エラーを含むデータを取り込む機能です。 この機能を使用すると、正確なデータをすべてExperience Platformに正常に取り込みながら、不正なデータがすべて無効な理由に関する情報と共に個別にバッチ処理されます。
この手順の間に、を有効にできます サンプルデータフロー データの取り込みを制限し、人物 ID を含むすべての履歴データの取り込みに伴う追加コストを回避します。
サンプルデータフローの使用に関するクイックガイド
サンプルデータフローは、次の目的で設定できます Marketo データフローを使用して取り込みレートを制限してから、大量のデータを取り込まずにExperience Platform機能を試します。
- サンプルデータフローを有効にして、最大 100,000 件（最大レコード ID から）のレコードまたはバックフィルジョブ中の最後の 10 日間のアクティビティを取り込むことで、履歴データを制限します。
- すべての B2B エンティティにサンプルデータフロー設定を使用する場合、ソースデータの履歴全体が取り込まれないので、関連するレコードの一部が欠落している可能性があることを考慮する必要があります。
さらに、会社データセットからデータを取り込む場合は、を有効にできます 未要求アカウントの除外 未要求アカウントを取り込みから除外します。
個人がフォームに入力する場合、 Marketo 他のデータを含まない会社名に基づいて、幻のアカウントレコードを作成します。 新しいデータフローの場合、未要求アカウントを除外する切替スイッチはデフォルトで有効になっています。 既存のデータフローの場合、この機能を有効または無効にして、既存のデータではなく、新しく取り込んだデータに変更を適用できます。
Marketo データセットのソースフィールドをターゲットの XDM フィールドにマッピング
マッピング手順が表示され、ソーススキーマのソースフィールドを、ターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが提供されます。
各 Marketo データセットには、従うべき固有のマッピングルールがあります。Marketo データセットを XDM にマッピングする方法について詳しくは、次を参照してください。
必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッピングインターフェイスの使用に関する包括的な手順については、データ準備 UI ガイドを参照してください。
マッピングセットの準備が整ったら「 次へ」を選択し、新しいデータフローが作成されるまでしばらく待ちます。
データフローのレビュー
レビュー 手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。
- 接続：ソースのタイプ、選択したソースエンティティの関連パス、およびそのソースエンティティ内の列の数を表示します。
- データセットの割り当てとフィールドのマッピング：ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。
データフローをレビューしたら、「保存して取り込み」を選択し、データフローが作成されるまでしばらく待ちます。
データフローの監視
データフローを作成したら、そのデータフローを通じて取り込まれるデータをモニターすると、取り込み速度、成功、エラーに関する情報を確認できます。データフローのモニター方法について詳しくは、UI でのデータフローのモニタリングを参照してください。
属性の削除
データセット内のカスタム属性は、過去にさかのぼって非表示にしたり削除したりすることはできません。既存のデータセットのカスタム属性を非表示または削除する場合は、そのカスタム属性がない新しいデータセットと、新しい XDM スキーマを作成し、作成した新しいデータセット用に新しいデータフローを構成する必要があります。また、非表示または削除するカスタム属性があるデータセットを含む、元のデータフローを無効または削除する必要があります。
データフローの削除
不要になったデータフローや誤って作成されたデータフローは、データフローワークスペース内にある 削除 機能で削除できます。データフローの削除方法について詳しくは、UI でのデータフローの削除のチュートリアルを参照してください。
次の手順
このチュートリアルでは、から B2B データを取り込むデータフローを正常に作成しました Marketo Engage ソースからExperience Platform。
付録 appendix
以下の節では、 Marketo ソース。
UI のエラーメッセージ error-messages
Platform が設定の問題を検出すると、次のエラーメッセージが UI に表示されます。
Munchkin ID は適切な組織にマッピングされていません
次の場合、認証は拒否されます Munchkin ID は、使用している Platform 組織にマッピングされていません。 の間のマッピングの設定 Munchkin ID およびを使用している組織 Marketo インターフェイス.
プライマリ ID がありません
プライマリ ID がない場合、データフローは保存に失敗し、取り込まれません。 を確実にする プライマリ ID が XDM スキーマ内に存在するデータフローを設定する前に行います。
