この機能はベータ版です。詳細については、カスタマーサクセス担当者にお問い合わせください。
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 でデータ接続を作成して設定する必要があります。データ接続の一部として、統合にアクセスするための認証情報を提供します。
TD Console を開きます。
Integrations Hub > Catalog に移動します。
Catalog 画面の右端にある検索アイコンを選択し、Insider と入力します。
Insider のカタログ画像にカーソルを合わせ、Create Authentication を選択します。
必要な認証情報を入力します。
Continue を選択します。
接続の名前を入力します。
Done を選択します。
| フィールド | 説明 |
|---|---|
| API Key | リクエストを認証するには API キーが必要です。トークンの生成については、API Authentication Tokens ガイドを参照してください。必ず「UCD (Unified customer database)」API キーを生成してください。 |
| Partner Name | パートナー名をコピーして貼り付けるには、Inone > Inone Settings > Account Preferences に移動します。 |
TD Console は、データをエクスポートする複数の方法をサポートしています。Data Workbench からデータをエクスポートするには、次の手順を実行します。
- Data Workbench > クエリに移動します。
- 新しいクエリを選択し、クエリを定義します。
- 結果をエクスポートを選択して、データエクスポートを設定します。
- 既存のInsider認証を選択するか、新しい認証を作成します。
- 以下に説明するエクスポートパラメータを設定し、完了を選択します。
次の表は、Insiderエクスポート統合の設定パラメータについて説明しています。
| フィールド | 説明 |
|---|---|
| Export Mode |
|
| Attribute Operation | User Attributesエクスポートモードでは、サポートされている属性操作モードのいずれかを選択します:
|
Audiences Operation | User Audienceエクスポートモードでは、3つの異なるオプションでユーザーのオーディエンスリストを管理できます:
これらのオプションにより、ユーザーが関連付けられているオーディエンスリストを柔軟に管理でき、オーディエンスセグメンテーションを正確に制御できます。 |
| Custom Identifier Fields | Custom Identifier Fields設定では、デフォルトの識別子に加えて、すべてのエクスポートモードでカスタム識別子を指定できます:
|
| 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
- デフォルトイベントリスト: Default Events
- すべてのカラム名は小文字で、アンダースコアを含むことができます。
- すべてのカラム名は正規表現パターン
^[a-z][a-z0-9_]*$に一致する必要があります。
- 要件: クエリデータカラムにデフォルトデータスキーマ(デフォルトユーザー属性、デフォルトイベント、デフォルトイベントパラメータ)の一部ではないフィールドが含まれている場合、それらはカスタムユーザー属性(User Attributesエクスポートモードの場合)およびカスタムイベントパラメータ(User Eventsエクスポートモードの場合)としてInsider GMPに同期されます。
- 要件: User Audienceエクスポートモードを使用する場合、同期に使用できるデフォルト属性は2つのみです:
td_audience_id(数値の配列)td_audience_name(文字列の配列)
- 仕様: 両方の属性の長さが等しいことを確認してください。
- 要件: 配列データ型カラム(文字列の配列または数値の配列)の場合、カラム値が正しくフォーマットされていることを確認してください:
- 文字列: 配列を
['a', 'b', 'c']の形式でフォーマットし、各文字列をシングルクォートで囲み、角括弧内でカンマで区切ります。 - 数値: 配列を
[1, 2, 3]の形式でフォーマットし、各数値を角括弧内でカンマで区切ります。
- 文字列: 配列を
- 仕様: この正確な形式により、統合がデータを文字列または数値の配列として正しく解析および解釈できます。フォーマットが正しくない配列は、同期エラーまたはデータの誤解釈を引き起こす可能性があります。
TD Toolbeltを使用して、CLIからクエリ結果のエクスポートをトリガーできます。td queryコマンドの--resultオプションを使用して、エクスポートジョブのパラメータを指定する必要があります。詳細については、この記事を参照してください。
オプションの形式は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}| 名前 | 説明 | 値 | デフォルト値 | 必須 |
|---|---|---|---|---|
| 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でアクティベーションを作成して、セグメントデータをこの統合にエクスポートできます。
- スケジュールジョブと結果エクスポートを使用して、定期的にデータをターゲット送信先にアップロードできます。