{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Treasure Code","product_name":"Treasure Code","type":"markdown"},"seo":{"title":"Marketing as Code - tdx | Treasure Data","description":"Transform marketing operations into version-controlled YAML. Manage segments, journeys, and workflows as code with AI assistance.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"image":"/assets/og-image.ba836864a30434f560a4f7720f8a09019ad30ff828b20c5052ae933ba7121524.d7ef4821.png"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"marketing-as-code","__idx":0},"children":["Marketing as Code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["tdx enables ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Marketing as Code"]},"—a paradigm shift from manual UI operations to AI-friendly marketing configurations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-problem","__idx":1},"children":["The Problem"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Traditional marketing operations rely on clicking through UIs:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manual and error-prone"]}," - Complex sequences of clicks that are hard to reproduce"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invisible to AI"]}," - AI assistants cannot navigate UIs or understand click-based workflows"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Hard to scale"]}," - Cannot easily replicate configurations across brands or environments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No version control"]}," - Difficult to track changes, review history, or roll back mistakes"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-solution","__idx":2},"children":["The Solution"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["tdx treats marketing logic as code:"]},{"$$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":"Traditional \"Click Ops\""},"children":["Traditional \"Click Ops\""]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Marketing as Code"},"children":["Marketing as Code"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configure in UI"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Define in YAML files"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manual testing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Local validation with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Direct production changes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Test locally, then deploy"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hard to automate"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AI agents can read/write"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"yaml-as-source-of-truth","__idx":3},"children":["YAML as Source of Truth"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Instead of navigating complex UIs, define your marketing logic in simple YAML files:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"name: High-Value Customers\ndescription: Customers with lifetime value > $1000\nrules:\n - attribute: lifetime_value\n operator: greater_than\n value: 1000\nactivations:\n - connection: salesforce-prod\n enabled: true\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"type: journey\nname: Welcome Series\nreentry: no_reentry\n\nstages:\n - name: Onboarding\n steps:\n - type: activation\n name: Send Welcome Email\n with:\n activation: welcome-email\n next: wait-for-engagement\n\n - type: wait\n name: Wait for Engagement\n id: wait-for-engagement\n with:\n condition:\n segment: engaged-users\n timeout:\n duration: 7\n unit: day\n next: follow-up\n\n - type: activation\n name: Follow Up\n id: follow-up\n with:\n activation: follow-up-email\n\nactivations:\n welcome-email:\n connection: email-provider\n follow-up-email:\n connection: email-provider\n\nsegments:\n engaged-users:\n rules:\n - attribute: email_opened\n operator: is_true\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Why YAML?"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AI excels at generating structured text like YAML"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Human-readable and easy to review"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Standard format with excellent tooling support"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoids hallucinations from complex JSON APIs"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/commands/segment#segment-yaml-schema"},"children":["Segment YAML Schema"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/commands/journey#journey-yaml-schema"},"children":["Journey YAML Schema"]}," for full specifications."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cdp-architecture","__idx":4},"children":["CDP Architecture"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["CDP resources follow a hierarchical structure:"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TB\n subgraph Parent[\"Parent Segment (tdx ps)\"]\n Master[(Master Table)]\n Attrs[Attributes]\n Behaviors[Behaviors]\n Master --> Attrs\n Master --> Behaviors\n end\n\n subgraph Children[\"Child Segments (tdx sg)\"]\n Seg1[Segment A
Rules + Activations]\n Seg2[Segment B
Rules + Activations]\n end\n\n subgraph Journeys[\"Journeys (tdx journey)\"]\n J1[Welcome Series]\n J2[Re-engagement]\n end\n\n Parent --> Seg1\n Parent --> Seg2\n Parent --> J1\n Parent --> J2\n\n Seg1 --> Act1[Salesforce]\n Seg2 --> Act2[Facebook]\n J1 --> Act3[Email Sequence]\n J2 --> Act4[Push Notifications]\n","diagramHtml":"

Journeys (tdx journey)

Child Segments (tdx sg)

Parent Segment (tdx ps)

Master Table

Attributes

Behaviors

Segment A
Rules + Activations

Segment B
Rules + Activations

Welcome Series

Re-engagement

Salesforce

Facebook

Email Sequence

Push Notifications

","diagramHtmlDark":"

Journeys (tdx journey)

Child Segments (tdx sg)

Parent Segment (tdx ps)

Master Table

Attributes

Behaviors

Segment A
Rules + Activations

Segment B
Rules + Activations

Welcome Series

Re-engagement

Salesforce

Facebook

Email Sequence

Push Notifications

"},"children":["flowchart TB\n subgraph Parent[\"Parent Segment (tdx ps)\"]\n Master[(Master Table)]\n Attrs[Attributes]\n Behaviors[Behaviors]\n Master --> Attrs\n Master --> Behaviors\n end\n\n subgraph Children[\"Child Segments (tdx sg)\"]\n Seg1[Segment A
Rules + Activations]\n Seg2[Segment B
Rules + Activations]\n end\n\n subgraph Journeys[\"Journeys (tdx journey)\"]\n J1[Welcome Series]\n J2[Re-engagement]\n end\n\n Parent --> Seg1\n Parent --> Seg2\n Parent --> J1\n Parent --> J2\n\n Seg1 --> Act1[Salesforce]\n Seg2 --> Act2[Facebook]\n J1 --> Act3[Email Sequence]\n J2 --> Act4[Push Notifications]\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parent Segment"]}," defines the data foundation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Master Table"]}," - Source of customer records"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Attributes"]}," - Customer properties (e.g., lifetime_value, signup_date)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Behaviors"]}," - Customer actions (e.g., purchases, page_views)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Child Segments"]}," define targeting rules and activations:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Filter customers using attributes and behaviors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Activate to marketing channels (Salesforce, Google Ads, etc.)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Journeys"]}," orchestrate multi-step customer experiences:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Define stages with sequential or conditional steps"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait for time delays or segment conditions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Branch based on A/B tests or decision points"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Activate to channels at each step"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-lifecycle","__idx":5},"children":["The Lifecycle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Marketing as Code follows a familiar development workflow:"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n Define[\"1. Define
(Code)\"] --> Verify[\"2. Verify
(Test)\"] --> Deploy[\"3. Deploy
(Push)\"]\n","diagramHtml":"

1. Define
(Code)

2. Verify
(Test)

3. Deploy
(Push)

","diagramHtmlDark":"

1. Define
(Code)

2. Verify
(Test)

3. Deploy
(Push)

"},"children":["flowchart LR\n Define[\"1. Define
(Code)\"] --> Verify[\"2. Verify
(Test)\"] --> Deploy[\"3. Deploy
(Push)\"]\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use these commands to manage CDP resources as code:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/commands/parent-segment"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx ps"]}]}," (parent-segment) - Pull, edit, and push parent segment YAML files"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/commands/segment"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx sg"]}]}," (segment) - Pull, edit, and push child segment YAML files"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/commands/journey"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tdx journey"]}]}," - Pull, edit, and push journey YAML files"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-define","__idx":6},"children":["1. Define"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AI generates or you write marketing definitions locally:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Pull existing resources to YAML\ntdx sg pull \"My Segment\"\ntdx journey pull \"My Journey\"\n\n# AI can modify the YAML files\n# or create new definitions from scratch\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-verify","__idx":7},"children":["2. Verify"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Test your changes locally before touching production:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Validate definitions\ntdx sg validate\ntdx journey validate\n\n# Preview sample data\ntdx ps preview\ntdx sg show\n\n# Check what would change\ntdx sg push --dry-run\ntdx journey push --dry-run\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-deploy","__idx":8},"children":["3. Deploy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Push verified changes to production:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Deploy segment changes\ntdx sg push\n\n# Deploy journey changes\ntdx journey push\n\n# Deploy parent segment\ntdx ps push\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"benefits","__idx":9},"children":["Benefits"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"standardization","__idx":10},"children":["Standardization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Code is standard. One team's segment definition looks the same as another's—solving scattered, inconsistent configurations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"version-control-optional","__idx":11},"children":["Version Control (Optional)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Store YAML files in Git to track changes over time. If an AI agent makes a mistake, you can ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["git revert"]},". You cannot easily revert a sequence of UI clicks."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scalability","__idx":12},"children":["Scalability"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy and adapt YAML files across 100 brands. You cannot copy-paste UI clicks."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"production-safety","__idx":13},"children":["Production Safety"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Test locally before deploying. Marketing as Code means you don't break production—you validate first."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ai-native","__idx":14},"children":["AI-Native"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AI agents can read, write, and test marketing configurations safely. The complexity stays in tdx, not in your prompts."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/commands/claude"},"children":["tdx claude"]}," to launch Claude Code with TD's ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/products/customer-data-platform/ai-agent-foundry"},"children":["AI Foundry"]}," backend—AI can edit your YAML files, validate changes, and deploy segments directly."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"getting-started","__idx":15},"children":["Getting Started"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Install tdx\nnpm install -g @treasuredata/tdx\n\n# Authenticate\ntdx auth setup\n\n# Pull resources to start working locally\ntdx sg pull \"My Segment\" -u\ntdx journey pull \"My Journey\" -u\n\n# Make changes to the YAML files, then push\ntdx sg push\ntdx journey push\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"learn-more","__idx":16},"children":["Learn More"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/commands/parent-segment"},"children":["Parent Segment Commands"]}," - Manage parent segments as YAML"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/commands/segment"},"children":["Segment Commands"]}," - Manage child segments as YAML"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/commands/journey"},"children":["Journey Commands"]}," - Manage journeys as YAML"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/treasure-code/guide/td-skills"},"children":["TD Skills"]}," - AI skills for CDP management"]}]}]},"headings":[{"value":"Marketing as Code","id":"marketing-as-code","depth":1},{"value":"The Problem","id":"the-problem","depth":2},{"value":"The Solution","id":"the-solution","depth":2},{"value":"YAML as Source of Truth","id":"yaml-as-source-of-truth","depth":2},{"value":"CDP Architecture","id":"cdp-architecture","depth":2},{"value":"The Lifecycle","id":"the-lifecycle","depth":2},{"value":"1. Define","id":"1-define","depth":3},{"value":"2. Verify","id":"2-verify","depth":3},{"value":"3. Deploy","id":"3-deploy","depth":3},{"value":"Benefits","id":"benefits","depth":2},{"value":"Standardization","id":"standardization","depth":3},{"value":"Version Control (Optional)","id":"version-control-optional","depth":3},{"value":"Scalability","id":"scalability","depth":3},{"value":"Production Safety","id":"production-safety","depth":3},{"value":"AI-Native","id":"ai-native","depth":3},{"value":"Getting Started","id":"getting-started","depth":2},{"value":"Learn More","id":"learn-more","depth":2}],"frontmatter":{"seo":{"title":"Marketing as Code - tdx | Treasure Data","description":"Transform marketing operations into version-controlled YAML. Manage segments, journeys, and workflows as code with AI assistance.","image":"/assets/og-image.ba836864a30434f560a4f7720f8a09019ad30ff828b20c5052ae933ba7121524.d7ef4821.png"}},"lastModified":"2026-04-17T09:39:31.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/treasure-code/guide/marketing-as-code","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}