の作成 Marketo Engage UI のソースコネクタ

このチュートリアルでは、 Marketo Engage (以下「」という。)Marketo")B2B データをAdobe Experience Platformに取り込むための UI 内のソースコネクタ

はじめに

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

  • ソース:Experience Platformを使用すると、様々なソースからデータを取り込みながら、Platform サービスを使用して、受信データの構造化、ラベル付け、拡張をおこなうことができます。
  • エクスペリエンスデータモデル (XDM):Experience Platformが顧客体験データを整理する際に使用する標準化されたフレームワーク。
  • ID 名前空間:ID 名前空間は、 Identity Service id が関連するコンテキストのインジケーターとして機能する 完全修飾 ID には、ID 値と名前空間が含まれます。
  • Real-time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
  • サンドボックス:Experience Platform は、単一の Platform インスタンスを別々の仮想環境に分割して、デジタルエクスペリエンスアプリケーションの開発と発展を支援する仮想サンドボックスを提供します。

必要な資格情報の収集

次の項目にアクセスするには、 Marketo プラットフォームのアカウントでは、次の値を指定する必要があります。

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

これらの値の取得について詳しくは、 Marketo 認証ガイド.

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

接続 Marketo アカウント

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

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

以下 Adobe カテゴリ、選択 Marketo Engage. 次に、 データを追加 新しい Marketo データフロー。

カタログ

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

新しいアカウント

新しいアカウントを作成する場合は、「 新しいアカウント. 表示される入力フォームで、アカウント名、オプションの説明および Marketo 認証資格情報。 終了したら、「 」を選択します。 ソースに接続 その後、新しい接続が確立されるまでしばらく時間をかけます。

新規アカウント

既存のアカウント

既存のアカウントでデータフローを作成するには、「 」を選択します。 既存のアカウント 次に、 Marketo アカウントを使用します。 選択 次へ をクリックして続行します。

既存

データセットの選択

作成後、 Marketo アカウントを使用する場合、次の手順で確認できるインターフェイスが表示されます Marketo データセット。

インターフェイスの左半分はディレクトリブラウザで、10 が表示されています。 Marketo データセット。 完全に機能している Marketo ソース接続では、9 つの異なるデータセットを取り込む必要があります。 また、 Marketo アカウントベースマーケティング (ABM) 機能を使用する場合は、次に、10 番目のデータフローを作成して、 特定顧客 データセット。

メモ

簡潔にするために、次のチュートリアルではを使用します。 特定顧客 例として、以下の手順は 10 のいずれかに適用されます。 Marketo データセット。

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

select-data

マップ Marketo スキーマから Platform へ

この マッピング ステップが表示され、マッピングするインターフェイスが提供されます Marketo スキーマを Platform に追加します。

取り込むインバウンドデータのデータセットを選択します。 既存のデータセットを使用するか、新しいデータセットを作成できます。

既存のデータセットを使用する

既存のデータセットにデータを取り込むには、「 」を選択します。 既存のデータセット「 」、「 」の順に選択し、データセットアイコンを選択します。

existing-dataset

この データセットを選択 ダイアログが表示されます。 使用する適切なスキーマのデータセットを見つけ、選択して、「 」を選択します。 確認.

select-existing-dataset

新しいデータセットを使用

データを新しいデータセットに取り込むには、「 新しいデータセット をクリックし、提供されたフィールドにデータセットの名前と説明を入力します。

スキーマの名前を スキーマを選択 検索バー。 ドロップダウンアイコンを選択して、既存のスキーマのリストを表示することもできます。 または、 詳細検索 既存のスキーマの各ページ(それぞれの詳細を含む)にアクセスする。

切り替え プロファイルデータセット ボタンを使用して Profileを使用して、エンティティの属性と動作の全体像を作成できます。 すべてのデータから Profile有効なデータセットは、 Profile および変更は、データフローを保存する際に適用されます。

create-new-dataset

スキーマを選択したら、下にスクロールしてマッピングダイアログを表示し、 Marketo データセットフィールドを適切なターゲット XDM フィールドに設定します。

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

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

選択 データをプレビュー 選択したデータセットに基づいてマッピング結果を確認するには、次の手順を実行します。

マッピング

この プレビュー ポップオーバーには、選択したデータセットから最大 100 行のサンプルデータのマッピング結果を調査するためのインターフェイスが用意されています。

プレビュー

ソースフィールドが適切なターゲットフィールドにマッピングされたら、 閉じる.

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

この データフローの詳細 手順が表示され、新しいデータフローの名前と簡単な説明を指定できます。

データフローの詳細

を有効にします。 エラー診断 を切り替えて、新しく取り込んだバッチに関する詳細なエラーメッセージを生成し、API を使用してダウンロードできます。 詳しくは、 データ取得エラー診断の取得.

エラー

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

部分取り込み は、エラーを含むデータを特定のしきい値まで取り込む機能を提供します。 詳しくは、 部分バッチ取得の概要.

データフローの詳細を指定し、エラーしきい値を「最大」に設定したら、「 」を選択します。 次へ.

部分取り込み

データフローの確認

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

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

データフローをレビューしたら、「 」を選択します。 完了 とは、データフローが作成されるまでしばらく時間をかけます。

レビュー

データフローの監視

データフローを作成したら、そのデータフローを通じて取り込まれるデータを監視して、取り込み率、成功、エラーに関する情報を確認できます。 データフローの監視方法の詳細については、 UI でのデータフローの監視.

属性を削除

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

データフローを削除

不要になったデータフローや、 削除 関数 データフロー ワークスペース。 データフローの削除方法の詳細については、 UI でのデータフローの削除.

次の手順

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

このページ