{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"What is ID Unification?","description":"Learn how ID Unification consolidates user identifiers across data sources, creating a unified customer profile by linking different IDs like email, device, and membership.","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":"what-is-id-unification","__idx":0},"children":["What is ID Unification?"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ID Unification is the process of stitching together multiple tables using various identifiers to assign a unique customer ID (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persistent_id"]},") to each user. In simpler terms, it consolidates identifiers like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cookie_id"]}," and email addresses from various user data sources to identify and group \"the same person.\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Since customer data often contains different identifiers across different data sources, simply aggregating this data doesn't link these sources together. This necessitates the ID Unification process to make the data usable."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/1-1-1.7c49830077d57de283a45c7058706a9811fb3bfc3466dfe3cb8a47797d973393.525d8949.avif","alt":"Relationship Between Different Identifiers"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The above diagram illustrates the relationships between the IDs (identifiers) associated with users. Below, we outline common types of IDs that are unified, showing how the process integrates data to uniquely identify individuals."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"types-of-ids-linked-to-users","__idx":2},"children":["Types of IDs Linked to Users"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"user-associated-ids","__idx":3},"children":["User-Associated IDs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are identifiers issued by various services, such as membership IDs or email addresses used during registration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Examples:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["member_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_address"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"device-associated-ids","__idx":4},"children":["Device-Associated IDs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["IDs issued for each device, such as ADID/IDFA, are used when collecting application logs."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Examples:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ADID"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IDFA"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"browser-associated-ids","__idx":5},"children":["Browser-Associated IDs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cookies issued per browser and source (1st-party or 3rd-party) are used. For stitching across data sources, having both 1st-party and 3rd-party ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cookie_id"]}," is advantageous."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Examples:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cookie_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_ssc_id"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"id-unification-feature-provided-by-treasure-workflow","__idx":6},"children":["ID Unification Feature Provided by Treasure Workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ID Unification is provided as a standard feature accessible to all users. To utilize this tool, users mainly need to prepare:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A .dig file to invoke the unification workflow."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A .yml file defining the data sources and stitching keys for ID Unification."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"dig-file-to-invoke-the-unification-workflow","__idx":7},"children":[".dig File to Invoke the Unification Workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The .dig file makes an HTTP call to invoke the Unification Workflow. This approach eliminates the need to download workflow code from GitHub and ensures all users receive updates simultaneously."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"+call_unification:\n  http_call>: https://api-cdp.treasuredata.com/unifications/workflow_call\n  headers:\n    - authorization: ${secret:td.apikey}\n  method: POST\n  …\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"yml-file-for-defining-data-sources-and-stitching-keys","__idx":8},"children":[".yml File for Defining Data Sources and Stitching Keys"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".yml"]}," file specifies the source tables and the keys used for stitching. While .dig files remain relatively consistent across use cases, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".yml"]}," files depend entirely on the user's data structure and must be carefully written. Copy-pasting a template or another user's file won't suffice."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"name: test_id_unification_ex1\n\nkeys:\n  - name: td_client_id\n  - name: td_global_id\n\ntables:\n  - database: test_id_unification_ex1\n    table: ex1_site_aaa\n    key_columns:\n      - {column: td_client_id, key: td_client_id}\n      - {column: td_global_id, key: td_global_id}\n…\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"defining-inputs-and-outputs-of-id-unification","__idx":9},"children":["Defining Inputs and Outputs of ID Unification"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"inputs-of-id-unification","__idx":10},"children":["Inputs of ID Unification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ID Unification requires enumerating:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All tables with identifiers that can be stitched together."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The identifiers (keys) within each table used for stitching."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These keys are used to traverse all tables and consolidate data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/1-2-1.20476b5a78409ddb3698221726d752f29ce37b95f18393ff83323f4ffa0b1308.525d8949.avif","alt":"InputIDU"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"outputs-of-id-unification","__idx":11},"children":["Outputs of ID Unification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The most significant output of ID Unification is the assignment of a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," to each identified individual. This process enriches the source tables, appending the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]}," to facilitate further operations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/1-3-1.fff117a5c4e18d82b02f8246448595de3e1dd1833ac7e73d95ea8852daf1c210.525d8949.avif","alt":"Output"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All stitched tables are output with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]},", enabling table joins and analysis at the user level. For instance, using this ID as a join key allows unification of other tables for user-based aggregation and analysis."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"id-unification-for-audience-studio","__idx":12},"children":["ID Unification for Audience Studio"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ID Unification is a fundamental tool for utilizing Audience Studio. It begins by enumerating all source tables (attribute_table, behavior_table) and the keys within these tables."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/1-4-1.1d9ebaf8c94c37edd0d41606cbfa9850d2444838ea7cd86df3c63353a43449cc.525d8949.avif","alt":"Output"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"outputs-for-audience-studio","__idx":13},"children":["Outputs for Audience Studio"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to enriched source tables, Audience Studio outputs a master_table containing the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canonical_id"]},". This ensures all necessary tables for Master Segment creation—master_table, attribute_table, and behavior_table are prepared with enriched data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/1-5-1.127629cd1f8bfa52cfcae0ec84ebe2ab5c1a4d2fd22b9c6387a39aa0d33a1b59.525d8949.avif","alt":"Output"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"workflow-examples","__idx":14},"children":["Workflow Examples"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Workflow examples in this ID Unification doc is published at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/treasure-data/treasure-boxes/tree/master/tool-box/id-unification-samples"},"children":["Treasure Boxes"]},". You can try it out on your Treasure account."]}]},"headings":[{"value":"What is ID Unification?","id":"what-is-id-unification","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Types of IDs Linked to Users","id":"types-of-ids-linked-to-users","depth":2},{"value":"User-Associated IDs","id":"user-associated-ids","depth":3},{"value":"Device-Associated IDs","id":"device-associated-ids","depth":3},{"value":"Browser-Associated IDs","id":"browser-associated-ids","depth":3},{"value":"ID Unification Feature Provided by Treasure Workflow","id":"id-unification-feature-provided-by-treasure-workflow","depth":2},{"value":".dig File to Invoke the Unification Workflow","id":"dig-file-to-invoke-the-unification-workflow","depth":3},{"value":".yml File for Defining Data Sources and Stitching Keys","id":"yml-file-for-defining-data-sources-and-stitching-keys","depth":3},{"value":"Defining Inputs and Outputs of ID Unification","id":"defining-inputs-and-outputs-of-id-unification","depth":2},{"value":"Inputs of ID Unification","id":"inputs-of-id-unification","depth":3},{"value":"Outputs of ID Unification","id":"outputs-of-id-unification","depth":3},{"value":"ID Unification for Audience Studio","id":"id-unification-for-audience-studio","depth":3},{"value":"Outputs for Audience Studio","id":"outputs-for-audience-studio","depth":3},{"value":"Workflow Examples","id":"workflow-examples","depth":2}],"frontmatter":{"seo":{"title":"What is ID Unification?","description":"Learn how ID Unification consolidates user identifiers across data sources, creating a unified customer profile by linking different IDs like email, device, and membership."}},"lastModified":"2026-06-17T07:22:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/products/customer-data-platform/id-unification/p0_introduction","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}