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に接続するには、カスタムサービスが必要です。以下の手順に従って、カスタムサービスを作成します。
- Marketoアプリケーションの管理者領域に移動します。
- セキュリティセクションのユーザーとロールをクリックします。
- ロールタブを選択し、新しいロールをクリックして新しいロールを作成します。
- ロールの名前を入力し、ロールの権限を選択します。アクセスAPI権限はREST APIに固有です。
- APIロールが作成されたので、[ユーザー]タブを選択して新しいユーザーを招待するをクリックします。
- 新しいユーザー情報を入力し、APIアクセスで作成されたばかりのロールを選択します。[APIのみ]オプションを選択して、ユーザーをAPIのみのユーザーとして示すことができます。
- 新しいユーザーが作成されたので、新しいサービスを作成する必要があります。LaunchPointオプション(管理 > インテグレーション > LaunchPoint)をクリックします。
- 新しいサービスをクリックします。
- カスタムサービスタイプを選択し、表示名と説明を入力します。
- 作成したユーザーを選択します。
OAuthClientId値とOAuthClientSecret値を取得します¶
OAuthClientIdとOAuthClientSecretを取得するには、管理者領域の[LaunchPoint]オプションに移動します。目的のサービスの[詳細の表示]リンクをクリックします。認証資格情報を含むウィンドウが表示されます。
RESTエンドポイントのURLを取得します¶
RESTエンドポイントは、REST APIセクションの統合->ウェブサービスオプションのMarketo管理領域にあります。Identity Endpointは必要ないことに注意してください。
データインポート情報¶
ブラウジングおよびSQLクエリー経由¶
表示されるオブジェクトのリストとSQLクエリーの例については、次の表を参照してください。
Marketoコネクターのデータオブジェクト:¶
Marketoの一部のオブジェクトは、設定に基づいて存在する場合と存在しない場合があり、500列のインポートのMaximum(最大)値に達する場合があります(これはデフォルト設定です。これが不十分な場合は、Data Prepカスタマーサクセスの連絡先に連絡してください)。以下の表には、SQLクエリーの例もいくつかあります。
要素 | 説明 |
---|---|
アクティビティ | Marketo組織のカスタムアクティビティ。
|
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組織の名前付きアカウント。
|
Opportunities | Marketo組織にとっての機会。
|
OpportunityRoles | Marketo組織の機会のロール。
|
Programs | Marketo組織向けのプログラム。
|
SalesPersons | Marketo組織の営業担当者。
|
タグ | Marketo組織のタグ。 |