{"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 Mappings","description":"Learn how to define Incremental Activation mappings to control how profile changes are processed and sent to destination platforms during data synchronization.","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]},"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-mappings","__idx":0},"children":["Incremental Activation Mappings"]},{"$$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":["Activation mappings define how delta records are sent to your destination platform. Each mapping connects a delta status (new, updated, deleted, or unchanged) to a specific connector configuration, allowing you to control how different types of changes are handled during activation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understanding-activation-mappings","__idx":1},"children":["Understanding Activation Mappings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After each workflow run, your source table data may have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New rows"]},": Profiles added to the segment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Updated rows"]},": Profiles whose attributes changed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deleted rows"]},": Profiles removed from the segment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unchanged rows"]},": Profiles that remain the same"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Incremental Activation workflow identifies these changes automatically. Your activation mappings determine what action to take for each type of change."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"mapping-structure","__idx":2},"children":["Mapping Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activation_mappings"]}," parameter accepts an array of mapping objects. Each mapping object contains three fields:"]},{"$$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":"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":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The calculated delta record status: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["new"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updated"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleted"]},", or ",{"$$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":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The connector configuration field name (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]}," for Snowflake, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation"]}," for Klaviyo)"]}]},{"$$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":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The value to set for the connector field (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["append"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replace"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delete"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"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\": \"deleted\",\n    \"connector_field\": \"mode\",\n    \"connector_field_value\": \"delete\"\n  }\n]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"processing-order","__idx":3},"children":["Processing Order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The order of mappings in the array determines the processing order for the result export. The workflow processes mappings sequentially in the order they appear."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example - Process new profiles first, then deletions"]},":"]},{"$$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\": \"deleted\",\n    \"connector_field\": \"mode\",\n    \"connector_field_value\": \"delete\"\n  }\n]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-mapping-patterns","__idx":4},"children":["Common Mapping Patterns"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"add-new-profiles-only","__idx":5},"children":["Add New Profiles Only"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send only new profiles to the destination. Previously activated profiles that no longer qualify remain in the platform."]},{"$$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","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use cases"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Braze campaigns where you want to build cumulative audiences"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Google Ads customer lists where removed profiles should stay for historical tracking"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Meta Custom Audiences where you're only adding new prospects"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"add-updated-profiles","__idx":6},"children":["Add Updated Profiles"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send new or changed profiles to the destination."]},{"$$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","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use cases"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Updating profile attributes in marketing platforms"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refreshing contact information in CRM systems"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Syncing preference changes to email marketing platforms"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"replace-with-updated-profiles","__idx":7},"children":["Replace with Updated Profiles"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Clear the destination list and replace it with currently qualified profiles."]},{"$$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\": \"replace\"\n  },\n  {\n    \"delta_status\": \"updated\",\n    \"connector_field\": \"mode\",\n    \"connector_field_value\": \"replace\"\n  }\n]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This mode requires your connector to support the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replace"]}," operation. Verify compatibility with your destination platform."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use cases"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Salesforce Marketing Cloud where precision targeting is required"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Platforms that don't support incremental updates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Scenarios where you need exact synchronization"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"add-updated--remove-missing","__idx":8},"children":["Add Updated & Remove Missing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add new profiles and explicitly remove profiles that no longer qualify."]},{"$$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":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This mode requires your connector to support both add/append and delete/remove operations. Verify compatibility with your destination platform."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use cases"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Meta Custom Audiences where list accuracy is critical"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GDPR/CCPA compliance scenarios requiring profile removal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Platforms where abandoned cart audiences must be precisely maintained"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connector-specific-field-names","__idx":9},"children":["Connector-Specific Field Names"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Different connectors use different field names for controlling upload behavior. Always consult your connector's documentation for the correct field name."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"common-connector-fields","__idx":10},"children":["Common Connector Fields"]},{"$$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":"Connector"},"children":["Connector"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field Name"},"children":["Field Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Supported Values"},"children":["Supported Values"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Snowflake"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["insert"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truncate_insert"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merge"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["MySQL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["append"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replace"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truncate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PostgreSQL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["append"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replace"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truncate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Google Sheets"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["append"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replace"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Klaviyo"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["add"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["remove"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Salesforce Marketing Cloud"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["append"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replace"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Salesforce B2C Commerce Cloud"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["append"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replace"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Meta Custom Audiences"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["action"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["add"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["remove"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example for Klaviyo"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"activation_mappings: [\n  {\n    \"delta_status\": \"new\",\n    \"connector_field\": \"operation\",\n    \"connector_field_value\": \"add\"\n  },\n  {\n    \"delta_status\": \"deleted\",\n    \"connector_field\": \"operation\",\n    \"connector_field_value\": \"remove\"\n  }\n]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connector-compatibility","__idx":11},"children":["Connector Compatibility"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Not all result export connectors support dynamic mode configuration. Before configuring your mappings:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Check connector documentation"]},": Verify your connector supports the required operations (add, update, remove, replace)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Test with small datasets"]},": Validate that your mappings work as expected before production use."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contact support"]},": If unsure about connector capabilities, contact your Customer Success Representative."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connectors-with-limited-support","__idx":12},"children":["Connectors with Limited Support"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TikTok Custom Audiences"]},": Limited support for removing users; updates processed asynchronously (up to 48 hours)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Some email marketing platforms"]},": May only support append operations"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"maximum-mappings","__idx":13},"children":["Maximum Mappings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can define up to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["4 mapping elements"]}," in one workflow, corresponding to the four delta status types: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["new"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updated"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleted"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unchanged"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"validation-rules","__idx":14},"children":["Validation Rules"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delta_status"]}," value should appear only once in the mappings array"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connector_field"]}," must be a valid field for your destination connector"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connector_field_value"]}," must be supported by your connector"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At least one mapping must be defined"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"examples-by-use-case","__idx":15},"children":["Examples by Use Case"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"e-commerce-cart-abandonment-campaign","__idx":16},"children":["E-commerce: Cart Abandonment Campaign"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send new cart abandoners to Braze, remove those who completed purchase:"]},{"$$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\": \"deleted\",\n    \"connector_field\": \"mode\",\n    \"connector_field_value\": \"delete\"\n  }\n]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"b2b-lead-scoring-updates","__idx":17},"children":["B2B: Lead Scoring Updates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Update Google Ads with new high-value leads and their score changes:"]},{"$$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","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"retail-loyalty-tier-changes","__idx":18},"children":["Retail: Loyalty Tier Changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sync loyalty tier changes to Salesforce Marketing Cloud, ensuring precise list accuracy:"]},{"$$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\": \"replace\"\n  },\n  {\n    \"delta_status\": \"updated\",\n    \"connector_field\": \"mode\",\n    \"connector_field_value\": \"replace\"\n  }\n]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"e-commerce-full-sync-to-salesforce-b2c-commerce-cloud","__idx":19},"children":["E-commerce: Full Sync to Salesforce B2C Commerce Cloud"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Maintain complete customer synchronization with Salesforce B2C Commerce Cloud, using full sync for accurate customer data:"]},{"$$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\": \"replace\"\n  }\n]\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":20},"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-parameters"},"children":["Incremental Activation Parameters"]}]},{"$$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":21},"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"]}]}]}]},"headings":[{"value":"Incremental Activation Mappings","id":"incremental-activation-mappings","depth":1},{"value":"Understanding Activation Mappings","id":"understanding-activation-mappings","depth":2},{"value":"Mapping Structure","id":"mapping-structure","depth":2},{"value":"Processing Order","id":"processing-order","depth":2},{"value":"Common Mapping Patterns","id":"common-mapping-patterns","depth":2},{"value":"Add New Profiles Only","id":"add-new-profiles-only","depth":3},{"value":"Add Updated Profiles","id":"add-updated-profiles","depth":3},{"value":"Replace with Updated Profiles","id":"replace-with-updated-profiles","depth":3},{"value":"Add Updated & Remove Missing","id":"add-updated--remove-missing","depth":3},{"value":"Connector-Specific Field Names","id":"connector-specific-field-names","depth":2},{"value":"Common Connector Fields","id":"common-connector-fields","depth":3},{"value":"Connector Compatibility","id":"connector-compatibility","depth":2},{"value":"Connectors with Limited Support","id":"connectors-with-limited-support","depth":3},{"value":"Maximum Mappings","id":"maximum-mappings","depth":2},{"value":"Validation Rules","id":"validation-rules","depth":2},{"value":"Examples by Use Case","id":"examples-by-use-case","depth":2},{"value":"E-commerce: Cart Abandonment Campaign","id":"e-commerce-cart-abandonment-campaign","depth":3},{"value":"B2B: Lead Scoring Updates","id":"b2b-lead-scoring-updates","depth":3},{"value":"Retail: Loyalty Tier Changes","id":"retail-loyalty-tier-changes","depth":3},{"value":"E-commerce: Full Sync to Salesforce B2C Commerce Cloud","id":"e-commerce-full-sync-to-salesforce-b2c-commerce-cloud","depth":3},{"value":"Next Steps","id":"next-steps","depth":2},{"value":"Related Topics","id":"related-topics","depth":2}],"frontmatter":{"seo":{"title":"Incremental Activation Mappings","description":"Learn how to define Incremental Activation mappings to control how profile changes are processed and sent to destination platforms during data synchronization."}},"lastModified":"2026-06-17T07:22:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/audience-studio/activation/incremental-activation-mappings","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}