All Products
Search
Document Center

Dataphin:Tag management

Last Updated:Mar 24, 2025

Once you have created offline or real-time tags or real-time tags, you can manage them through various operations. This topic describes the operations that are supported for these tags.

View tag details

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

  2. Select Project from the top menu bar.

  3. In the left-side navigation pane, select Tag Processing > Offline Tag or Realtime Tag.

  4. In the offline tag list or real-time tag list click the tag name of the target tag to open the Tag Details panel.

  5. In the Tag Details panel, under the Basic Information tab, you can view the business and technical attributes, processing logic, associated lookup table details, and downstream dependency information for the tag, along with carry out related configurations.

    Area

    Description

    Business Attribute

    Supports viewing or editing the business attributes of the tag.

    • View: You can view the associated entity, entity ID, tag type, timeliness, owner, and description information of the tag.

    • Edit: Click Edit Business Attribute to edit the business attributes of the tag. This includes the tag name, tag type, timeliness, owner, and tag description.

    Technical Attribute

    Supports viewing the technical attributes of the tag. Different tag types display different information.

    Offline Tag: You can view the tag distribution display, update method, online service, data update time, and processing method information.

    Realtime Tag: You can view the update method, online service, and processing method information.

    Management Attribute

    View the various management attributes of the tag.

    Associated Lookup Table Information

    For Offline Tag, if the Source Dataset or Behavior Relationship field of the tag has a configured lookup table, you can view the associated lookup table information or view details. Additionally, for composite tags, you can view the latest version lookup table generated by the system.

    Details include the name of the lookup table, lookup table description (code value, code name). You can view up to 200 code values.

    Processing Logic

    Supports viewing the processing logic of the tag. Different processing methods display different information.

    Offline Tag: Supports Preview or Edit Processing Logic.

    • Metric Mapping: Includes version, dataset, entity ID field, dataset metric, metric value type, metric description.

    • Rule Combination: Includes version, value type, tag value name, tag value description, configuration condition.

    • Behavior Preference: Includes version, behavior relationship, behavior time, behavior preference, filter condition.

    • Behavior Statistics: Includes version, behavior relationship, behavior time, statistical object, statistical method, filter condition.

    • Calculated Tag: Includes version, value type, and tag configuration.

    Realtime Tag: Supports entering the primary key value for Testing (except metric mapping) or Edit Processing Logic.

    • Metric Mapping: Includes version, dataset, entity ID field, dataset metric, metric value type, metric description.

    • Rule Combination: Includes version, value type, configuration condition.

    • Expression Creation: Includes version, value type, tag configuration.

    Downstream Dependency

    If the current tag is dependent on by downstream audience groups or tags, you can view the specific audience groups and tags in the downstream dependency area.

Enable or disable online service for offline tags

Enable online service

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

  2. Select Project from the top menu bar of the workbench page.

  3. In the left-side navigation pane, select Tag Processing > Offline Tag.

  4. On the Offline Tag page, you can activate online service for individual tags or for multiple tags simultaneously in batch.

    • Enable online service for a single tag: Click the switch in the Online Service column of the target Published or Listed, and not enabled online service tag.

    • Enable Online Service in Batch:

      1. Select multiple Published or Listed, and not enabled online service tags from the offline tag list. Alternatively, click Select All On This Page at the bottom to select all tags on the current page. Ensure that your selection includes Published or Listed, and not enabled online service tags.

      2. Click the image icon at the bottom of the list and select Enable Online Service In Batch.

  5. In the pop-up dialog box, click Confirm . Once the tag has successfully activated the online service, the switch in the corresponding tag's online service column will indicate an enabled state.

    After enabling online service, you can use the offline tag to create an online service in the application or develop real-time tags in the workbench project through rule combinations.

Disable online service

  1. On the Offline Tag page, you can disable the online service for a single tag or for multiple tags simultaneously.

    • Disable online service for a single tag: Click the switch in the Online Service column next to the relevant Published or Listed tag that has online service enabled.

    • Disable Online Service in Batch:

      1. Select multiple Published or Listed, and enabled online service tags from the offline tag list. Alternatively, click Select All On This Page at the bottom to select all tags on the current page. Ensure that your selection includes Published or Listed, and enabled online service tags.

      2. Click the image icon at the bottom of the list and select Disable Online Service In Batch.

  2. Before disabling online service, the system will perform a Dependency Check.

    • If none of the selected tags have dependencies, a secondary confirmation dialog box will appear. Click Confirm to disable the online service.

    • If any selected tags have dependencies, open the Dependency Check dialog box. Here, you can view the tags and profile services that each dependent tag relies on in real-time. You can also click Disable Online Service For Tags Without Dependencies.

  3. After the tag successfully disables online service, the switch in the corresponding column will show the disabled state.

List tags

  1. On the Offline Tag or Realtime Tag page, click the Project Tags tab. You can list a single tag or multiple tags in batch in the tag list below.

    • Listing a Single Tag: Click the Published or Listing Failed tag in the Actions column image icon to open the Tag Listing Request dialog box.

    • Batch Listing:

      1. Select multiple tags with the status of Published or Listing Failed in the offline/real-time tag list, or click Select All On This Page at the bottom to select all tags on the current page (among all selected tags, must include published or listing failed tags).

      2. Click Batch Listing at the bottom of the list.

  2. In the Tag Listing Request dialog box, select the market and category for your listing, and provide the submission remarks.

    Parameter

    Description

    Listing Market

    You can choose to list in the public market or private market, which are approved by the public market administrator or private market administrator, respectively. If there is no corresponding market, you can create the corresponding market. For more information, see create a market.

    Category

    The category to which the tag belongs in the market. If there is no corresponding category, you can go to the corresponding market to create the required category. For more information, see create a market category.

    Submission Remarks

    Fill in the application information, which will be seen by the approver when approving the application.

  3. Click Confirm and Submit.

    After clicking confirm and submit, the system will automatically check whether the current selected tags have duplicate definitions in the target market. If no duplicate definitions are found, the detection will be completed and automatically submitted; if there are duplicate definitions, enter the Duplicate Definition Detection Dialog Box. You can view each duplicate definition tag in the duplicate definition detection dialog box, and you can click List All to list all selected tags (regardless of whether there are duplicate definitions); or you can click List Non-duplicate Tags to only list the selected tags with no duplicate definitions.

Delist tags

  1. On the Offline Tag or Realtime Tag page, click the Project Tags tab. You can then remove a single tag or multiple tags in batch from the list below.

    • Delist a Single Tag: Click the Listed tag you want to remove in the Actions column, then select the image icon.

    • Batch Delisting:

      1. Select multiple tags marked as Listed or Delisting Failed in the offline/real-time tag list. Alternatively, you can click Select All On This Page at the bottom to choose all tags on the current page, ensuring that your selection includes tags that are either listed or delisting failed.

      2. Click the Batch Delisting at the bottom of the page.

  2. Before delisting, the system will automatically perform a Dependency Check.

    • If none of the selected tags have dependencies, a secondary confirmation dialog box will appear. Click Confirm to access the Tag Delisting Request dialog box.

    • If any selected tags have dependencies, open the Dependency Check dialog box. Here, you can see which projects and applications are associated with each dependent tag. To remove tags that have no dependencies, click Delist Tags Without Dependencies.

  3. In the Tag Delisting Request dialog box, enter your Submission Remarks and click Confirm to finalize the tag's delisting.

Publish tags

  1. On the Offline Tag or Realtime Tag page, click the Project Tags tab. You can then publish a single tag or multiple tags in batch from the list below.

    • Publish a Single Tag: To publish a tag, click the Pending Publication or Publication Failed tag in the Actions column. Then, click the image icon to open the Publish Tag dialog box.

    • Batch Publishing:

      1. Select multiple tags with the status of Pending Publish or Publish Failed in the offline/real-time tag list, or click Select All On This Page at the bottom to select all tags on the current page (among all selected tags, must include pending publish or publish failed tags).

      2. Click the Batch Publish button at the bottom of the list.

  2. In the pop-up dialog box, click Confirm .

    The system will automatically select the latest submitted version for batch publishing. Tags without the latest version, tags the current user does not have permission to operate, or published tags with downstream service dependencies will be ignored.

    • Tags without the latest submitted version will be ignored.

    • Tags that the current user does not have permission to operate will be ignored.

    • Published tags with downstream service dependencies will be ignored during batch publishing.

Unpublish tags

  1. On the Offline Tag or Realtime Tag page, click the Project Tags tab. Below the tab, you can either unpublish a single tag or unpublish multiple tags in batch.

    • Unpublish a Single Tag:

      Offline tag: Click the target Published or Unpublish failed, and if the Online service is Shutdown or Failed to start, use the Actions column image icon.

      Real-time tag: Click the desired Published or Unpublish failed tag in the Actions column image icon.

    • Batch Unpublishing:

      1. Select multiple tags marked as Published or Unpublish Failed from the offline/real-time tag list (ensure offline tags have Online Service set to Disabled or Enable Failed). Alternatively, you can click Select All On This Page at the bottom to choose all tags on the current page, which must include tags that are either Published or have Unpublish Failed.

      2. Click Batch Unpublish at the bottom of the page.

  2. Before unpublishing the tag, the system will automatically perform a Dependency Check.

    • If all selected tags have no dependencies, a secondary confirmation dialog box will appear. Click Confirm to finalize the tag's unpublishing.

    • If any selected tags have dependencies, open the Dependency Check dialog box. Here, you can see which tags and audience groups are required for each dependent tag. To proceed, click Unpublish Tags Without Dependencies .

Manage tag versions

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

  2. Select Project from the top menu bar.

  3. In the left-side navigation pane, select Tag Processing > Offline Tag or Realtime Tag.

  4. On the Offline Tag or Realtime Tag page, click the Project Tags tab. Below, in the tag list, click the Actions column next to the desired tag's image icon to access the Tag Details panel.

  5. Within the Tag Details panel's version list tab, you can view the list of created tag versions. This includes details such as Version Number, Version Description, Version Status, Running Status (applicable only to offline tags), Last Updated By, among other information.

  6. (Optional) Filter the target version by selecting Version Number and Version Status.

  7. Perform the following operations in the version list:

    Operation

    Description

    Edit Version Description

    Click the Version Description column's image icon to edit the version description of the current tag.

    Edit

    Click the Actions column of the target version image icon to navigate to the Edit Processing Logic page for editing.

    Note

    Only when the version status is Editing or Submission Failed, the edit operation is supported.

    Details

    Click the ActionsimageTag Details icon in the column of the target version to view the processing logic of the current version tag in the panel.

    Test

    Click the ActionsimageTest Primary Key Value Authenticate icon in the column of the target version, fill in the in the dialog box, and click .

    Note
    • Only the Editing status of Realtime Tag supports the test operation.

    • The Editing version can only be submitted after passing the test.

    Version Comparison

    Click the ActionsimageVersion Comparison icon in the column of the target version to jump to the page, where you can compare this version with other versions and view the information and differences between them. The differences will be highlighted.

    Submit

    Click the Actionsimage icon in the column of the target version to submit the current version.

    Note
    • Only when the version status is Editing, the submit operation is supported.

    • The number of versions with the status Submitted cannot exceed 2.

    View Instance

    Click the Actions column of the target version image icon to navigate to the View Instance page to view the instance list.

    Note

    Only when the version status is Submitted, the view instance operation is supported.

    Data Backfill

    Click the ActionsimageData Backfill icon in the column of the target version and select .

    Note

    Only when the tag version status is Submitted, the data backfill operation is supported.

    Rollback to This Version

    You can perform a rollback operation for historical versions. Click the Actions icon in the target version's image column. Select Rollback To This Version. In the dialog box that appears, click OK. After clicking OK, the rollback will begin. The system will automatically save this version and redirect to the Edit Processing Logic page.

    • If the status of the latest version is Editing or Submission Failed, it will be overwritten and edited.

    • If the status of the latest version is Submitted, Revoked, Revoking, Revoke Failed, a new version will be generated based on the version information to be rolled back.

    Note

    Rollback will overwrite the editing version and cannot be undone, please proceed with caution.

    Revoke

    Click the ActionsimageRevoke Confirm Revoked icon in the column of the target version and select . In the pop-up dialog box, click . After the revocation is completed, the version status will be .

    Note
    • Only when the tag status of the current tag is not Published, and the current version status is Submitted, the revoke operation is supported.

    • If the version tag has been used, the revoke operation is not supported.

    Delete

    Click the ActionsimageDelete Confirm icon in the column of the target version and select . In the pop-up dialog box, click .

    Note

    Only when the current tag has multiple versions, and the target version status is Editing and Revoked, the delete operation is supported.

Remove tags

  1. On the Offline Tag or Realtime Tag page, click the Applied Tags tab. You can then remove a single tag or multiple tags in batch from the list below.

    • Remove a Single Tag: Click the Actions image icon in the column corresponding to the tag you want to remove.

    • Batch Removal:

      1. Select multiple tags from the list of applied tags, or click Select All On This Page at the bottom to choose all tags on the current page.

      2. Click Batch Remove at the bottom of the page.

  2. Before removing the tag, the system will automatically perform a Dependency Check.

    • If none of the selected tags have dependencies, a secondary confirmation dialog box will appear. Click Confirm to finalize the tag removal.

    • If any selected tags have dependencies, open the Dependency Check dialog box. Here, you can see which tags and audience groups are associated with each dependent tag. To proceed, click Continue Removing Tags Without Dependencies.