Tag Manager : Administration
Administration that manages the registration of HTML tags in a centralized manner. For your tags to be imported into a web page, simply click on the button Get HTML inclusion code
, which will provide a single Javascript code to be imported into your web page, and this will be responsible for dynamically importing the tags from this administration.
When an update is made, such as the registration of a new tag, editing, or deletion, it is necessary to click the Publish
button for the changes to be reflected on your page.
Service Requirements
For the service to function correctly, it is necessary that:
- Your instance is within a channel tree that has an project and website associated.
-
The CORS Rules settings to allow GET access to the scripts
/data/lumis/service/tagmanager/<serviceInstanceId>/ltm.js
,/data/lumis/service/tagmanager/<serviceInstanceId>/ltmimpl.js
and/lumis/service/tagmanager/<serviceInstanceId>/ltmimplpreview
for all origins you wish to allow to use this service, where<serviceInstanceId>
is the identifier of the service instance of Tag Manager to be used. By default, the environment already comes with these settings.
Tag Types
The options for tag types in the registration are:
- Include Monitoring API
-
A block of HTML will be included that will include the necessary scripts for the Javascript Monitoring API to be available for use on the page. It is important that a tag utilizing this API be inserted after this tag. For this, the
position
field should be used to order the tags so that this tag comes before the tag using the API. - Track Page Views
-
An HTML block will be included that logs the page view event as soon as possible. For this tag to work correctly, it is necessary to include the LumisXP Monitoring Javascript API. To do this, simply add a tag of type
Include Monitoring API
with theposition
field set to a value less than the position of this tag, in the same administration. - Custom
-
This option allows the registration of HTML snippets, including Javascript or CSS. For example, it is possible to register:
Trigger Type
This field is used to choose whether the tag will be imported. Its options are:
- All Pages
- With this option, the registered tag will always be imported on the pages that are being managed by this service instance.
- Custom
-
When selecting this option, the JavaScript Trigger Code field becomes available. In it, a Javascript code must be written that returns a boolean expression indicating whether the tag should be applied or not.
For example, imagine a site where each page has a global javascript variablewindow.category
. Then, for the JavaScript Trigger Code field, the valuewindow.category == "news"
can be registered. Thus, the tag will be imported only on the pages where this condition is true.
A more complex code can also be used, with multiple lines. Just ensure that the last expression is boolean. For example:
Features
- It is an administration interface
Screens
Data
Tags
- Name(string) : Name of the tag.
- Tag Type(string) : Choose between registering the default LumisXP tag for event tracking or registering a custom tag.
- Trigger Type(string) : Type of filter that will make the tag apply.
- Position(integer) : The field is used to define in which order the tags will be imported on the client side.
- Description(text) : Textual description of the tag.
- Category(identifier)
- Last Modification(date and time)
- Status(string)
- Responsible(string)
Tag Category
- Name(string) : Name of the tag.
Links
- Add
- Edit
- Order
- Get HTML inclusion code (Get the HTML inclusion code)
Permissions
- Edit service instance content: Allows managing all data of this service instance with publisher profile.
Actions
-
Enable preview mode in this browser:
Allows the publisher to see how the currently enabled tags behave, without needing to publish them to end users. After enabling this mode, it is necessary to add the parameter
lum_TM<ServiceInstanceId>PreviewMode=true
in the URL of the page where you wish to preview. For example, if you want to preview the currently enabled tags on the pagehttps://example.com/news/
, the URLhttps://example.com/news/?lum_TM<ServiceInstanceId>PreviewMode=true
should be accessed.
The<ServiceInstanceId>
part of the parameterlum_TM<ServiceInstanceId>PreviewMode=true
will be the identifier of the service instance of the Tag Manager. The administration itself will provide such parameter when enabling the preview mode.
-
Publish:
After registering, editing, or deleting tags, it is necessary to perform the "Publish" action for the tags to be made available to all users. It may take a few minutes for the changes to become effective for all users.
-
Delete:
Deletes a tag.