を作成する前に Marketo Engage ソース接続とデータフローの場合は、まず Adobe組織 ID をマッピング済み in Marketo. さらに、 自動入力 Marketo B2B 名前空間とスキーマ ソース接続とデータフローを作成する前に、次の手順を実行します。
このチュートリアルでは、UI で Marketo Engage(以下「Marketo」)ソースコネクタを作成し、B2B データを Adobe Experience Platform に取り込む手順について説明します。
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
Platform で Marketo アカウントにアクセスするには、次の値を指定する必要があります。
資格情報 | 説明 |
---|---|
munchkinId |
Munchkin ID は、特定の Marketo インスタンスの一意の ID です。 |
clientId |
Marketo インスタンスの一意のクライアント ID。 |
clientSecret |
Marketo インスタンスの一意のクライアント秘密鍵。 |
これらの値の取得について詳しくは、Marketo 認証ガイドを参照してください。
必要な資格情報を収集したら、次の節の手順に従います。
Platform UI の左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。または、検索バーを使用して、利用したい特定のソースを見つけることもできます。
アドビアプリケーションカテゴリ内で「Marketo Engage」を選択します。次に「データの追加」を選択して、新しい Marketo データフローを作成します。
Marketo Engage アカウントの接続ページが表示されます。このページでは、新しいアカウントを使用するか、既存のアカウントにアクセスできます。
既存のアカウントでデータフローを作成するには、「既存のアカウント」を選択して、使用したい Marketo アカウントを選択します。「次へ」を選択して次に進みます。
新しいアカウントを作成する場合は、「新しいアカウント」を選択します。表示される入力フォームで、アカウント名、説明(オプション)、Marketo の認証資格情報を入力します。完了したら、「 ソースへ接続」を選択し、新しい接続が確立されるまでしばらく待ちます。
Marketo アカウントを作成したら、次の手順では Marketo のデータセットを調べるためのインターフェースを利用できます。
インターフェイスの左半分はディレクトリブラウザーで、Marketo データセットが 10 種類表示されています。Marketo ソース接続を完全に機能させるには、9 種類の異なるデータセットを取り込む必要があります。また、 Marketo Account-Based Marketing(ABM)機能を使用する場合は、10 個目のデータフローを作成して指定顧客のデータセットを取り込む必要があります。
説明を簡潔にするために、以降のチュートリアルでは商談を例として使用しますが、以下で説明する手順は 10 種類の Marketo データセットのいずれにも該当します。
最初に取り込むデータセットを選択したら「次へ」を選択します。
データフロー詳細ページでは、既存のデータセットと新しいデータセットのどちらを使用するかを選択できます。このプロセスでは、プロファイルデータセット、エラー診断、部分取り込み、およびアラートの設定も指定できます。
データを既存のデータセットに取り込むには、既存のデータセットを選択します。「詳細検索」オプションを使用するか、ドロップダウンメニューで既存のデータセットのリストをスクロールすると、既存のデータセットを取得できます。データセットを選択したら、データフローの名前と説明を入力します。
データを新しいデータセットに取り込むには、「新しいデータセット」を選択して、出力データセット名とオプションの説明を入力します。次に、「詳細検索」オプションを使用するか、ドロップダウンメニューで既存のスキーマのリストをスクロールして、マッピングするスキーマを選択します。スキーマを選択したら、データフローの名前と説明を指定します。
次に、 プロファイルデータセット切り替えスイッチを選択して、Profile のデータセットを有効にします。これにより、エンティティの属性と動作の全体像を把握できます。Profile が有効化されたすべてのデータセットのデータは Profile に含まれ、変更はデータフローを保存するときに適用されます。
エラー診断は、データフローで発生するエラーレコードに対して、詳細なエラーメッセージ生成を有効にします。部分取り込みでは、手動で定義した特定のしきい値に到達するまで、エラーを含むデータを取り込むことができます。詳しくは、バッチ取り込みの概要を参照してください。
The Marketo ソースは、バッチ取り込みを使用してすべての履歴レコードを取り込み、リアルタイム更新にストリーミング取り込みを使用します。 これにより、誤ったレコードを取り込みながら、ソースのストリーミングを続行できます。 部分取り込み切り替えスイッチを有効化して、エラーしきい値 % を最大にし、データフローが失敗するのを防ぎます。
アラートを有効にすると、データフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用したソースアラートの購読についてのガイドを参照してください。
データフローへの詳細の入力を終えたら「次へ 」を選択します。
データフローを作成して会社のデータセットからデータを取り込む場合、 要求されていないアカウントの除外 を使用して、取り込みから要求されていないアカウントを除外するか、含めます。
個人がフォームに入力する場合、 Marketo は、他のデータを含まない会社名に基づいて仮想勘定レコードを作成します。 新しいデータフローの場合、要求されていないアカウントを除外する切り替えは、デフォルトで有効になっています。 既存のデータフローの場合、機能を有効または無効にできます。変更は既存のデータではなく、新しく取り込んだデータに適用されます。
マッピング手順が表示され、ソーススキーマのソースフィールドを、ターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが提供されます。
各 Marketo データセットには、従うべき固有のマッピングルールがあります。Marketo データセットを XDM にマッピングする方法について詳しくは、次を参照してください。
必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッピングインターフェイスの使用に関する包括的な手順については、データ準備 UI ガイドを参照してください。
マッピングセットの準備が整ったら「 次へ」を選択し、新しいデータフローが作成されるまでしばらく待ちます。
レビュー手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。
データフローをレビューしたら、「保存して取り込み」を選択し、データフローが作成されるまでしばらく待ちます。
データフローを作成したら、そのデータフローを通じて取り込まれるデータをモニターすると、取り込み速度、成功、エラーに関する情報を確認できます。データフローのモニター方法について詳しくは、UI でのデータフローのモニタリングを参照してください。
データセット内のカスタム属性は、過去にさかのぼって非表示にしたり削除したりすることはできません。既存のデータセットのカスタム属性を非表示または削除する場合は、そのカスタム属性がない新しいデータセットと、新しい XDM スキーマを作成し、作成した新しいデータセット用に新しいデータフローを構成する必要があります。また、非表示または削除するカスタム属性があるデータセットを含む、元のデータフローを無効または削除する必要があります。
不要になったデータフローや誤って作成されたデータフローは、データフローワークスペース内にある削除機能で削除できます。データフローの削除方法について詳しくは、UI でのデータフローの削除のチュートリアルを参照してください。
このチュートリアルでは、Marketo データを取り込むためのデータフローを正常に作成しました。これで、Real-Time Customer Profile や Data Science Workspace などのダウンストリームの Platform サービスで受信データを使用できるようになりました。詳しくは、次のドキュメントを参照してください。
以下の節では、 Marketo ソース。
Platform が設定に関する問題を検出すると、UI に次のエラーメッセージが表示されます。
次の場合、認証は拒否されます: Munchkin ID は、使用している Platform 組織にマッピングされていません。 次の間のマッピングを設定します: Munchkin ID および組織が Marketo インターフェイス.
プライマリ ID が見つからない場合、データフローの保存と取り込みに失敗します。 以下を確認します。 XDM スキーマ内にプライマリ ID が存在する(データフローを設定する前に)を含める必要があります。