# Marketo Import Integration

[Marketo Export Integrationの詳細はこちら](/ja/int/marketo-export-integration)。

Marketoデータを Treasure Data にインポートできます。Treasure Data では、このデータを他のデータソースと統合できます。また、CLI を使用してインポートすることもできます（[Marketo Import Connection Using CLI](/ja/int/marketo-import-connection-using-cli) を参照）。

Bulk extract ソースは Marketo Bulk Extract API を使用してインポートされます。

Marketo データのインポートに関するサンプルワークフローについては、[Treasure Boxes](https://github.com/treasure-data/treasure-boxes/tree/master/td_load/marketo) を参照してください。

## 前提条件、制限事項、および要件

- Treasure Data の基本的な知識。
- 1日あたり500MBのBulk Extract の日次クォータがあります。制限に達した場合は、インポート日付範囲を減らすか、Marketo アカウントマネージャーに連絡して追加容量を購入することをお勧めします。
- Marketo は、アクティビティ日から90日間は大量のアクティビティデータを保持し、その他のすべてのアクティビティデータはアクティビティ日から少なくとも25か月間保持します。詳細については、Marketo の[Activities Data Retention Policy document](http://info.marketo.com/uCb200AYbv0m6M02g5rHG60) を参照してください。


## Treasure Data Integration の静的 IP アドレス

セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。

リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります:
[https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/](https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/)

## Marketo Munchkin アカウント情報の取得

API にアクセスする前に、API 対応アカウントへのアクセスが必要です。Munchkin Account ID は Marketo Admin ページから取得できます。

API アクセス用の新しいアカウントを有効化して作成するには：

1. [API Only User](http://docs.marketo.com/display/public/DOCS/Create+an+API+Only+User) を作成します。
2. [API Only User Role](http://docs.marketo.com/display/public/DOCS/Create+an+API+Only+User+Role) を作成します。
3. Custom Object API name を取得します。


![](/assets/image-20191021-162634.68baf1e088bfdce371ad8ae676cd179cb75d9070ee469184b9f15939784f991a.2ab18ed8.png)
4. Custom Object field name を取得します。

![](/assets/image-20191021-162625.a58bb0835146cffed821ad9b5d9bc5b2d6a98c5499fb93f2e0a514ffbd71272f.2ab18ed8.png)

## TD Console 経由で Marketo からインポート

### 認証の作成

最初のステップは、認証情報のセットを使用して新しい認証を作成することです。

1. **Integrations Hub** を選択します。
2. **Catalog** を選択します。


![](/assets/integrationshub-catalog2.e33c0a4c7d81c40cc83dd056c2143b97b1406220e213cab14ef349d69412ffef.7705d4c2.png)
3. Catalog で Integration を検索し、アイコンにマウスを合わせて **Create Authentication** を選択します。

![](/assets/marketoimportexport.b7ca6a82a518ad841c1b95328091c8b6bf21b7ba895cbc69d790d06f7c415fd3.2ab18ed8.png)
4. **Credentials** タブが選択されていることを確認し、インテグレーションの認証情報を入力します。

![](/assets/marketonewauth.10cabd055fb69ad5f6d83c6abf5b6631f5d91386f30130c23508fe94979cbb88.7705d4c2.png)

**新しい認証フィールド**

| Parameter | Description |
|  --- | --- |
| Marketo Account ID (required) | これは Marketo Service/Munchkin ID です。 |
| Marketo Client ID (required) | これはサービス固有のクライアント ID です。 |
| Marketo Client Secret (required) | これはサービス固有のクライアントシークレットです。 |


1. **Continue** を選択します。
2. 認証の名前を入力し、**Done** を選択します。


### ソースの作成

1. TD Console を開きます。
2. **Integrations Hub** > **Authentications** に移動します。
3. 新しい認証を見つけて、**New Source** を選択します。


Create Source モーダルが開きます。

#### 接続の作成

1. Data Transfer フィールドに名前を入力します。


![](/assets/image-20200615-061442.fb27a68e873df862b2628695eb1d11179d5544effeed13df33425e5f5bd75537.2ab18ed8.png)
2. **Next** を選択します。

#### Source Table

1. Source ドロップダウンメニューから、次のいずれかのソースを選択します：


- Leads
- Activities
- Campaigns
- Leads by Static List
- Leads by Program
- Programs
- Custom Object
- Program Members


入力する値は、選択したソースによって異なります：

**Leads**

![](/assets/leads.0ba6526f5b40235f317e25fb8e23aac15ca4f339bebaffb72b6d045e2fd387f7.2ab18ed8.png)

**Activities**

![](/assets/activities.433e1e58e5c352159c58263a51b2ce6919f513bf131abc65a168709e4a163e4a.2ab18ed8.png)

**Campaigns**

![](/assets/campaigns.23695f79808a5d8f4fdcd62e1e0f6ef0bbcb774dc8b30121bd1ef0af65e73518.2ab18ed8.png)

**Leads by Static List**

![](/assets/leadsstaticlist.305cc0183a9fff987b3459142ca42150d796ac64c447c90885c2679c5b79c624.2ab18ed8.png)

**Leads by Program**

![](/assets/leadsprogram.e2f9f7a05608814b6711663e526e33cbfc6b3a8ff42336a903649d8206bb25e0.2ab18ed8.png)

**Programs**

![](/assets/programs.312d75a56056002a26c731d7b4d84892f56c2fc88586e8db6e7c9d5e2fb147df.2ab18ed8.png)

**Custom Object**

![](/assets/customobject.d917e414b9d8b41844695ea677582c1214462f11fea1d1d9445186f1bf8921aa.2ab18ed8.png)

**Program Members**

![](/assets/programmembers.c2ba53a121ec27b4cae826b52e81ab4a19b61b10e4cddb49f62a66455154e3fe.2ab18ed8.png)

| Parameter | Description |
|  --- | --- |
| Incremental | Bulk extract ソースは createdAt フィルターを通じて増分インポート機能をサポートしています。コネクタは、前回のフィルターに基づいて増分モードで実行する際に次の from_date を計算します。例：- 1回目の実行 from_date: 2018-01-01 to_date: 2018-01-11（プラグインによって生成）fetch_days: 10 - 2回目の実行 from_date: 2018-01-11 to_date: 2018-01-21 fetch_days: 10制限事項：– Bulk extract ソースのプレビューはモックデータのみを表示します。 |
| updateAt | updatedAt は、増分読み込みのために更新日に基づいてデータを取得する場合に使用されます。増分なしの updatedAt を使用すると、特定の期間内に更新されたリードを取得できます |
| From Date | 指定された日付以降の `createdAt` または `updatedAt` フィルターを持つデータ。 |
| Fetch Days | `To date` は `From day + Fetch days` を使用して計算されます |
| Escape Character | Marketo CSV ファイルのエスケープ文字 |
| Quote Character | Marketo CSV ファイルの引用符文字 |
| Activity Type IDs | 目的のアクティビティタイプに対応する整数値。 |
| List IDs | 指定された静的リストのメンバーである個人レコードを取得します。結果には、リード リスト ID を含む listId 列が含まれます。オプション。カンマ区切りの List ID、またはフィールドを空白のままにしてすべてのリストをインポートします。 |
| Program IDs | オプション。カンマ区切りの program ID。またはフィールドを空白のままにしてすべてのプログラムをインポートします。 |
| Query By | Tag Type または Date Range でプログラムをクエリします。または、空白のままにしてすべてのプログラムをインポートします。Query By: Tag Type の場合、増分インポートはサポートされないため省略されます。Query By Date Range で増分インポートを選択すると、次回実行の Earliest Updated At と Latest Updated At が前回の範囲に基づいて計算されます。例：- 1回目の実行：Earliest Updated At = 02/01/2018 10:00, Latest Updated At = 02/10/2018 10:00- 2回目の実行：Earliest Updated At = 02/10/2018 10:01, Latest Updated At = 02/20/2018 10:01 |
| API Name | カスタムオブジェクトの API 名 |
| Fields | オプション。カスタムオブジェクトのフィールドの API 名をカンマ区切りで指定します。 |
| Filter Type | 返す必要があるフィールド API 名のカンマ区切りリスト。設定されていない場合、marketoGuid、dedupe Fields、updatedAt、createdAt が返されます。フィルター値をテキスト（カンマ区切り）として、または範囲（From Value から To Value）で入力します。 |
| Input as Text | フィルター値をテキスト（カンマ区切り）として、または範囲（From Value から To Value）で入力します。 |
| Filter Values | 一致するフィールド値のカンマ区切りリスト。 |
| From Value | フィルター開始値。整数のみサポートされます。 |
| To Value | フィルター終了値（オプション）。整数のみサポートされます。設定されていない場合、「From Value」より大きい値を持つレコードのみが返されます。300の連続する値でレコードが見つからない場合、ジョブは停止します。 |
| Program IDs | オプション。カンマ区切りの program ID、またはフィールドを空白のままにしてすべてのプログラムのメンバーをインポートします。 |


1. **Next** を選択します。


#### Data Settings

1. オプションで、データ設定を編集するか、このページをスキップします。


![](/assets/image-20200615-145146.59b6dc2b4dcb55028d836a33e4b88250a523414fb660c928ff4d86a40f69a05d.2ab18ed8.png)

| **Parameters** | **Description** |
|  --- | --- |
| LEAD INCLUDED FIELDS | データインポートに含める Lead フィールドのリストを追加します。これは Lead ファミリーターゲットにのみ影響します |
| Interval limit in milliseconds | リクエストが Marketo の同時実行制限に達した場合に次の呼び出しを待機する時間 |
| Maximum retries | エラーが発生した場合に Marketo リクエストを再試行する最大回数。 |
| Batch size | Marketo REST API のバッチサイズ（デフォルト300）。 |
| Max return | 1回のリクエストで返す最大レコード数。プログラムエンドポイントはページングにオフセットを使用します（デフォルト200）。 |
| Bulk job timeout in seconds | ジョブを失敗させる前に bulk extract を待機する合計時間 |
| Bulk job polling interval in seconds | ジョブステータスをポーリングする間隔 |
| Read timeout in milliseconds | Marketo のレスポンスを待機する時間 |


### Data Preview

インポートを実行する前に、Generate Preview を選択してデータの[プレビュー](/products/customer-data-platform/integration-hub/batch/import/previewing-your-source-data)を表示できます。Data preview はオプションであり、選択した場合はダイアログの次のページに安全にスキップできます。

1. **Next** を選択します。Data Preview ページが開きます。
2. データをプレビューする場合は、**Generate Preview** を選択します。
3. データを確認します。


### Data Placement

データの配置について、データを配置したいターゲット database と table を選択し、インポートを実行する頻度を指定します。

1. **Next** を選択します。Storage の下で、インポートされたデータを配置する新しい database を作成するか、既存の database を選択し、新しい table を作成するか、既存の table を選択します。
2. **Database** を選択 > **Select an existing** または **Create New Database** を選択します。
3. オプションで、database 名を入力します。
4. **Table** を選択 > **Select an existing** または **Create New Table** を選択します。
5. オプションで、table 名を入力します。
6. データをインポートする方法を選択します。
  - **Append** (デフォルト) - データインポートの結果は table に追加されます。
table が存在しない場合は作成されます。
  - **Always Replace** - 既存の table の全体の内容をクエリの結果出力で置き換えます。table が存在しない場合は、新しい table が作成されます。
  - **Replace on New Data** - 新しいデータがある場合のみ、既存の table の全体の内容をクエリの結果出力で置き換えます。
7. **Timestamp-based Partition Key** 列を選択します。
デフォルトキーとは異なるパーティションキーシードを設定したい場合は、long または timestamp 列をパーティショニング時刻として指定できます。デフォルトの時刻列として、add_time フィルターで upload_time を使用します。
8. データストレージの **Timezone** を選択します。
9. **Schedule** の下で、このクエリを実行するタイミングと頻度を選択できます。


#### 一度だけ実行

1. **Off** を選択します。
2. **Scheduling Timezone** を選択します。
3. **Create & Run Now** を選択します。


#### 定期的に繰り返す

1. **On** を選択します。
2. **Schedule** を選択します。UI では、*@hourly*、*@daily*、*@monthly*、またはカスタム *cron* の 4 つのオプションが提供されます。
3. **Delay Transfer** を選択して、実行時間の遅延を追加することもできます。
4. **Scheduling Timezone** を選択します。
5. **Create & Run Now** を選択します。


転送が実行された後、**Data Workbench** > **Databases** で転送の結果を確認できます。