Selligent Export Integration

このインテグレーションは、Treasure AIからSelligentの静的セグメントに直接データをアップロードすることができます。Selligentは、オーディエンスのセグメンテーションとキャンペーンのアクティベーションのためのオムニチャネルマーケティング自動化プラットフォームです。

Selligent exportインテグレーションは、レコードをSelligentのマスターリストにロードしてから、それらのレコードを1つ以上の静的セグメントに割り当てます。ターゲットセグメントは、各行のselligent_segment列、または設定した別の列によって決定されます。

• Treasure AIの基本的な知識。
• Selligentのリスト、静的セグメント、API名の基本的な知識。
• SelligentのAPIキーとAPIシークレット。
• SelligentのベースURL（例：EUリージョンの場合はhttps://customer.slgnt.eu、USリージョンの場合はhttps://customer.slgnt.us）。
• Selligentの組織識別子。
• ターゲットリストのAPI名。Treasure AIにリストを作成させたい場合は、create_list_if_not_existsを有効にします。
• 重複排除のためにレコードを一意に識別するキーフィールド（例：CUSTOMER_IDENTIFIERまたはEMAIL）。

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

リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります: IP Addresses for Integrations

• このインテグレーションはSelligentの静的セグメントのみをサポートします。
• インテグレーションは常に最初にマスターリストにレコードをロードし、その後ターゲットセグメントにレコードをロードします。
• クエリ結果に設定されたセグメントルーティング列に複数の値が含まれている場合、1回のエクスポート実行で複数のセグメントに書き込むことができます。
• セグメントルーティング列はSelligentフィールドとして送信されません。
• 既存のリストにエクスポートする場合、すべての入力フィールドがそのリストに既に存在している必要があります。フィールドが見つからない場合、エクスポートは設定エラーで失敗します。
• インテグレーションはマスターリストからレコードを削除しません。replaceモードでは、新しいセグメントデータをロードする前にセグメントのメンバーシップをクリアします。
• Selligentのレート制限レスポンスとサーバーエラーは再試行されます。その他の4xxレスポンスは、通常、認証または設定の問題を示すため、高速に失敗します。

Treasure AIでは、クエリを実行する前にデータ接続を作成して設定する必要があります。データ接続の一部として、Selligentにアクセスするための認証を提供します。

1. TD Consoleを開きます。
2. Integrations Hub > Catalogに移動します。
3. Catalogの右端にある検索アイコンをクリックして、Selligentと入力します。
4. Selligentコネクタにカーソルを合わせて、Create Authenticationを選択します。

New Authenticationダイアログが開きます。

1. SelligentのBase URLを入力します。

• EUリージョン：https://customer.slgnt.eu
• USリージョン：https://customer.slgnt.us

6. SelligentのAPI Keyを入力します。
7. SelligentのAPI Secretを入力します。
8. 接続の名前を入力します。
9. Continueを選択します。

インテグレーションを設定するには：

1. TD Consoleを開きます。
2. Data Workbench > Queriesに移動します。
3. New Queryをクリックしてクエリを作成するか、エクスポートしたい保存済みクエリを開きます。
4. クエリエディタの上部で、Export Resultsを選択します。
5. 作成したSelligent認証を選択します。
6. エクスポートパラメータを設定します。

インテグレーションは2段階のロードプロセスを使用します：

1. リストロード：インテグレーションは、バッチ内のすべての有効なレコードを、重複排除のためにkey_fieldsを使用してSelligentリストにアップサートします。
2. セグメントロード：インテグレーションは、設定されたセグメントルーティング列でレコードをグループ化し、各グループを一致する静的セグメントにロードします。

セグメントルーティング列は必須です。その列の各値は、ターゲットセグメントのapi_nameと一致する必要があります。skip_invalid_recordsがtrueの場合、セグメント値がnullまたは空白の行はスキップされます。

create_list_if_not_existsがtrueの場合、インテグレーションはセグメントルーティング列を除くTreasure AIクエリ結果スキーマからSelligentフィールドを作成します。

この例では、アクティブな顧客をactive_customersという名前の単一のSelligentセグメントにエクスポートします。

SELECT
  'active_customers' AS selligent_segment,
  customer_id AS customer_identifier,
  email AS email,
  first_name AS first_name,
  last_name AS last_name
FROM customers
WHERE status = 'active'
  AND email IS NOT NULL

サンプルクエリ結果

必要な設定

Selligentでは、インテグレーションはフィールドをCUSTOMER_IDENTIFIER、EMAIL、FIRST_NAME、LAST_NAMEとして送信します。

この例では、ビジネスロジックに基づいて顧客を異なるSelligentセグメントにルーティングします。VIP顧客はvip_customersに、休眠顧客はre_engagementに、その他の顧客はstandard_customersに送信されます。

SELECT
  CASE
    WHEN lifetime_value >= 1000 THEN 'vip_customers'
    WHEN last_purchase_at < CURRENT_TIMESTAMP - INTERVAL '180' DAY THEN 're_engagement'
    ELSE 'standard_customers'
  END AS selligent_segment,
  customer_id AS customer_identifier,
  email AS email,
  first_name AS first_name,
  lifetime_value AS lifetime_value,
  last_purchase_at AS last_purchase_at
FROM customer_profile
WHERE email IS NOT NULL
  AND opt_in_email = true

サンプルクエリ結果

必要な設定

インテグレーションは、最初にすべての有効な行をmaster_contactsにロードします。その後、バッチ内の各一意のセグメント値（vip_customers、re_engagement、standard_customers）に対して1回のセグメントロードを実行します。

Scheduled JobsをResult Exportと共に使用して、定期的に出力結果をSelligentに書き込むことができます。

Treasure AIのスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートします。

Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。

Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。

2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。

例えば、cron スケジュールが '0 0 1 * 1' の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。

1. Data Workbench > Queries に移動します

2. 新しいクエリを作成するか、既存のクエリを選択します。

3. Schedule の横にある None を選択します。

4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:

   ドロップダウン値	説明
   Custom cron...	Custom cron... の詳細を参照してください。
   @daily (midnight)	指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。
   @hourly (:00)	毎時 00 分に実行します。
   None	スケジュールなし。

 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- day of week (0 - 6) (Sunday=0)
 |    |    |    +---------- month (1 - 12)
 |    |    +--------------- day of month (1 - 31)
 |    +-------------------- hour (0 - 23)
 +------------------------- min (0 - 59)

次の名前付きエントリを使用できます:

• Day of Week: sun, mon, tue, wed, thu, fri, sat.
• Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.

各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます:

1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。

(オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。

1. Audience Studio に移動します。
2. parent segment を選択します。
3. ターゲット segment を開き、右クリックして、Create Activation を選択します。
4. Details パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。
5. Output Mapping パネルで activation 出力をカスタマイズします。

• Attribute Columns
  • Export All Columns を選択すると、変更を加えずにすべての列をエクスポートできます。
  • + Add Columns を選択して、エクスポート用の特定の列を追加します。Output Column Name には、Source 列名と同じ名前があらかじめ入力されます。Output Column Name を更新できます。+ Add Columns を選択し続けて、activation 出力用の新しい列を追加します。
• String Builder
  • + Add string を選択して、エクスポート用の文字列を作成します。次の値から選択します:
    • String: 任意の値を選択します。テキストを使用してカスタム値を作成します。
    • Timestamp: エクスポートの日時。
    • Segment Id: segment ID 番号。
    • Segment Name: segment 名。
    • Audience Id: parent segment 番号。

6. Schedule を設定します。

• スケジュールを定義する値を選択し、オプションでメール通知を含めます。

7. Create を選択します。

Treasure Workflowでは、データコネクタを使用してデータをエクスポートすることを指定できます。

詳細については、TD Toolbeltを使用してワークフローでデータをエクスポートするを参照してください。

サンプルワークフロー設定

timezone: UTC

_export:
  td:
    database: sample_datasets

+td-result-into-selligent:
  td>: queries/selligent_export.sql
  result_connection: selligent
  result_settings:
    organization: my_org
    list_api_name: master_contacts
    create_list_if_not_exists: false
    list_data_import_option: InsertAndUpdate
    segment_column: selligent_segment
    create_segment_if_not_exists: true
    segment_data_import_option: append
    key_fields: CUSTOMER_IDENTIFIER
    deduplication: ImportLastMatch
    error_handling: ContinueOnError
    mode: Sync
    skip_invalid_records: true

• Selligent SMC V1 APIドキュメント