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
Navigate to the Dataphin home page, select Tag > Workbench from the top menu bar.
Choose Project from the top menu bar.
In the left-side navigation pane, click Tag Processing > Realtime Tag. On the Realtime Tag page, select Add Tag.
In the Add Realtime Tag dialog box, choose Registered Tag to access the Create Metric Mapping page.
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.
NoteClick
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:
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.
NoteThe 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.
Click Confirm. The selected metrics will populate the tag definition list.
To remove metrics, click the Actions column
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.NoteMetric 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.
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.
In the list of real-time tags, click the Actions column
icon next to the desired tag to initiate the publishing process.In the Publish Tag dialog box, choose the tag version to publish.
NotePrior to publishing, you can select View Version Comparison to review the details and differences between versions, ensuring accuracy before proceeding.
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.