All Products
Search
Document Center

Dataphin:Create real-time tags through metric mapping

Last Updated:Jan 21, 2025

Dataphin tags enable the direct definition of real-time dataset metrics as tags. This guide will walk you through the process of creating real-time tags via metric mapping.

Prerequisites

Before creating real-time tags through metric mapping, ensure you have created the corresponding real-time dataset. 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

      Choose the entity and entity ID necessary for processing the real-time tag.

      Tag Type

      Categorize tags based on their processing method.

      • Attribute Tag: Describes objective facts and is a fundamental tag for profiling entities, such as gender and name tags.

      • Statistical Tag: Created based on business requirements by statistically analyzing entity behaviors or attributes, like the purchase amount over the last 7 days.

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

      • Composite Tag: Formed by applying specific rules to combine tags, such as consumer segmentation tags.

      Timeliness

      Defines the update frequency of tags as time progresses, distinguishing between dynamic and static tags.

      • Static Tag: Typically represents an entity's inherent characteristics that do not change over time, such as gender and name.

      • Dynamic Tag: Updated dynamically with time to maintain tag validity, like the order amount in the last 7 days.

      Owner

      Select the owner of the real-time tag.

    • Technical Attribute

      Tag Update Method: Supports only the Real-time Update Method and is not modifiable.

    • Processing Logic

      Parameter

      Description

      Dataset

      Select the required real-time dataset for processing.

      Primary Key

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

      Tag Definition

      Define the tag by selecting the column name, and input the corresponding tag name and tag code. Supports both individual and batch additions.

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

        • Metric Name: Choose the data column to define.

        • 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, the table from the source dataset will be used.

          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: No need to fill in. The system will automatically detect the value type based on your column name type.

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

        • Tag Description: Provide a brief description of the tag, within 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 show that a submitted tag version has referenced 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.

    Once the real-time tag is created, it must be published to be utilized effectively.

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

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

      Note

      Prior to publishing, you can select View Version Comparison to review the details and differences between versions, ensuring accuracy before proceeding.

    3. Press Confirm to complete the tag's publication.

What to do next

Once you have created and published the real-time tag, you can add it to the marketplace for management purposes and utilize it in future tag development projects. For more information, see Manage Tags.