{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Products","product_name":"Data Workbench","type":"markdown"},"seo":{"title":"Data Enrichment Action Reference","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","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":"data-enrichment-action-reference","__idx":0},"children":["Data Enrichment Action Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Parent Segments, you can execute a list of enrichment actions by adding specific ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_"]}," columns to the behavior tables in the Treasure Console, as shown in this example:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20190909-224837.78fba5035fb92ec5034889714c58a32932e2dade3c804002cda078044d5b8391.cf3845cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"attribute-enrichment-enablement","__idx":1},"children":["Attribute Enrichment Enablement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Attribute Enrichment Options are enabled by default. However, if you don't have the required fields (td_client_id, td_ip, td_host, td_path, td_title, td_description) in your parent segment, we recommend disabling these options."," ","Disabling these options reduces some tasks in the Audience Workflow build, which will help improve workflow performance."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/data-enrichment-action-reference-2024-11-12-10-12-09.33e9cd33343b1500b540335b9b47a3f0786a999c9ab3fc5427514c5528b85d94.cf3845cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"attribute-enrichment","__idx":2},"children":["Attribute Enrichment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For these types of enrichment, add the source column to the Attribute table definition when defining your master segment."]},{"$$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":"Enrichment type"},"children":["Enrichment type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Source column"},"children":["Source column"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Added output columns"},"children":["Added output columns"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Column description"},"children":["Column description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Last Access Date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Adds the most recent customer access date."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_client_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_last_access_date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Last IP Information Enrichment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Adds customer information by IP using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TD_IP_TO_*"]}," functions."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_country_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_latitude"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_longitude"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_metro_code"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_time_zone"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_postal_code"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_least_specific_subdivision_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_most_specific_subdivision_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_subdivision_names"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_connection_type"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_domain"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/queries/sql-reference/td_trino_function_reference#td_ip_to_city_name"},"children":["Treasure Data IP reference"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Content Affinity Engine"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Adds words of interest and interest categories based on content title and description. Uses ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/50onRed/openrtb-iab-categories/blob/master/openrtb_iab_categories.json"},"children":["OpenRTB’s category list"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_host"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_path"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_title"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_interest_words"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_affinity_categories"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_affinity_category_scores"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_affinity_sub_categories"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_affinity_sub_category_scores"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TF-IDF keywords and category scores."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"behavior-enrichment","__idx":3},"children":["Behavior Enrichment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For these types of enrichment, add the source column to the Behavior table definition when defining your master segment."]},{"$$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":"Enrichment type"},"children":["Enrichment type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Source column"},"children":["Source column"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Added output columns"},"children":["Added output columns"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Column description"},"children":["Column description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User Agent Parsing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Master Segments can automatically parse the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_agent"]}," string."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent_category"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Category extracted from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent"]},", for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["element_at(td_parse_agent(td_user_agent), 'category')"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name extracted from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent_os"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OS extracted from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent_os_version"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OS version extracted from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent_vendor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Vendor extracted from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent_version"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Version extracted from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utm_"]}," Parameters Parsing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Automatically extracts ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utm_campaign"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utm_medium"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utm_source"]}," URL parameters used for online campaign attribution."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_utm_campaign"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Campaign name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_utm_medium"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Medium (for example, email, CPC ads)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_utm_source"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Source (for example, Google, Facebook)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["IP Information Enrichment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Adds additional customer information by IP using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TD_IP_TO_*"]}," functions."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_country_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_latitude"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_longitude"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_metro_code"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_time_zone"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_city_postal_code"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_least_specific_subdivision_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_most_specific_subdivision_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_subdivision_names"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_connection_type"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ip_domain"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["See Attribute Enrichment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Web Crawler Access Exclusion"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Removes access data generated by web crawlers so profiles contain only real human activity."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_user_agent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The behaviors are removed; no additional columns are added."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"content-affinity-engine-example","__idx":4},"children":["Content Affinity Engine Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Based on the content's title and description, Treasure Data adds words of interest and estimates to profile interest categories. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/50onRed/openrtb-iab-categories/blob/master/openrtb_iab_categories.json"},"children":["OpenRTB's list of categories"]}," is used as a master category list."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20190909-224906.bc8ceea4f499778ee9a5cbda4352e3d699c0fc981cb88c4b785fd49a2a5edef1.cf3845cb.png","alt":""},"children":[]}]}]},"headings":[{"value":"Data Enrichment Action Reference","id":"data-enrichment-action-reference","depth":1},{"value":"Attribute Enrichment Enablement","id":"attribute-enrichment-enablement","depth":2},{"value":"Attribute Enrichment","id":"attribute-enrichment","depth":2},{"value":"Behavior Enrichment","id":"behavior-enrichment","depth":2},{"value":"Content Affinity Engine Example","id":"content-affinity-engine-example","depth":1}],"frontmatter":{"seo":{"title":"Data Enrichment Action Reference"}},"lastModified":"2026-06-01T09:09:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/data-workbench/parent-segments/data-enrichment-action-reference","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}