{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Products","product_name":"Audience Studio","type":"markdown"},"seo":{"title":"Incremental Activation Parameters","description":"Reference for all parameters used in the Incremental Activation workflow template, including API endpoint, ID key, delta keys, and activation mappings.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"incremental-activation-parameters","__idx":0},"children":["Incremental Activation Parameters"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Incremental Activation is a Beta release. For more information, contact your Customer Success Representative."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This reference document describes all parameters used in the Incremental Activation workflow template. Parameters are defined in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["_export.params"]}," block of the workflow configuration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"parameter-overview","__idx":1},"children":["Parameter Overview"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Auto-Populated"},"children":["Auto-Populated"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api_endpoint"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API endpoint to fetch the Incremental Activation workflow"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique identifier column in the source table"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delta_keys"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of columns to check for changes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activation_mappings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of delta record to connector mappings"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activation_actions_db"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (when running as Activation Action)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Source TD database"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activation_actions_table"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (when running as Activation Action)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Source table name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["result_connection_settings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (when running as Activation Action)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Result connector configuration object"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["result_connection_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (when running as Activation Action)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Connector authentication name"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Parameters marked \"Yes\" under \"Auto-Populated\" are automatically set when running as an Activation Action within Audience Studio. When running as a standalone workflow, all conditional parameters must be manually configured."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api_endpoint","__idx":2},"children":["api_endpoint"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Auto-Populated"},"children":["Auto-Populated"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API endpoint URL for fetching the Incremental Activation workflow. The value depends on your Treasure Data site location."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"values-by-td-site","__idx":3},"children":["Values by TD Site"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"TD Site"},"children":["TD Site"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint URL"},"children":["Endpoint URL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["US (us01)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://integrations-gateway.us01.treasuredata.com"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EU (eu01)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://integrations-gateway.eu01.treasuredata.com"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Asia Pacific (ap02)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://integrations-gateway.ap02.treasuredata.com"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Japan (co.jp)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://integrations-gateway.treasuredata.co.jp"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example","__idx":4},"children":["Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"_export:\n  params:\n    api_endpoint: \"https://integrations-gateway.us01.treasuredata.com\"\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"validation","__idx":5},"children":["Validation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Must be a valid HTTPS URL"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Must match your Treasure Data site location"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Incorrect endpoints will cause workflow failures"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"id_key","__idx":6},"children":["id_key"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Auto-Populated"},"children":["Auto-Populated"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The column name that serves as the unique identifier (primary key) for profiles in your source table. This column's data must be unique across all rows."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"purpose","__idx":7},"children":["Purpose"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_key"]}," column is used to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Identify new profiles added to the segment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Identify profiles removed from the segment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Match profiles between activation runs for delta calculation"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"common-values","__idx":8},"children":["Common Values"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_customer_id"]}," - Treasure Data's unified customer ID"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}," - Email address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_number"]}," - Phone number"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mobile_ad_id"]}," - Mobile advertising ID (IDFA, MAID)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_id"]}," - Custom customer identifier"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-1","__idx":9},"children":["Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"_export:\n  params:\n    id_key: \"email\"\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"requirements","__idx":10},"children":["Requirements"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_key"]}," column must contain unique values. Duplicate values will cause errors in delta calculation and may produce incorrect results."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Column must exist in the source table"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Values must be unique (no duplicates)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Values should not be null"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Data type should be consistent (all strings or all numbers)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"best-practices","__idx":11},"children":["Best Practices"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Choose a stable identifier"]},": Select a column that rarely changes. If the ID changes, the profile will appear as \"deleted\" and \"new\" rather than \"unchanged.\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verify uniqueness"]},": Run a query to confirm no duplicate values exist:",{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"SELECT id_key, COUNT(*)\nFROM your_table\nGROUP BY id_key\nHAVING COUNT(*) > 1\n","lang":"sql"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Match destination requirements"]},": If your destination platform requires a specific identifier (e.g., email hash for Meta), ensure your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_key"]}," matches."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delta_keys","__idx":12},"children":["delta_keys"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Auto-Populated"},"children":["Auto-Populated"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of Strings"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An array of column names to check for changes when determining if a profile is \"updated\" or \"unchanged.\" These columns define which attributes trigger an update status."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"purpose-1","__idx":13},"children":["Purpose"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delta_keys"]}," array determines:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Whether a profile is marked as \"updated\" (when any delta key value changes)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Whether a profile is marked as \"unchanged\" (when all delta key values remain the same)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which attribute changes trigger re-activation"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"examples","__idx":14},"children":["Examples"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Track job and organization changes"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"delta_keys: [\"job_title\", \"organization\"]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Track subscription status changes"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"delta_keys: [\"subscription_status\", \"tier_level\"]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Track location changes"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"delta_keys: [\"city\", \"country\", \"postal_code\"]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Track multiple attributes"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"delta_keys: [\"status\", \"tier\", \"email\", \"phone_number\"]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"default-behavior","__idx":15},"children":["Default Behavior"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delta_keys"]}," is empty or not specified, it defaults to the value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_key"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"# These two configurations are equivalent if id_key is \"email\"\ndelta_keys: []\n# becomes\ndelta_keys: [\"email\"]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-delta-keys-work","__idx":16},"children":["How Delta Keys Work"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The workflow calculates a hash of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delta_keys"]}," columns for each profile:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Current Run"]},": Hash of current ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delta_keys"]}," values"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Previous Run"]},": Hash of previous ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delta_keys"]}," values"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Comparison"]},": If hashes differ, profile is marked \"updated\""]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]},":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Run"},"children":["Run"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"email"},"children":["email"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"job_title"},"children":["job_title"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"organization"},"children":["organization"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Delta Keys Hash"},"children":["Delta Keys Hash"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["john@example.com"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Engineer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Acme Corp"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["abc123"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["new"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["john@example.com"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Senior Engineer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Acme Corp"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["def456"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["updated"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["john@example.com"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Senior Engineer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Acme Corp"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["def456"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["unchanged"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"best-practices-1","__idx":17},"children":["Best Practices"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Include relevant attributes only"]},": Don't include columns that change frequently but don't require re-activation (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_login_timestamp"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Consider downstream impact"]},": If your destination charges per data point update, minimize unnecessary delta keys."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Test with representative data"]},": Verify that your delta keys capture the changes you care about without over-triggering."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Document your choices"]},": Record why specific columns were chosen as delta keys for future reference."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"common-patterns","__idx":18},"children":["Common Patterns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["E-commerce - Loyalty tier changes"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"delta_keys: [\"loyalty_tier\", \"points_balance\"]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["B2B - Lead scoring updates"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"delta_keys: [\"lead_score\", \"engagement_level\", \"company_size\"]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Marketing - Preference management"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"delta_keys: [\"email_opt_in\", \"sms_opt_in\", \"preferred_channel\"]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"activation_mappings","__idx":19},"children":["activation_mappings"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Auto-Populated"},"children":["Auto-Populated"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of Objects"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An array of mapping objects that define how delta records are sent to the destination connector. Each mapping connects a delta status to a connector configuration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For detailed information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/audience-studio/activation/incremental-activation-mappings"},"children":["Incremental Activation Mappings"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"structure","__idx":20},"children":["Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each mapping object contains:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delta_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One of: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["new"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updated"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleted"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unchanged"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connector_field"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Connector config field name (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connector_field_value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Value to set (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["append"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delete"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replace"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-2","__idx":21},"children":["Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"activation_mappings: [\n  {\n    \"delta_status\": \"new\",\n    \"connector_field\": \"mode\",\n    \"connector_field_value\": \"append\"\n  },\n  {\n    \"delta_status\": \"updated\",\n    \"connector_field\": \"mode\",\n    \"connector_field_value\": \"append\"\n  },\n  {\n    \"delta_status\": \"deleted\",\n    \"connector_field\": \"mode\",\n    \"connector_field_value\": \"delete\"\n  }\n]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"limits","__idx":22},"children":["Limits"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Maximum of 4 mapping elements (one per delta status type)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delta_status"]}," value should appear only once"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"activation_actions_db","__idx":23},"children":["activation_actions_db"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Auto-Populated"},"children":["Auto-Populated"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (when running as Activation Action)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The name of the source TD database containing the table to process."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-auto-populated","__idx":24},"children":["When Auto-Populated"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When running as an Activation Action within Audience Studio, this parameter is automatically set to the syndication database (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdp_syndication_123"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-required","__idx":25},"children":["When Required"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When running as a standalone workflow, you must specify this parameter manually:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"_export:\n  params:\n    activation_actions_db: \"my_customer_database\"\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"validation-1","__idx":26},"children":["Validation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Database must exist in your Treasure account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User must have appropriate permissions on the database"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"activation_actions_table","__idx":27},"children":["activation_actions_table"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Auto-Populated"},"children":["Auto-Populated"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (when running as Activation Action)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The name of the source table within the database that contains the data to process."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-auto-populated-1","__idx":28},"children":["When Auto-Populated"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When running as an Activation Action within Audience Studio, this parameter is automatically set to the segment syndication table (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["segment_12345"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-required-1","__idx":29},"children":["When Required"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When running as a standalone workflow, you must specify this parameter manually:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"_export:\n  params:\n    activation_actions_table: \"customer_profiles\"\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"validation-2","__idx":30},"children":["Validation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Table must exist in the specified database"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Table must contain the columns specified in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_key"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delta_keys"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User must have read permissions on the table"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"result_connection_settings","__idx":31},"children":["result_connection_settings"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Auto-Populated"},"children":["Auto-Populated"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (when running as Activation Action)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The configuration object for the result export connector. The structure varies depending on the destination connector type."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-auto-populated-2","__idx":32},"children":["When Auto-Populated"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When running as an Activation Action within Audience Studio, this parameter is automatically populated based on your activation configuration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-required-2","__idx":33},"children":["When Required"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When running as a standalone workflow, you must specify the connector configuration manually."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example---snowflake","__idx":34},"children":["Example - Snowflake"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"result_connection_settings:\n  type: \"snowflake\"\n  database: \"MARKETING_DB\"\n  schema: \"PUBLIC\"\n  table: \"CUSTOMER_SEGMENTS\"\n  mode: \"append\"\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example---google-sheets","__idx":35},"children":["Example - Google Sheets"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"result_connection_settings:\n  type: \"google_sheets\"\n  spreadsheet_id: \"1ABC...xyz\"\n  sheet_name: \"Customer List\"\n  mode: \"replace\"\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connector-specific-requirements","__idx":36},"children":["Connector-Specific Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Refer to your destination connector's documentation for required fields and supported values."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"result_connection_name","__idx":37},"children":["result_connection_name"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Auto-Populated"},"children":["Auto-Populated"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (when running as Activation Action)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The name of the connector authentication configured in Treasure Data."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-auto-populated-3","__idx":38},"children":["When Auto-Populated"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When running as an Activation Action within Audience Studio, this parameter is automatically populated based on your activation's selected authentication."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-required-3","__idx":39},"children":["When Required"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When running as a standalone workflow, you must specify the authentication name manually:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"_export:\n  params:\n    result_connection_name: \"my_snowflake_connection\"\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"validation-3","__idx":40},"children":["Validation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authentication must exist in your Treasure account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authentication must be valid and not expired"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User must have permission to use the authentication"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"complete-parameter-examples","__idx":41},"children":["Complete Parameter Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"activation-action-mode","__idx":42},"children":["Activation Action Mode"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only configure user-specified parameters:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"timezone: \"UTC\"\n_export:\n  params:\n    api_endpoint: \"https://integrations-gateway.us01.treasuredata.com\"\n    id_key: \"email\"\n    delta_keys: [\"subscription_status\", \"tier\"]\n    activation_mappings: [\n      {\n        \"delta_status\": \"new\",\n        \"connector_field\": \"mode\",\n        \"connector_field_value\": \"append\"\n      },\n      {\n        \"delta_status\": \"deleted\",\n        \"connector_field\": \"mode\",\n        \"connector_field_value\": \"delete\"\n      }\n    ]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"standalone-mode","__idx":43},"children":["Standalone Mode"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure all parameters:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"timezone: \"UTC\"\n_export:\n  params:\n    api_endpoint: \"https://integrations-gateway.us01.treasuredata.com\"\n    id_key: \"email\"\n    delta_keys: [\"subscription_status\", \"tier\"]\n    activation_mappings: [\n      {\n        \"delta_status\": \"new\",\n        \"connector_field\": \"mode\",\n        \"connector_field_value\": \"append\"\n      },\n      {\n        \"delta_status\": \"updated\",\n        \"connector_field\": \"mode\",\n        \"connector_field_value\": \"append\"\n      }\n    ]\n    activation_actions_db: \"customer_data\"\n    activation_actions_table: \"unified_profiles\"\n    result_connection_name: \"snowflake_production\"\n    result_connection_settings:\n      type: \"snowflake\"\n      database: \"MARKETING\"\n      schema: \"SEGMENTS\"\n      table: \"ACTIVE_SUBSCRIBERS\"\n      mode: \"append\"\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":44},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/audience-studio/activation/configure-incremental-activation"},"children":["Configure Incremental Activation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/audience-studio/activation/incremental-activation-mappings"},"children":["Incremental Activation Mappings"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/audience-studio/activation/troubleshooting-incremental-activation"},"children":["Troubleshooting Incremental Activation"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-topics","__idx":45},"children":["Related Topics"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/audience-studio/activation/incremental-activation-overview"},"children":["Incremental Activation Overview"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/audience-studio/activation/activation-actions-parameters"},"children":["Activation Actions Parameters"]}]}]}]},"headings":[{"value":"Incremental Activation Parameters","id":"incremental-activation-parameters","depth":1},{"value":"Parameter Overview","id":"parameter-overview","depth":2},{"value":"api_endpoint","id":"api_endpoint","depth":2},{"value":"Values by TD Site","id":"values-by-td-site","depth":3},{"value":"Example","id":"example","depth":3},{"value":"Validation","id":"validation","depth":3},{"value":"id_key","id":"id_key","depth":2},{"value":"Purpose","id":"purpose","depth":3},{"value":"Common Values","id":"common-values","depth":3},{"value":"Example","id":"example-1","depth":3},{"value":"Requirements","id":"requirements","depth":3},{"value":"Best Practices","id":"best-practices","depth":3},{"value":"delta_keys","id":"delta_keys","depth":2},{"value":"Purpose","id":"purpose-1","depth":3},{"value":"Examples","id":"examples","depth":3},{"value":"Default Behavior","id":"default-behavior","depth":3},{"value":"How Delta Keys Work","id":"how-delta-keys-work","depth":3},{"value":"Best Practices","id":"best-practices-1","depth":3},{"value":"Common Patterns","id":"common-patterns","depth":3},{"value":"activation_mappings","id":"activation_mappings","depth":2},{"value":"Structure","id":"structure","depth":3},{"value":"Example","id":"example-2","depth":3},{"value":"Limits","id":"limits","depth":3},{"value":"activation_actions_db","id":"activation_actions_db","depth":2},{"value":"When Auto-Populated","id":"when-auto-populated","depth":3},{"value":"When Required","id":"when-required","depth":3},{"value":"Validation","id":"validation-1","depth":3},{"value":"activation_actions_table","id":"activation_actions_table","depth":2},{"value":"When Auto-Populated","id":"when-auto-populated-1","depth":3},{"value":"When Required","id":"when-required-1","depth":3},{"value":"Validation","id":"validation-2","depth":3},{"value":"result_connection_settings","id":"result_connection_settings","depth":2},{"value":"When Auto-Populated","id":"when-auto-populated-2","depth":3},{"value":"When Required","id":"when-required-2","depth":3},{"value":"Example - Snowflake","id":"example---snowflake","depth":3},{"value":"Example - Google Sheets","id":"example---google-sheets","depth":3},{"value":"Connector-Specific Requirements","id":"connector-specific-requirements","depth":3},{"value":"result_connection_name","id":"result_connection_name","depth":2},{"value":"When Auto-Populated","id":"when-auto-populated-3","depth":3},{"value":"When Required","id":"when-required-3","depth":3},{"value":"Validation","id":"validation-3","depth":3},{"value":"Complete Parameter Examples","id":"complete-parameter-examples","depth":2},{"value":"Activation Action Mode","id":"activation-action-mode","depth":3},{"value":"Standalone Mode","id":"standalone-mode","depth":3},{"value":"Next Steps","id":"next-steps","depth":2},{"value":"Related Topics","id":"related-topics","depth":2}],"frontmatter":{"seo":{"title":"Incremental Activation Parameters","description":"Reference for all parameters used in the Incremental Activation workflow template, including API endpoint, ID key, delta keys, and activation mappings."}},"lastModified":"2026-06-01T09:09:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/audience-studio/activation/incremental-activation-parameters","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}