メイン コンテンツをスキップする 補完的コンテンツへスキップ

Marketo 

Marketo is a marketing automation platform. You can use Marketo as a data source when landing or replicating data.

Marketo integration replicates data using the Marketo REST API and Marketo Bulk API.

See the Schema section for a list of objects available for replication.

Preparing for authentication

To access your data, you need to authenticate the connection with your account credentials.

情報メモ使用するアカウントに、フェッチするテーブルへのアクセス権があることを確認してください。

You need administrator permissions in your Marketo account.

To create an API-only user role:

  1. Log into your Marketo account.
  2. Navigate to Admin > Users & Roles.
  3. Click the Roles tab and then New Role.
  4. In the Create New Role window, complete the following fields:
    • Role name: Enter a name for the role. If the role is specific to Qlik Talend Cloud, make that clear in the name, for example QTC API role.
    • Description: Enter a description of the role.
    • Permissions: Select the Access API checkbox.
  5. Click Create.

To create an API-only user:

  1. Log into your Marketo account.
  2. Navigate to Admin > Users & Roles.
  3. Click the Users tab and then Invite New User.
  4. In the Invite New User window, complete the following fields:
    • Email
    • First Name
    • Last Name
  5. Click Next.
  6. In the Permissions section, select the checkboxes for the API user role you created and API Only.
  7. Click Next.
  8. In the Message section, click Send to create the user.

To create an API Custom Service:

  1. Log into your Marketo account.
  2. Navigate to Admin > LaunchPoint.
  3. Click the New tab and then New Service.
  4. In the New Service window, complete the following fields:
    • Display Name: Enter QTC .
    • Service: Select Custom from the drop-down list.
    • Description: Enter a description.
    • API Only User: Select the user you previously created.
  5. Click Create.
  6. In the Installed Services section, click View Details.
  7. Copy and paste your client ID and client secret into a secured file.

IP restrictions may be enabled in Marketo. To verify, go to Admin > Web Services > IP Restrictions. If IP restrictions are not enabled, skip this step.

The IP addresses you must allowlist depend on your Qlik Talend Cloud region and country. For the current list, see Qlik Cloud domains and IP addresses.

To add the Qlik Talend Cloud IP addresses to Marketo’s web services allowlist:

  1. Log into your Marketo account.
  2. In the Integration menu, click Web Services.
  3. In the IP Restrictions section, click Edit.
  4. In Allowed Addresses, paste one IP address for your region.
  5. Repeat the previous step until you have added all required IP addresses for your data pipeline region.
  6. Click Save.

To retrieve the base URLs:

  1. Log into your Marketo account.
  2. Navigate to Web Services > REST API.
  3. Locate the Endpoint and Identity fields.
  4. Copy the URLs.

Creating the connection

詳細については、「SaaSアプリケーションへの接続」を参照してください。

  1. 必要な接続プロパティを入力します。
  2. 接続名に接続の名前を入力します。

  3. 接続メタデータを開くを選択して、作成時の接続のメタデータを定義します。

  4. [作成] をクリックします。

Connection settings
SettingDescription
Data gateway

ユース ケースに応じて Data Movement gateway を選択します。

情報メモ

Qlik Talend Cloud スターター サブスクリプションでは Data Movement gateway をサポートしていないため、この項目は使用できません。別のサブスクリプション ティアを利用しており、Data Movement gateway を使用しない場合は、 [None] (なし) を選択します。

Data Movement gateway の利点とそれを必要とするユース ケースの詳細については、「Qlik データ ゲートウェイ - データ移動」を参照してください。

Start Date

ソースからターゲットにデータをレプリケートする必要がある日付を MM/DD/YYYY 形式で入力します。

Endpoint Base URLEndpoint base URL, for example: https://457-RFG-234.mktorest.com/rest.
Client IDClient ID.
Client SecretClient secret.
Max Daily API CallsMost Marketo subscriptions are allocated 50000 API calls per day.

Schema

情報メモ

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

The schema and info displayed below is for version 2.

Depending on your destination, table and column names may not appear as they are outlined below.

activities

In version 1 of Marketo integration, the activities table contained all data pertaining to lead activities.

In this version, you can choose to replicate lead activity data for specific activity types. For every activity type defined in your Marketo account, you’ll see an activities table in the Tables to Replicate tab. For example: activities_click_email contains lead activity data for the click_email activity type.

These tables will contain the fields listed below, along with any fields specific to that activity type.

Replication Method

CDC

Primary Key

marketoGuid

Replication Key

activityDate

Useful links

Marketo API method

activity_types

The activity_types table contains metadata about the activity types - form fill, web page visit, lead creation, and so on - available in Marketo.

Replication Method

Full Table

Primary Key

id

Useful links

Marketo API method

campaigns

The campaigns table contains info about your Marketo campaigns

Replication Method

CDC

Primary Key

id

Replication Key

updatedAt

Useful links

Marketo documentation

leads

The leads table contains info about your Marketo leads.

The Replication Key for this table varies depending on your Marketo account setup:

  • If updatedAt filtering is enabled, this table will use updatedAt as the Replication Key
  • If updatedAt filtering isn’t enabled, this table will use createdAt as the Replication Key. Additionally, data will be loaded using Append-Only loading.

Read more about replicating this table.

Replication Method

CDC

Primary Key

id

Useful links

Marketo API method

lists

The lists table contains info about the static lists in your Marketo account.

Note: Due to some of the limitations in Marketo API, only static lists will be replicated.

Replication Method

CDC

Primary Key

id

Replication Key

updatedAt

Useful links

Marketo API method

programs

The programs table contains info about your Marketo programs. Programs can be parents to most types of assets in Marketo and allow you to track membership and success of leads.

Replication Method

CDC

Primary Key

id

Replication Key

updatedAt

Useful links

Marketo API method

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。