(ベータ版)UIでのMarketo Engageソースコネクタの作成

重要

Marketo Engageソースは現在ベータ版です。 機能とドキュメントは変更される場合があります。 さらに、ベータプログラム中にコネクタを使用する際は、実稼動以外のサンドボックスを使用する必要があります。 サンドボックスについて詳しくは、サンドボックスのドキュメントを参照してください。

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

はじめに

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

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

必要な資格情報の収集

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

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

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

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

Marketoアカウントに接続する

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

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

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

カタログ

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

新しいアカウント

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

新規アカウント

既存のアカウント

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

既存

データセットの選択

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

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

メモ

簡潔にするため、次のチュートリアルでは、名前付きアカウントを例として使用しますが、以下の手順は10個のMarketoデータセットのいずれかに適用されます。

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

select-data

Marketoスキーマをプラットフォームにマッピングする

マッピング手順が表示され、MarketoスキーマをPlatformにマッピングするためのインターフェイスが表示されます。

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

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

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

existing-dataset

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

select-existing-dataset

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

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

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

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

create-new-dataset

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

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

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

データのプレビュー」を選択し、選択したデータセットに基づいてマッピング結果を表示します。

マッピング

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

プレビュー

ソースフィールドが適切なターゲットフィールドにマッピングされたら、「閉じる」を選択します。

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

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

データフローの詳細

エラー診断 」切り替えを有効にして、新しく取り込んだバッチに関する詳細なエラーメッセージの生成を許可します。このメッセージは、APIを使用してダウンロードできます。 詳しくは、データ取得エラー診断の取得に関するチュートリアルを参照してください。

エラー

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

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

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

部分取得

データフローの確認

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

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

データフローをレビューしたら、「完了」を選択し、データフローの作成にしばらく時間をかけます。

レビュー

データフローの監視

データフローを作成したら、データフローを介して取り込まれるデータを監視して、取り込み率、成功、エラーに関する情報を確認できます。 データフローの監視方法の詳細については、UIでのデータフローの監視に関するチュートリアル()を参照してください。

属性を削除する

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

データフローの削除

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

次の手順

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

このページ