の作成 Marketo Engage UI でのソース接続とデータフロー

最終更新日: 2023-11-01
  • トピック:
  • Sources
    このトピックの詳細を表示
  • 作成対象:
  • Developer
    User
    Admin
    Leader
重要

を作成する前に Marketo Engage ソース接続とデータフローの場合は、まず Adobe組織 ID をマッピング済み in Marketo. さらに、 自動入力 Marketo B2B 名前空間とスキーマ ソース接続とデータフローを作成する前に、次の手順を実行します。

このチュートリアルでは、UI で Marketo Engage(以下「Marketo」)ソースコネクタを作成し、B2B データを Adobe Experience Platform に取り込む手順について説明します。

はじめに

このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

  • B2B 名前空間とスキーマ自動生成ユーティリティ:B2B 名前空間とスキーマ自動生成ユーティリティを使用すると、 Postman を使用して、B2B 名前空間とスキーマの値を自動生成します。 B2B 名前空間とスキーマを作成する前に、まず B2B 名前空間とスキーマに入力する必要があります Marketo ソース接続とデータフロー。
  • ソース:Experience Platform を使用すると、データを様々なソースから取得しながら、Platform サービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。
  • Experience Data Model(XDM):Adobe Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
  • ID 名前空間:ID 名前空間は Identity Service のコンポーネントで、ID の関連先コンテキストのインジケーターとして機能します。完全修飾 ID には、ID 値と名前空間が含まれます。
  • Real-Time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
  • サンドボックス:Experience Platform は、単一の Platform インスタンスを個別の仮想環境に分割する仮想サンドボックスを提供し、デジタル体験アプリケーションの開発および進化を支援します。

必要な資格情報の収集

Platform で Marketo アカウントにアクセスするには、次の値を指定する必要があります。

資格情報 説明
munchkinId Munchkin ID は、特定の Marketo インスタンスの一意の ID です。
clientId Marketo インスタンスの一意のクライアント ID。
clientSecret Marketo インスタンスの一意のクライアント秘密鍵。

これらの値の取得について詳しくは、Marketo 認証ガイドを参照してください。

必要な資格情報を収集したら、次の節の手順に従います。

Marketo アカウントの接続

Platform UI の左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。

画面の左側にあるカタログから適切なカテゴリを選択することができます。または、検索バーを使用して、利用したい特定のソースを見つけることもできます。

アドビアプリケーションカテゴリ内で「Marketo Engage」を選択します。次に「データの追加」を選択して、新しい Marketo データフローを作成します。

カタログ

Marketo Engage アカウントの接続​ページが表示されます。このページでは、新しいアカウントを使用するか、既存のアカウントにアクセスできます。

既存のアカウント

既存のアカウントでデータフローを作成するには、「既存のアカウント」を選択して、使用したい Marketo アカウントを選択します。「次へ」を選択して次に進みます。

既存

新しいアカウント

新しいアカウントを作成する場合は、「新しいアカウント」を選択します。表示される入力フォームで、アカウント名、説明(オプション)、Marketo の認証資格情報を入力します。完了したら、「 ソースへ接続」を選択し、新しい接続が確立されるまでしばらく待ちます。

new

データセットの選択

Marketo アカウントを作成したら、次の手順では Marketo のデータセットを調べるためのインターフェースを利用できます。

インターフェイスの左半分はディレクトリブラウザーで、Marketo データセットが 10 種類表示されています。Marketo ソース接続を完全に機能させるには、9 種類の異なるデータセットを取り込む必要があります。また、 Marketo Account-Based Marketing(ABM)機能を使用する場合は、10 個目のデータフローを作成して指定顧客のデータセットを取り込む必要があります。

メモ

説明を簡潔にするために、以降のチュートリアルでは商談を例として使用しますが、以下で説明する手順は 10 種類の Marketo データセットのいずれにも該当します。

最初に取り込むデータセットを選択したら「次へ」を選択します。

select-data

データフローの詳細を入力

データフロー詳細ページでは、既存のデータセットと新しいデータセットのどちらを使用するかを選択できます。このプロセスでは、プロファイルデータセット、エラー診断、部分取り込み、およびアラートの設定も指定できます。

dataflow-details

データを既存のデータセットに取り込むには、既存のデータセット​を選択します。「詳細検索」オプションを使用するか、ドロップダウンメニューで既存のデータセットのリストをスクロールすると、既存のデータセットを取得できます。データセットを選択したら、データフローの名前と説明を入力します。

existing-dataset

データを新しいデータセットに取り込むには、「新しいデータセット」を選択して、出力データセット名とオプションの説明を入力します。次に、「詳細検索」オプションを使用するか、ドロップダウンメニューで既存のスキーマのリストをスクロールして、マッピングするスキーマを選択します。スキーマを選択したら、データフローの名前と説明を指定します。

new-dataset

Profile とエラー診断の有効化

次に、 プロファイルデータセット​切り替えスイッチを選択して、Profile のデータセットを有効にします。これにより、エンティティの属性と動作の全体像を把握できます。Profile が有効化されたすべてのデータセットのデータは Profile に含まれ、変更はデータフローを保存するときに適用されます。

エラー診断は、データフローで発生するエラーレコードに対して、詳細なエラーメッセージ生成を有効にします。部分取り込みでは、手動で定義した特定のしきい値に到達するまで、エラーを含むデータを取り込むことができます。詳しくは、バッチ取り込みの概要を参照してください。

重要

The Marketo ソースは、バッチ取り込みを使用してすべての履歴レコードを取り込み、リアルタイム更新にストリーミング取り込みを使用します。 これにより、誤ったレコードを取り込みながら、ソースのストリーミングを続行できます。 部分取り込み​切り替えスイッチを有効化して、エラーしきい値 % を最大にし、データフローが失敗するのを防ぎます。

profile-and-errors

アラートの有効化

アラートを有効にすると、データフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用したソースアラートの購読についてのガイドを参照してください。

データフローへの詳細の入力を終えたら「次へ 」を選択します。

アラート

会社のデータを取り込む際に、要求されていないアカウントをスキップ

データフローを作成して会社のデータセットからデータを取り込む場合、 要求されていないアカウントの除外 を使用して、取り込みから要求されていないアカウントを除外するか、含めます。

個人がフォームに入力する場合、 Marketo は、他のデータを含まない会社名に基づいて仮想勘定レコードを作成します。 新しいデータフローの場合、要求されていないアカウントを除外する切り替えは、デフォルトで有効になっています。 既存のデータフローの場合、機能を有効または無効にできます。変更は既存のデータではなく、新しく取り込んだデータに適用されます。

未請求のアカウント

Marketo データセットのソースフィールドをターゲットの XDM フィールドにマッピング

マッピング手順が表示され、ソーススキーマのソースフィールドを、ターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが提供されます。

各 Marketo データセットには、従うべき固有のマッピングルールがあります。Marketo データセットを XDM にマッピングする方法について詳しくは、次を参照してください。

必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッピングインターフェイスの使用に関する包括的な手順については、データ準備 UI ガイドを参照してください。

マッピング

マッピングセットの準備が整ったら「 次へ」を選択し、新しいデータフローが作成されるまでしばらく待ちます。

データフローのレビュー

レビュー​手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。

  • 接続:ソースのタイプ、選択したソースエンティティの関連パス、およびそのソースエンティティ内の列の数を表示します。
  • データセットの割り当てとフィールドのマッピング:ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。

データフローをレビューしたら、「保存して取り込み」を選択し、データフローが作成されるまでしばらく待ちます。

レビュー

データフローの監視

データフローを作成したら、そのデータフローを通じて取り込まれるデータをモニターすると、取り込み速度、成功、エラーに関する情報を確認できます。データフローのモニター方法について詳しくは、UI でのデータフローのモニタリングを参照してください。

属性の削除

データセット内のカスタム属性は、過去にさかのぼって非表示にしたり削除したりすることはできません。既存のデータセットのカスタム属性を非表示または削除する場合は、そのカスタム属性がない新しいデータセットと、新しい XDM スキーマを作成し、作成した新しいデータセット用に新しいデータフローを構成する必要があります。また、非表示または削除するカスタム属性があるデータセットを含む、元のデータフローを無効または削除する必要があります。

データフローの削除

不要になったデータフローや誤って作成されたデータフローは、データフローワークスペース内にある​削除​機能で削除できます。データフローの削除方法について詳しくは、UI でのデータフローの削除のチュートリアルを参照してください。

次の手順

このチュートリアルでは、Marketo データを取り込むためのデータフローを正常に作成しました。これで、Real-Time Customer Profile や Data Science Workspace などのダウンストリームの Platform サービスで受信データを使用できるようになりました。詳しくは、次のドキュメントを参照してください。

付録

以下の節では、 Marketo ソース。

UI のエラーメッセージ

Platform が設定に関する問題を検出すると、UI に次のエラーメッセージが表示されます。

Munchkin ID は適切な組織にマッピングされていません

次の場合、認証は拒否されます: Munchkin ID は、使用している Platform 組織にマッピングされていません。 次の間のマッピングを設定します: Munchkin ID および組織が Marketo インターフェイス.

MarketoインスタンスがAdobe組織に正しくマッピングされていないことを示すエラーメッセージ。

プライマリID がありません

プライマリ ID が見つからない場合、データフローの保存と取り込みに失敗します。 以下を確認します。 XDM スキーマ内にプライマリ ID が存在する(データフローを設定する前に)を含める必要があります。

XDM スキーマにプライマリ ID がないことを示すエラーメッセージ。

このページ