All Products
Search
Document Center

Quick Audience:User Tags

Last Updated:May 28, 2025

Configure the user tag table structure to import the user tag table data.

The user tag table records a series of characteristic attributes of a user. You can configure tag aliases for fields to add tags to users. When you use tags, you are essentially using the corresponding fields. Based on user tag data, you can create a User Profile for Perspective Analysis and Audience Filtering.

After the tag is imported, the tags in the user tag table are displayed in the Tag List section. The administrator can perform corresponding operations or authorize other users to manage and use tags.

Prerequisites

  • The user tag table is stored in the Computing Source that you configured. For data format, see User Tag Table Data Requirements.

  • Make sure that all user ID types in your user tag table are in the ID Type List of this workspace.

  • If the user ID field has been encrypted by AES, enter the key in the Organization System Configuration to decrypt it before pushing or using it.

  • To build a basic user information system, set the type of user information stored in the table to User Attributes. This way, you can associate fields with attributes during import.

Procedure

  1. Choose Workspace> Configuration Management > Data Import > Data Import > Table Structure Configuration. image

  2. In the upper-right corner, choose Create Table Configuration > User Tag. The Create User Tag page appears.

  3. Select the computing source and data table that you want to import. 25

    You can select a table or a view for the data table.

    • If you select Table, the system automatically identifies whether the table contains time partitions.

      • If the table contains time partitions, select the Time Partition field and enter the format of the partition value. The following figure shows the supported formats. 324

      • If the table does not contain time partitions, you do not need to select them.

    • If you select View, you need to manually select whether to include time partitions.

      • If the view contains time partitions, select the Time Partition field and enter the format of the partition value. The supported formats are shown in the preceding figure.

      • If the view does not contain time partitions, you do not need to select them.

    If the current account does not have the read permission on the table you selected, an error message appears, as shown in the following figure. In the MaxCompute project, grant the read permissions on the data table to the Quick Audience account. Click Authorize SQL in the following figure to obtain the authorization statement. After the authorization is complete, click Update to continue the configuration. 2643

  4. Enter a data table alias to set an alias for the data table.

    Note

    The tag source information on the Tag Management and Pivot Analysis pages is displayed as the table alias.

    image

  5. Set the user identification field and user identification type.

    • A user identifier is the unique identifier of a user in the table and can uniquely identify a user. A table cannot contain two rows of data with the same user identifier. The user identification will be 3represented by an icon.

    • The user identity type is the ID type corresponding to the user identity.

  6. In the field list, turn off the Import switch for fields that do not need to be imported. When disabled, the field cannot participate in any application and can be opened later during editing.

  7. Set the tag alias and tag type for the fields to be imported, set the ID type and ID encryption method for the ID field, and set the attribute mapping, tag category, and tag description for the non-ID field.

    • The tag alias is the name displayed when the field is subsequently used.

    • Attribute Mapping: An attribute refers to a User Attributes, which specifies the basic information system of a user. If a field stores a user attribute value, select the user attribute to be mapped for the field and associate them. After you field mapping a user property, the tag aliases are no longer displayed in operations such as tag filtering. Only the mapped user property names are displayed.

      Note

      If the user tag table has set the field name as the attribute code of the user attribute, the field will be automatically identified and mapped to the corresponding user attribute and can be modified.

    • If the tag type is multi-value, you must enter the separator on the right and cannot select the ID type, as shown in the following figure. image

    • When you configure a tag category, click Manage Tag Category in the drop-down list. In the dialog box that appears, you can modify the tag category. For more information, see Tag Category Management.

  8. Click Complete.

After you configure the table structure, you must configure a scheduling task to import data. For more information, see Scheduling Task. For more information about how to manage table structures, see Table Structure Configuration Management.

Tag category management

When you set tag categories, click Manage Tag Category in the drop-down list. The following figure shows the pop-up window. 6

  • Click the + icon next to a category to add a category. To add a second-level or third-level category, you must first select a parent category as the parent category.

  • Click an existing category. Its subcategories are displayed, and the 1and 2icons appear. You can click them to edit and delete them respectively.

  • The Unclassified category is the default category. All unclassified tags belong to the Unclassified category. If you delete a category, the tags in the category are added to the Unclassified category.