# Insider Export Integration

この機能はベータ版です。詳細については、カスタマーサクセス担当者にお問い合わせください。

Insider Growth Management Platform (GMP) は、統合データを活用して、さまざまなチャネルにわたって高度にパーソナライズされたカスタマージャーニーを作成し提供することをマーケターに可能にします。Insider Export Integration を使用すると、複数のデータタイプを Insider GMP に簡単に同期でき、最新かつ包括的な情報でマーケティング活動を強化できます。同期できるデータタイプは次のとおりです。

- **ユーザー属性**: ユーザーに関する重要な情報（人口統計、嗜好、行動など）。
- **ユーザーイベント**: ユーザーがプラットフォーム全体で実行したアクションとインタラクション。
- **ユーザーセグメント/オーディエンス**: 特定の基準と行動に基づいて分類されたユーザーグループ。


この同期により、Insider GMP の機能を最大限に活用し、より効果的で効率的なマーケティング戦略を推進できます。

このドキュメントでは、Insider GMP Export Integration のセットアップ、設定、使用方法について説明し、Insider GMP とのデータ同期を開始するために必要なすべての情報を提供します。

## 前提条件

- Treasure Data の基本知識
- Insider GMP の基本知識
- Insider Access のログイン認証情報


## 制限事項

- この統合では、バッチリクエストを使用してベンダーへの大量データ転送をサポートしています。リクエストは、以下のいずれかのしきい値に達するまでキューに入れられ、Insider GMP にデータが配信されます。
  - **最大リクエスト数**: 1000
  - **最も古いリクエストからの最大時間**: 10分
  - **リクエストの最大サイズ**: 5 MB
- Insider GMP で許可されるカスタム属性の最大数は 255 です。テナントがこの数に達している場合、新しい属性を同期できません。テナントのデータスキーマから既存の属性を削除するには、Insider GMP のサポートにお問い合わせください。
- カスタムイベントのデータ保持ポリシー: Insider はデフォルトでカスタムイベントを3か月間保存します。つまり、3か月より古いカスタムイベントは、Insider サポートに連絡して TTL を延長しない限り削除されます。3か月より古いカスタムイベントを同期する必要がある場合は、Insider に TTL の延長をリクエストしてください。
- ユーザー属性とイベントパラメータでは、次のデータタイプは許可されていません。
- JSON オブジェクト
- JSON オブジェクトの配列
- ブール値の配列
- 混在型の配列


## 新しい接続の作成

Treasure Data でデータ接続を作成して設定する必要があります。データ接続の一部として、統合にアクセスするための認証情報を提供します。

1. **TD Console** を開きます。
2. **Integrations Hub > Catalog** に移動します。
3. Catalog 画面の右端にある検索アイコンを選択し、**Insider** と入力します。
4. **Insider** のカタログ画像にカーソルを合わせ、**Create Authentication** を選択します。
![](/assets/screenshot-at-jun-19-18-36-03.43c8f82e04d0e836e8d25f0d43d44ea7a8f835c2ba753cc099e1e54e1c123d46.9c62b5b9.png)![](/assets/screenshot-at-jun-19-18-36-55.8f84c20357a4e356131a55b572520ecf7c5522020b7a732469147056074ac34f.9c62b5b9.png)
5. 必要な認証情報を入力します。
![](/assets/screenshot-at-jun-19-18-37-48.49e40821d43f44f930caf057b40cbafc7ee6a75743bff226393db6ea1f3f2754.9c62b5b9.png)
6. **Continue** を選択します。
7. 接続の名前を入力します。
8. **Done** を選択します。


### 認証フィールド

| **フィールド** | **説明** |
|  --- | --- |
| **API Key** | リクエストを認証するには API キーが必要です。トークンの生成については、[API Authentication Tokens](https://academy.useinsider.com/docs/api-authentication-tokens) ガイドを参照してください。必ず「[UCD (Unified customer database)](https://academy.useinsider.com/docs/unified-customer-database-apis)」API キーを生成してください。 |
| **Partner Name** | パートナー名をコピーして貼り付けるには、Inone > Inone Settings > Account Preferences に移動します。 |


## エクスポートクエリの設定

TD Console は、データをエクスポートする複数の方法をサポートしています。Data Workbench からデータをエクスポートするには、次の手順を実行します。

1. **Data Workbench > クエリ**に移動します。
2. **新しいクエリ**を選択し、クエリを定義します。
3. **結果をエクスポート**を選択して、データエクスポートを設定します。
4. 既存の**Insider**認証を選択するか、[新しい認証を作成](/ja/int/insider-export-integration#insideconnect)します。
5. 以下に説明するエクスポートパラメータを設定し、**完了**を選択します。


### 設定パラメータ

次の表は、Insiderエクスポート統合の設定パラメータについて説明しています。

| **フィールド** | **説明** |
|  --- | --- |
| Export Mode | - **User Attributes**を選択すると、デフォルトのユーザー属性とカスタムタイプをInsiderに同期します。
- **User Events**を選択すると、デフォルトイベントとカスタムイベントの両方をInsiderに同期します。
- **User Audiences**を選択すると、ユーザーオーディエンス/ユーザーセグメントをInsiderに同期します。

 |
| Attribute Operation | **User Attributes**エクスポートモードでは、サポートされている属性操作モードのいずれかを選択します:- **Upsert**: 既存の属性を更新するか、新規/既存のユーザープロファイルに新しい特性を作成します。
- **Delete Attributes**: テナントのスキーマから属性を削除せずに、既存のユーザープロファイル属性の値を削除します。
  - **Single Value Fields**: これらはユーザープロファイルから完全に削除されます。
  - **Array Value Fields**: これらのフィールド内の特定の要素が削除されます(部分的に削除)が、属性は残ります。
テナントのスキーマから属性を完全に削除するには、Insider GMPのテクニカルサポートにお問い合わせください。
- **Replace Attributes**: この機能は、指定されたカスタム/デフォルト属性の値の配列全体(文字列または数値)を置き換えます。これは文字列または数値の配列データタイプにのみ適用され、ユーザープロファイルの配列属性の効率的な更新または上書きを可能にします。
- **Delete Identifiers**: このモードは、関連付けられたユーザープロファイルから特定の識別子の値を削除します。ユーザーにリンクされた識別子を効率的に管理および更新するために使用します。
- **Delete PII**: ユーザーの個人識別情報(PII)を削除します:
  - **PII Deletion**: 性別、誕生日、名前、姓、年齢、メール、電話番号、都市、国、UUIDなどの指定されたPIIデータ、およびInsiderのテナントでPIIとしてマークされたその他の属性を削除します。
  - **Identifier Restriction**: ユーザーの最後に残った識別子は削除できません。唯一の識別子がPII(メール、電話番号など)の場合、削除時にユーザーは匿名になります。
このモードは、ユーザーがデータ共有の許可を取り消した場合など、データプライバシー要求に対応する際に有用です。

 |
| Audiences Operation
 | **User Audience**エクスポートモードでは、3つの異なるオプションでユーザーのオーディエンスリストを管理できます:
- **Append**: このオプションは、ユーザーが既に参加している既存のリストに、新しいオーディエンスリストIDまたは名前を追加します。
  - **例**: ユーザーが現在「Audience List A」と「Audience List B」に含まれており、「Audience List C」を追加すると、ユーザーは「Audience List A」、「Audience List B」、「Audience List C」に含まれるようになります。
- **Replace**: このオプションは、ユーザーの現在のオーディエンスリストを新しいリストに置き換えます。
  - **例**: ユーザーが「Audience List A」と「Audience List B」に含まれており、「Audience List C」に置き換えると、ユーザーは「Audience List A」や「Audience List B」には含まれなくなり、「Audience List C」のみに含まれるようになります。
- **Remove**: このオプションは、ユーザーの現在のオーディエンスリストから特定のオーディエンスリストIDまたは名前を削除します。
  - **例**: ユーザーが「Audience List A」、「Audience List B」、「Audience List C」に含まれており、「Audience List B」を削除すると、ユーザーは「Audience List A」と「Audience List C」のみに含まれるようになります。

これらのオプションにより、ユーザーが関連付けられているオーディエンスリストを柔軟に管理でき、オーディエンスセグメンテーションを正確に制御できます。
 |
| Custom Identifier Fields | **Custom Identifier Fields**設定では、デフォルトの識別子に加えて、すべてのエクスポートモードでカスタム識別子を指定できます:- **Custom Identifier Input**: デフォルトの識別子の代わりに、またはデフォルトの識別子に加えて、カスタム識別子を使用する場合は、カスタム識別子のリストを提供する必要があります。
- **Format**: カンマ区切りのリストとしてカスタム識別子を入力します。

 |
| Enable triggering the data stream | このボックスをチェックすると、データ同期プロセスの一部として、Insider GMPのライブセグメントとキャンペーンのトリガーが有効になります。 |
| Skip invalid records | このボックスをチェックすると、検証エラーで失敗したレコードを無視して、統合が同期を継続できるようになります。チェックを外すと、失敗したレコードに遭遇した時点でジョブが停止します。 |


### データエクスポートクエリ定義のためのデータ仕様

データを正常にエクスポートするには、クエリを定義する際に、以下のデータ仕様/要件に従ってください:

#### 識別子

- **要件**: すべてのエクスポートモードで、少なくとも1つの識別子(デフォルトまたはカスタム)が必要です
- **カスタム識別子の使用**: カスタム識別子を有効にするには、以下の手順を実行してください:
  - Insiderのデータスキーマでカスタム属性を定義します。
  - InsiderのIdentity Resolution Settingsで、そのカスタム属性をカスタム識別子として定義します(これを有効にするには、Insiderのサポートへの連絡が必要な場合があります)。
  - **Custom IdentifierFields**設定にカスタム識別子を入力します。


#### デフォルトデータスキーマ

- Insiderは、デフォルトのユーザー属性、デフォルトイベント、デフォルトイベントパラメータのリストを予約しています。これらの命名規則により、Insider GMPのAPIコンタクトとの一貫性と互換性が確保されます。
- **仕様**:
  - カラム名、データ型、データフォーマット、必須フィールドに関するデフォルトデータスキーマの仕様に注意深く従ってください。
  - デフォルトデータスキーマの詳細については、公式ドキュメントを参照してください:
    - デフォルトユーザー属性とデフォルトイベントパラメータ: [Upsert User Data API](https://academy.useinsider.com/docs/upsert-user-data-api)
    - デフォルトイベントリスト: [Default Events](https://academy.useinsider.com/v1/docs/en/default-events)
  - すべてのカラム名は小文字で、アンダースコアを含むことができます。
  - すべてのカラム名は正規表現パターン`^[a-z][a-z0-9_]*$`に一致する必要があります。


#### カスタム属性とカスタムイベントパラメータ

- **要件**: クエリデータカラムにデフォルトデータスキーマ(デフォルトユーザー属性、デフォルトイベント、デフォルトイベントパラメータ)の一部ではないフィールドが含まれている場合、それらはカスタムユーザー属性(User Attributesエクスポートモードの場合)およびカスタムイベントパラメータ(User Eventsエクスポートモードの場合)としてInsider GMPに同期されます。


#### User Audienceエクスポートモード

- **要件**: User Audienceエクスポートモードを使用する場合、同期に使用できるデフォルト属性は2つのみです:
  - `td_audience_id` (数値の配列)
  - `td_audience_name` (文字列の配列)
- **仕様**: 両方の属性の長さが等しいことを確認してください。


#### 配列データ型カラム

- **要件**: 配列データ型カラム(文字列の配列または数値の配列)の場合、カラム値が正しくフォーマットされていることを確認してください:
  - **文字列**: 配列を`['a', 'b', 'c']`の形式でフォーマットし、各文字列をシングルクォートで囲み、角括弧内でカンマで区切ります。
  - **数値**: 配列を`[1, 2, 3]`の形式でフォーマットし、各数値を角括弧内でカンマで区切ります。
- **仕様**: この正確な形式により、統合がデータを文字列または数値の配列として正しく解析および解釈できます。フォーマットが正しくない配列は、同期エラーまたはデータの誤解釈を引き起こす可能性があります。


## (オプション) CLIを使用したエクスポート統合

[TD Toolbelt](https://toolbelt.treasuredata.com/)を使用して、CLIからクエリ結果のエクスポートをトリガーできます。`td query`コマンドの`--result`オプションを使用して、エクスポートジョブのパラメータを指定する必要があります。詳細については、[この記事](https://docs.treasuredata.com/smart/project-product-documentation/querying-and-importing-data-to-treasure-data-from-the-command-line)を参照してください。

オプションの形式はJSONであり、一般的な構造は以下のとおりです。


```
Case: User Attributes{    "type": "insider",    "api_key": "api_key",    "partner_name": "partner_name",    "export_mode": "USER_ATTRIBUTES",    "attribute_operation": "UPSERT",    "custom_identifier_fields": "custom_identifier_1,custom_identifier_2",    "trigger_data_stream": false,    "skip_invalid_records": false}Case: User Events{    "type": "insider",    "api_key": "api_key",    "partner_name": "partner_name",    "export_mode": "USER_EVENTS",    "custom_identifier_fields": "custom_identifier_1,custom_identifier_2",    "trigger_data_stream": false,    "skip_invalid_records": false}Case: User Audiences{    "type": "insider",    "api_key": "api_key",    "partner_name": "partner_name",    "export_mode": "USER_AUDIENCES",    "audience_operation": "APPEND",    "custom_identifier_fields": "custom_identifier_1,custom_identifier_2",    "trigger_data_stream": false,    "skip_invalid_records": false}
```

### CLIパラメータ

| 名前 | 説明 | 値 | デフォルト値 | 必須 |
|  --- | --- | --- | --- | --- |
| type | エクスポートの送信先。 | 文字列: 常に "**insider**" |  | はい |
| api_key | InsiderはAPIコールの検証と処理に認証を使用します。APIキーは、レスポンスを要求するAPIコールを認証するために使用される一意のコードです。 | 文字列 |  | はい |
| partner_name | Insiderで生成されたパートナー名 | 文字列 |  | はい |
| export_mode | エクスポートのモード | 列挙型   - USER_ATTRIBUTES - USER_EVENTS - USER_AUDIENCES | USER_ATTRIBUTES | はい |
| attribute_operation | ユーザー属性の操作 | 列挙型   - UPSERT - DELET_ATTRIBUTES - REPLACE_ATTRIBUTES - DELETE_IDENTIFIERS - DELETE_PII | UPSERT | はい  (*export_mode*が**USER_ATTRIBUTES**の場合) |
| audience_operation | ユーザーオーディエンスの操作 | 列挙型   - APPEND - REPLACE - REMOVE | APPEND | はい  (*export_mode*が**USER_AUDIENCES**の場合) |
| custom_identifier_fields | カスタム識別子フィールド  スペースなしのカンマ区切りの小文字値である必要があります | 文字列 |  | いいえ |
| trigger_data_stream | Insider InOneポータルでリアルタイムキャンペーン/セグメントをトリガーするためのインジケーターフラグ | ブール値 | false | いいえ |
| skip_invalid_records | TD検証またはInsider検証に失敗した無効なレコードをスキップするためのインジケーターフラグ  有効にすると、有効なレコードが提供されなかった場合でもプロセスは成功します。 | ブール値 | false | いいえ |


### 使用例

| No | ケース | 例 |
|  --- | --- | --- |
| 1 | ユーザー属性のアップサート | `td query \--database ${database_name} \--wait "SELECT * FROM ${table_name}" \--type presto \--result '{"type":"insider","api_key":"api_key","partner_name":"partner_name","export_mode":"USER_ATTRIBUTES","attribute_operation":"UPSERT","custom_identifier_fields":"custom_identifier_1,custom_identifier_2","trigger_data_stream":false,"skip_invalid_records":false}'` |
| 2 | ユーザーイベントのアップロード | `td query \--database ${database_name} \--wait "SELECT * FROM ${table_name}" \--type presto \--result '{"type":"insider","api_key":"api_key","partner_name":"partner_name","export_mode":"USER_EVENTS","custom_identifier_fields":"custom_identifier_1,custom_identifier_2","trigger_data_stream":false,"skip_invalid_records":false}'` |
| 3 | ユーザーオーディエンスの追加 | `td query \--database ${database_name} \--wait "SELECT * FROM ${table_name}" \--type presto \--result '{"type":"insider","api_key":"api_key","partner_name":"partner_name","export_mode":"USER_AUDIENCES","audience_operation":"APPEND","custom_identifier_fields":"custom_identifier_1,custom_identifier_2","trigger_data_stream":false,"skip_invalid_records":false}'` |


## (オプション) その他の設定

- **Audience Studio**で[アクティベーションを作成](https://docs.treasuredata.com/smart/project-product-documentation/create-an-activation)して、セグメントデータをこの統合にエクスポートできます。
- [スケジュールジョブ](https://docs.treasuredata.com/articles/pd/scheduling-jobs-using-td-console)と結果エクスポートを使用して、定期的にデータをターゲット送信先にアップロードできます。


#### 外部参照

- [Insider User Data Api Docs](https://academy.useinsider.com/docs/ucd-user-data-apis-overview)