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