Skip to content

アプリケーション内で をクリックすると、お使いのDataRobotバージョンに関する全プラットフォームドキュメントにアクセスできます。

Data Prep用のMarketoコネクター

ユーザーペルソナ:Data PrepユーザーまたはMarketo管理者



備考

この文書は、コネクターの設定中に利用できるすべての構成フィールドについて論じています。一部のフィールドは、設定の以前の手順で管理者によってすでに入力されている場合があり、表示されない場合があります。Data Prepのコネクターフレームワークの詳細については、Data Prepコネクターのセットアップを参照してください。また、管理者がデータソースのリストでこのコネクターに別の名前を付けている場合もあります。

Data Prepの設定

このコネクターを使用すると、インポートソースとしてのMarketoに接続できます。次のフィールドを使用して、接続パラメーターを定義します。

一般

  • 名前:UIでユーザーに表示されるデータソースの名前。
  • 説明:UIでユーザーに表示されるデータソースの説明。

ヒント

Data Prepは複数のMarketoアカウントに接続できます。わかりやすい名前を使用すると、ユーザーが適切なデータソースを識別する上で非常に役立ちます。Data Prep SaaSを使用している場合は、Data Prep DevOpsにこのセットの希望の旨をお知らせください。

Marketoの設定

  • Marketo RESTエンドポイント:Marketo REST APIエンドポイント。
  • OAuthクライアントID:MarketoにおけるサービスのクライアントID。
  • OAuthクライアントシークレット:Marketoにおけるサービスのクライアントシークレット。
  • タイムアウト:タイムアウトエラーによって、実行中の操作が取り消されるまでの待機時間(秒単位)。デフォルトは60秒ですが、ほとんどの場合、これで十分です。

Webプロキシ

プロキシサーバーを介してMarketo に接続する場合、これらのフィールドでプロキシの詳細を定義します。

  • Webプロキシ:プロキシが不要な場合は「なし」、プロキシサーバー経由でMarketo RESTエンドポイントに接続する場合は「プロキシ」。Webプロキシサーバーが必要な場合、プロキシ接続を有効にするには以下のフィールドが必要です。

  • プロキシホスト:Webプロキシサーバーのホスト名またはIPアドレス。

  • プロキシポート:データソースのプロキシサーバー上のポート。

  • プロキシユーザー名:プロキシサーバーのユーザー名。

  • プロキシパスワード:プロキシサーバーのパスワード。

ヒント

認証されていないプロキシ接続では、ユーザー名とパスワードを空白のままにします。

Marketoの設定

MarketoコネクタはMarketo RESTAPIとOAuthを活用します。このステップは、Marketo管理者が行う必要があります。

接続を確立するには、Marketo管理者は次のことを行う必要があります。

  • Marketoで「カスタムサービス」を作成します。
  • 「カスタムサービス」のOAuthクレデンシャルを取得して、Marketoにアクセスしているクライアント(Data Prepコネクタ)を識別します。

Marketoでの「カスタムサービス」の作成

REST APIを使用してMarketoに接続するには、カスタムサービスが必要です。以下の手順に従って、カスタムサービスを作成します。

  1. Marketoアプリケーションの管理者領域に移動します。
  2. セキュリティセクションのユーザーとロールをクリックします。
  3. ロールタブを選択し、新しいロールをクリックして新しいロールを作成します。
  4. ロールの名前を入力し、ロールの権限を選択します。アクセスAPI権限はREST APIに固有です。
  5. APIロールが作成されたので、[ユーザー]タブを選択して新しいユーザーを招待するをクリックします。
  6. 新しいユーザー情報を入力し、APIアクセスで作成されたばかりのロールを選択します。[APIのみ]オプションを選択して、ユーザーをAPIのみのユーザーとして示すことができます。
  7. 新しいユーザーが作成されたので、新しいサービスを作成する必要があります。LaunchPointオプション(管理 > インテグレーション > LaunchPoint)をクリックします。
  8. 新しいサービスをクリックします。
  9. カスタムサービスタイプを選択し、表示名と説明を入力します。
  10. 作成したユーザーを選択します。

OAuthClientId値とOAuthClientSecret値を取得します

OAuthClientIdとOAuthClientSecretを取得するには、管理者領域の[LaunchPoint]オプションに移動します。目的のサービスの[詳細の表示]リンクをクリックします。認証資格情報を含むウィンドウが表示されます。

RESTエンドポイントのURLを取得します

RESTエンドポイントは、REST APIセクションの統合->ウェブサービスオプションのMarketo管理領域にあります。Identity Endpointは必要ないことに注意してください。

データインポート情報

ブラウジングおよびSQLクエリー経由

表示されるオブジェクトのリストとSQLクエリーの例については、次の表を参照してください。

Marketoコネクターのデータオブジェクト:

Marketoの一部のオブジェクトは、設定に基づいて存在する場合と存在しない場合があり、500列のインポートのMaximum(最大)値に達する場合があります(これはデフォルト設定です。これが不十分な場合は、Data Prepカスタマーサクセスの連絡先に連絡してください)。以下の表には、SQLクエリーの例もいくつかあります。

要素 説明
アクティビティ Marketo組織のカスタムアクティビティ。
  • Marketo組織に含まれる各カスタムアクティビティは、独自のオブジェクトとして返されます。
  • 各テーブル名の前には「Activity」が付けられ、その後にカスタムアクティビティの名前が続きます。
ActivityBulkExports 過去7日間に作成されたアクティビティエクスポートジョブのリストを返します。
Campaigns Marketo組織のキャンペーン。
Channels Marketo組織のチャネル。
Companies Marketo組織の企業。このオブジェクト

は、ネイティブCRM同期が有効になっていないMarketoサブスクリプションでのみ使用できます。
CustomObjects Marketo組織のカスタムオブジェクト。
Emails Marketo組織への電子メール。
LeadBulkExports 過去7日間に作成されたリードエクスポートジョブのリスト。
LeadPartitions Marketo組織のリードパーティション。
Leads Marketo組織のリードします。

組織のMarketo設定に基づいて、Leadオブジェクトには500を超える列が含まれる場合があります。デフォルトのData Prepライブラリ設定を使用して500を超える列をインポートしようとすると、切り捨てエラーが発生する場合があります。
Lists Marketo組織のリスト。
NamedAccounts Marketo組織の名前付きアカウント。
  • このMarketoオブジェクト、「クエリーの作成」オプションを使用したSQLを使用してのみインポートできます。
  • クエリーには「=」演算子を活用するフィルターを含める必要があります
  • 例:SELECT * FROM NamedAccounts WHERE State='CA'
Opportunities Marketo組織にとっての機会。
  • このテーブルは、ネイティブCRM同期が有効になっていないMarketoサブスクリプションでのみ使用できます。
  • クエリーには「=」演算子を活用するフィルターを含める必要があります。
  • 例:SELECT * FROM Opportunities WHERE State='CA'
OpportunityRoles Marketo組織の機会のロール。
  • このテーブルは、ネイティブCRM同期が有効になっていないMarketoサブスクリプションでのみ使用できます。
  • クエリーには「=」演算子を活用するフィルターを含める必要があります。
  • 例:SELECT * FROM OpportunityRoles WHERE ExternalOpportunityId='Opportunity1'AND LeadId='1'AND Role='MyRole'
Programs Marketo組織向けのプログラム。
  • すべてのプログラムを参照する場合(SELECT *クエリーの実行など)、タグ列とコスト列は返されません。これらの列は、特定のプログラムIDまたは名前でフィルタリングした場合にのみ返されます。
  • この場合、タグとコストの列は返されません:SELECT * FROM Programs
  • この場合、タグ列とコスト列が返されます:SELECT * FROM Programs WHERE Id='1001'
SalesPersons Marketo組織の営業担当者。
  • このテーブルは、SalesPerson APIが有効になっている場合にのみ使用できます。
  • 会社を取得するときは、フィルターを指定する必要があります。有効なフィルターは、Id、ExternalSalesPersonId、またはEmailを含む検索可能な列です。
  • 例: SELECT * FROM SalesPersons WHERE ExternalSalesPersonId='sales@company.com'
タグ Marketo組織のタグ。

更新しました February 22, 2022
Back to top