All Products
Search

This Product

    Dataphin:Create real-time tags through metric mapping

    Document Center

    Dataphin:Create real-time tags through metric mapping

    Last Updated:Jun 17, 2026

    Dataphin supports defining real-time dataset metrics directly as tags. You can create real-time tags through metric mapping to quickly reuse existing metrics for entity profiling.

    Prerequisites

    A real-time dataset must already exist before you create real-time tags through metric mapping. For more information, see real-time dataset.

    Procedure

    1. Navigate to the Dataphin home page, select Tag > Workbench from the top menu bar.

    2. Choose Project from the top menu bar.

    3. In the left-side navigation pane, click Tag Processing > Realtime Tag. On the Realtime Tag page, select Add Tag.

    4. In the Add Realtime Tag dialog box, choose Registered Tag to access the Create Metric Mapping page.

    5. On the Create Metric Mapping page, set up the Business Attribute, Technical Attribute, and Processing Logic for the real-time tag.

      • Business Attribute

        Parameter

        Description

        Entity-entity ID

        Select the entity and entity ID for the real-time tag.

        Tag Type

        The processing method used for the tag.

        • Attribute Tag: Describes objective facts about an entity, such as gender or name.

        • Statistical Tag: Derived from statistical analysis of entity behaviors or attributes, such as the purchase amount over the last 7 days.

        • Predictive Tag: Forecasts entity characteristics or behaviors using algorithmic models, such as a user's predicted province of residence.

        • Composite Tag: Combines multiple tags by applying specific rules, such as consumer segmentation tags.

        Timeliness

        Specifies whether the tag value changes over time.

        • Static Tag: Represents inherent characteristics that do not change over time, such as gender and name.

        • Dynamic Tag: Updates over time to stay current, such as the order amount in the last 7 days.

        Owner

        Select the owner of the real-time tag.

      • Technical Attribute

        Tag Update Method: Fixed to Real-time Update Method and cannot be changed.

      • Processing Logic

        Parameter

        Description

        Dataset

        Select the real-time dataset to use.

        Primary Key

        Automatically set to the primary key of the real-time dataset and cannot be changed.

        Tag Definition

        Select a column name and specify the tag name and tag code. You can add tags individually or in batches.

        • Individual Addition: Click Add and enter the required information.

          • Metric Name: The data column to define as a tag.

          • Tag Name: Accepts Chinese characters, English letters (uppercase and lowercase), numbers, and underscores (_), up to 64 characters.

          • Tag Code: A unique identifier for the tag. It must begin with a lowercase English letter and can include lowercase letters, numbers, and underscores (_), up to 64 characters in length.

          • Tag Lookup Table: If the source field column has an associated lookup table, that table is used automatically.

            Note

            Click image.png to view lookup table details, including name, code values, and code names. Only the first 50 code values are displayed.

          • Value Type: Automatically detected based on the column type. No manual input is required.

          • Version Number: Can include uppercase and lowercase English letters, numbers, underscores (_), hyphens (-), and periods (.), up to 64 characters.

          • Tag Description: A brief description of the tag, up to 1000 characters.

        • Batch Addition:

          1. Click Processing Logic and then Batch Add. In the Select Dataset Metric dialog box, select one or more metrics from the list. Use the search box to find metrics that have not yet been tagged by name or description.

            Note

            • The metric list shows dataset metrics not yet added to the tag definition list and indicates if the metric has been used for tags. You can filter to Only View Metrics That Have Not Generated Tags and select all using Selected.

            • Metrics that have generated tags indicate that a submitted tag version references the metric.

          2. Click Confirm. The selected metrics will populate the tag definition list.

            To remove metrics, click the Actions column image icon next to a metric, or select multiple metrics and click Batch Delete. If all metrics are removed, one default row with version number V1 remains, with other parameters empty.

            Note

            • Metric duplication is not permitted within the tag definition list. Once a metric from the dataset is included in the current tag definition list, it cannot be selected a second time.

            • When Auto Fill is applied, the metric name populates the tag code column, even if this column already contains a value. Should the metric include a tag description, it will populate both the tag name and tag description columns; however, existing values in these columns will remain unchanged.

    6. Click Submit to finalize the creation of the real-time tag.

      After the real-time tag is created, you must publish it before it can be used.

      1. In the list of real-time tags, click the Actions column image icon next to the tag to start publishing.

      2. In the Publish Tag dialog box, select the tag version to publish.

        Note

        Before publishing, you can select View Version Comparison to review the differences between versions.

      3. Click Confirm to publish the tag.

    What to do next

    After you create and publish the real-time tag, you can add it to the marketplace for management and use it in tag development projects. For more information, see Manage Tags.