Skip to content
Products
/
/
/
Configure incremental act...
Last updated

Incremental Activationの設定

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

このガイドでは、セグメント用のIncremental Activationを設定する手順を説明します。差分変更を処理するユーザー定義ワークフローを作成し、宛先プラットフォームで動作するように設定します。

概要

Incremental Activationの設定には、次の3つの主要なステップがあります。

  1. ユーザー定義ワークフローの作成
  2. 必須パラメータの設定
  3. ワークフローの使用

ユーザー定義ワークフローの作成

  1. TD Data Workbench > Workflowsに移動します。
  2. New User-Defined Workflowをクリックします。
  3. Workflow Nameを入力します(例:incremental_activation_meta)。
  4. Workflow TemplateオプションからBlankを選択します。
  5. New Workflowをクリックして作成します。
  6. Project Editorで、以下のワークフローテンプレートをコピー&ペーストします。
timezone: "UTC"
_export:
  params:
    api_endpoint: "https://integrations-gateway.us01.treasuredata.com"
    id_key: "contact_id"
    delta_keys: ["job_title", "status"]
    activation_mappings: [
      {
        "delta_status": "new",
        "connector_field": "mode",
        "connector_field_value": "append"
      }
    ]

# Fetch and execute incremental activation workflow
+fetch_incremental_activation_wf:
  http_call>: "${params.api_endpoint}/integration_workflow/workflows/incremental_activation/fetch"
  method: POST
  headers:
    - Authorization: ${secret:td.apikey}
    - Content-Type: "application/json"
  content_type_override: application/x-yaml
  content: |
    {
      "database": "${activation_actions_db}",
      "source_table": "${activation_actions_table}",
      "id_key": "${params.id_key}",
      "delta_keys": ${JSON.stringify(params.delta_keys)},
      "activation_mappings": ${JSON.stringify(params.activation_mappings)},
      "result_connection_settings": ${result_connection_settings},
      "result_connection_name": "${result_connection_name}"
    }
  retry: true
  1. Saveをクリックしてワークフローを保存します。

必須パラメータの設定

データソースと宛先プラットフォームの要件に合わせて、ワークフローテンプレートのparamsブロックを変更します。

APIエンドポイント

TDサイトに合わせてapi_endpointパラメータを設定します。

TDサイトAPIエンドポイント
UShttps://integrations-gateway.us01.treasuredata.com
EUhttps://integrations-gateway.eu01.treasuredata.com
APhttps://integrations-gateway.ap02.treasuredata.com
JPhttps://integrations-gateway.treasuredata.co.jp

ID Key

id_keyパラメータは、ソーステーブル内の一意識別子列を指定します。この列のデータは、すべてのプロファイルで一意である必要があります。

例:

  • mobile_ad_id (IDFA、MAID)
  • email
  • phone_number
  • td_customer_id

id_key列に重複した値があると、差分計算でエラーが発生します。この列には一意の値のみが含まれていることを確認してください。

設定例:

id_key: "email"

Delta Keys

delta_keysパラメータは、ソーステーブルで変更を確認する列名の配列です。これらの列は、プロファイルが「更新済み」または「変更なし」とマークされるかどうかを決定します。

例:

  • ["job_title", "organization"]
  • ["subscription_status", "tier_level"]
  • ["city", "country", "postal_code"]

空のままにするか指定しない場合は、id_keyの値がデフォルトになります。

設定例:

delta_keys: ["job_title", "subscription_status", "city"]

Activation Mappings

activation_mappingsパラメータは、さまざまなタイプの差分レコードが宛先にどのように送信されるかを定義します。各マッピングは、差分ステータスをコネクタ設定に接続します。

マッピングの設定に関する詳細については、Incremental Activationマッピングを参照してください。

Snowflakeの設定例:

activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "insert"
  },
  {
    "delta_status": "updated",
    "connector_field": "mode",
    "connector_field_value": "merge"
  }
]

Salesforce B2C Commerce Cloudの設定例(フル同期):

activation_mappings: [
  {
    "delta_status": "new",
    "connector_field": "mode",
    "connector_field_value": "append"
  },
  {
    "delta_status": "updated",
    "connector_field": "mode",
    "connector_field_value": "replace"
  }
]

追加パラメータ(スタンドアロンモードのみ)

ワークフローをスタンドアロン(Activation Actionとしてではなく)として実行する場合は、次も指定する必要があります。

  • activation_actions_db: ソースTDデータベース名
  • activation_actions_table: 処理するデータを含むソーステーブル名
  • result_connection_settings: 結果コネクタ設定オブジェクト
  • result_connection_name: コネクタ認証名

スタンドアロン設定例:

_export:
  params:
    api_endpoint: "https://integrations-gateway.us01.treasuredata.com"
    id_key: "email"
    delta_keys: ["status", "tier"]
    activation_mappings: [
      {
        "delta_status": "new",
        "connector_field": "mode",
        "connector_field_value": "append"
      }
    ]
    activation_actions_db: "my_customer_database"
    activation_actions_table: "customer_profiles"
    result_connection_name: "my_snowflake_connection"
    result_connection_settings:
      type: "snowflake"
      database: "MARKETING_DB"
      schema: "PUBLIC"
      table: "CUSTOMER_SEGMENTS"
      mode: "append"

Audience Studio内でActivation Actionとして実行する場合、activation_actions_db、activation_actions_table、result_connection_settings、result_connection_nameパラメータは自動的に入力されます。api_endpoint、id_key、delta_keys、activation_mappingsのみを設定する必要があります。

ワークフローの使用

ワークフローを設定した後、次の2つの方法で使用できます。

Activation Actionとして(推奨)

Audience Studio内でワークフローを使用して、セグメントの差分を自動的にアクティベーションします。

  1. Audience Studio > Segmentsに移動します。
  2. アクティベーションするセグメントを開きます。
  3. Activations > Create activationを選択します。
  4. Detailsタブで、Enable Activation Actionsを有効にします。
  5. 認証を選択し、アクティベーション名を入力します。
  6. Actionsタブで、作成したワークフローを選択します。
  7. アクティベーションのセットアップを完了して保存します。

アクティベーションが実行されると、(設定に基づいて)差分レコードのみが宛先に送信されます。

詳細については、Activation Actionsの設定を参照してください。

スタンドアロンワークフローとして

スケジュールに従ってワークフローを実行し、任意のTDテーブルから差分変更をエクスポートします。

  1. すべての必須パラメータが設定されていることを確認します(activation_actions_db、activation_actions_table、result_connection_settings、result_connection_nameを含む)。
  2. TD Data Workbench > Workflowsに移動します。
  3. Incremental Activationワークフローを開きます。
  4. Runをクリックするか、スケジュールを設定します。

ワークフローは、現在のテーブルデータを前回の実行と比較し、変更のみをエクスポートします。

同時実行ワークフローの回避: Incremental Activationワークフローが使用するテーブルは、操作中にロックされません。同じソーステーブルに対して複数のワークフローを同時に実行するようにスケジュールしないでください。状態の競合が発生し、一貫性のない差分計算が生成される可能性があります。特定のテーブルを一度に1つのワークフローのみで処理するようにしてください。

ワークフロー権限の設定

ワークフローをActivation Actionとして使用するには、適切な権限が設定されていることを確認してください。

  1. Control Panel > Security > Policiesに移動します。
  2. アクティベーションを作成するユーザーにViewおよびRunアクセスを付与するようにワークフロー権限を設定します。

詳細については、ワークフロー権限の設定を参照してください。

設定の確認

ワークフローを作成した後:

  1. 小さなデータセットでテスト: 本番環境で使用する前に、テストセグメントでワークフローを実行します。
  2. 初回実行を確認: 初回実行では、ベースラインを確立するためにすべてのデータ(完全エクスポート)がエクスポートされます。
  3. 後続の実行を確認: 後続の実行では、差分変更のみがエクスポートされるはずです。
  4. アクティベーションログを監視: アクティベーション結果を確認して、正しい数のプロファイルが送信されていることを確認します。

次のステップ

関連トピック

Previous page
Next page