Add a New Tag (Browser)
Last updated
Last updated
You can add a new tag to capture browser or client-side data. This helps in tracking specific user interactions or behaviors based on browser activity.
To add a new Tag for browser/client-side, perform the following steps:
Step 1: Select Tags from the left navigation panel.
Step 2: Click the Add Tag dropdown in the top right, then select For Browser from the list.
Step 3: The Select Provider panel opens on the right side. You can choose a provider from the list or use the search bar to find and select a provider.
After selecting a provider, the Tags screen opens.
Step 4: Select Trigger
Step 4.1: In Triggers, click Choose Trigger.
Step 4.2: The Choose Triggers panel opens with two tabs:
User-Defined: Displays custom triggers created by users.
Default: Contains predefined system triggers.
Step 4.3: Select a trigger from the list or use the search bar to find and select a trigger.
Note: Multiple triggers can be selected.
Step 4.4: Click Done.
The selected trigger appears on the Triggers screen.
Note 1: You can remove the selected trigger by clicking the Clear button or click the small cancel icon next to each trigger to remove them individually.
Note 2: If mandatory details are not filled in, the following warning message gets triggered:
Step 5: Qualification Criteria (Optional)
The Qualification Criteria are the conditions/triggers that inform Ingest Labs when to trigger a particular tag. You can add multiple Qualification Criteria, and these criteria are layered.
Step 5.1: Click Qualification Criteria (Optional).
Step 5.2: The Qualification Criteria panel opens on the right side.
Select a qualification criterion from the list or use the search bar to find and select one.
You can select multiple qualification criteria.
Step 5.3: Click Done.
The selected qualification criteria appear on the Qualification Criteria (Optional) screen.
Note: You can click Clear to remove all selected qualification criteria at once, or click the small cancel icon next to each one to remove them individually.
Step 6: Tag Info
You can set the tag name and validity period. The default validity period is one year for any new tag and can be set to any desired date. To understand tag validity or expiry, see the section Set the Validity period and Tag Expiry.
Step 6.1: Name: The Tag name.
Step 6.2: Validity Period: Denotes the Tag Validity period including Start Date and End Date.
Set Validity and Tag Expiry
While creating a tag in Tag Manager, you can set the validity period of a particular tag and define its expiry. The default validity period is one year for any new tag and can be set to any desired date. When the expiry date is close, you will receive a reminder e-mail notification about the tag expiry. If no action is taken, the tag stops triggering post the set validity period.
See ExpirationAlarm for more information.
Step 7: Set Provider Attributes
The Provider is a mandatory setting while adding a new tag. You can add any number of Provider attributes using the Key-Value pair and configure the settings using the Settings option. For a particular Provider attribute, you must set the value either from the Data Elements or Transformers. The user can view the provider attributes added from Provider side configuration.
Step 7.1: If you do not set the mandatory values, the following message appears:
Step 7.2: After selecting either from the Data Element or Transformer, the value appears in the Value column.
Step 8: Set Tag Attributes
To add Attributes, select Add Attributes and set the following values.
Step 8.1: Name: Set the Attribute name. For example: visitor_id, user_id, and so on.
Step 8.2: Value: Set the value either for the Data Element or Transformer.
JSON: Enter the Attribute name and value, and configure the Settings.
Mandatory - Denotes the value to be mandatory.
Ignore If Empty - Ignore the field if empty.
Hash (SHA256) - denotes the value in the HASH format.
Static: Denotes the static Value that is known.
Step 8.3: Attribute Settings
Enter the Attribute Settings.
Step 8.4: Tool-tip! Select the Mandatory check box to display the Fatal check box.
Step 8.5: Set the Data Type Conversion using the following options.
No Conversion
Indicates that there is no conversion required for the data type.
Convert to Boolean
Converts the input data to Boolean.
Convert to Number
Converts the input data to Number.
Convert to Array
Converts the input data to Array.
Convert to Object Spread
Converts the JSON attributes under a parent level attribute to the root level attributes.
Step 8.6: Select one of the following Transformer types and click Confirm.
URL encode
Converts the URL in the encrypted format.
HASH (SHA256)
The value is converted to HASH (SHA256) format.
Ignore if empty
May be ignored if the value is empty.
Step 8.7: Select the Ignore Redaction checkbox to display the data elements. Redaction is a setting for each data element, which allows the server-side processing to apply the redaction strategy - like anonymize for email.
Step Result: The Provider Attribute is created.
To delete the Provider Attribute, select the Delete icon at the right-hand corner of the screen.
Step 9: Denote the Script.
The Script denotes the code script if available for the tag. Select the No Script check box if the script is unavailable.
