Marketo

​

Prerequisites

Before obtaining OAuth credentials, you need to create a custom service in Marketo if you do not already have one. This procedure involves creating a new role with REST API privileges, assigning that role to an existing or new user, and then creating a new service.

Note that only users with Admin privileges can create a Custom Service and that the term “service” refers to the entity created to provide OAuth credentials for API access.

Step 1: Create a New Role for API Access

1. Navigate to the Marketo application’s Admin area.

2. Navigate to the Security section.

3. Click Users & Roles.

4. Select the Roles tab.

5. Click New Role.

6. Specify a Role Name and select Role permissions. Specify Access API permissions that are specific to the REST API.

Step 2: Assign or Create a New User for API Access

1. Select the Users tab.

2. To assign the role to a user, click Invite New User.

3. Enter the new user information and assign them the role you just created with REST API access.

4. To denote the user as an API Only user, select the API Only option.

Step 3: Create the New Service

1. Navigate to Admin > Integration and click the LaunchPoint option.

2. Click New Service.

3. Specify the Service Type as Custom.

4. Enter a display name and description for the service.

5. Assign the user you just created to the service.

Once you have a custom service, do the following:

1. Go to the Admin tab.

2. Click the LaunchPoint option.

3. Select the custom service and click View Details. Marketo displays a window that shows the authentication credentials.

4. Copy and paste the Client Id as the OAuthClientId and the Client Secret as the OAuthClientSecret.

​

セットアップガイド

以下の手順で、Marketo をConnect AI アカウントに接続します。

1. Connect AI のダッシュボードからConnections ページを開きます。

2. 右上の + Add Connection をクリックします。

3. 検索フィールドに Marketo と入力し、データソース名をクリックします。

4. 新しいコネクションのBasic Settings タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。

5. Enter your Marketo URL. You can locate this in Admin > Integration > Web Services > REST API. Example values: https://123-abc-456.mktorest.com/ or https://123-abc-456.mktorest.com/rest.

6. Paste the OAuth Client Id you obtained in the prerequisites.

7. Paste OAuth Client Secret you obtained in the prerequisites.

8. (Optional) Set Use Bulk API to True to let it handle bulk requests of certain large datasets.

9. Connect AI Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。

​

詳細について

Connect AI とMarketo の連携の詳細動作については、こちらのページを参照してください。