Kentico.Xperience.TagManager 3.2.1

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package Kentico.Xperience.TagManager --version 3.2.1                
NuGet\Install-Package Kentico.Xperience.TagManager -Version 3.2.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Kentico.Xperience.TagManager" Version="3.2.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Kentico.Xperience.TagManager --version 3.2.1                
#r "nuget: Kentico.Xperience.TagManager, 3.2.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Kentico.Xperience.TagManager as a Cake Addin
#addin nuget:?package=Kentico.Xperience.TagManager&version=3.2.1

// Install Kentico.Xperience.TagManager as a Cake Tool
#tool nuget:?package=Kentico.Xperience.TagManager&version=3.2.1                

Xperience by Kentico Tag Manager

7-day bug-fix policy CI: Build and Test NuGet Package

Description

Tag Manager integration enabling marketers to include prebuilt and custom tags into a website channel. By default we provide support for the following tags:

Screenshots

UI Application

Custom tags listing

Create GTM tag snippet

Create custom code snippet

Library Version Matrix

Xperience Version Library Version
>= 29.0.0 >= 3.0.0
>= 28.3.1 >= 2.0.0
>= 28.1.0 >= 1.0.0

Dependencies

Package Installation

Add the package to your application using the .NET CLI

dotnet add package Kentico.Xperience.TagManager

Quick Start

  1. Include Kentico.Xperience.TagManager project in the solution.

    dotnet add package Kentico.Xperience.TagManager
    
  2. Register required services into DI container.

    // Program.cs
    
    var builder = WebApplication.CreateBuilder(args);
    
    // ...
    
    builder.Services.AddKenticoTagManager(builder.configuration);
    
  3. In the administration go to UI application 'Tag Management'.

  4. Create a new record:

    • Fill in a tag name
    • Select one of the channels.
    • Select whether you want to use Custom Code Snippet or other Snippet type
    • We have prepared some of the most often used types:
      • For
        • 'Google Tag Manager',
        • 'Google Analytics 4',
        • 'VWO',
        • 'Intercom',
        • 'Microsoft Clarity',
        • or Your own type
      • select one of these options from the Snippet type dropdown
    • For 'Custom code snippet' fill in entire code you want to render.
      • Select a location:
        • Top of the head - inserts a script immediately after the opening head tag.
        • Bottom of the head - inserts a script right before the closing head tag.
        • Top of the body - inserts a script immediately after the opening body tag.
        • Bottom of the body - inserts a script right before the closing body tag.
    • Select tag location within the rendered page HTML
    • Fill in a consent if required.
    • Check 'Enable tag rendering' to activate the tag or uncheck to deactivate
    • Select whether you want to display tags in the Xperience administration preview or Page Builder, or both. This option defaults to None.
  5. During rendering the livesite page, the Tag manager module automatically adds custom code snippets with accepted consents to defined locations.

  6. To dynamically update the rendered code snippets, for example if a consent is accepted, call javascript function window.xperience.tagManager.updateCodeSnippets().

Contributing

To see the guidelines for Contributing to Kentico open source software, please see Kentico's CONTRIBUTING.md for more information and follow the Kentico's CODE_OF_CONDUCT.

Instructions and technical details for contributing to this project can be found in Contributing Setup.

License

Distributed under the MIT License. See LICENSE.md for more information.

Support

7-day bug-fix policy

This project has Full support by 7-day bug-fix policy.

See SUPPORT.md for more information.

For any security issues see SECURITY.md.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.2.2 228 10/29/2024
3.2.1 1,050 7/24/2024
3.2.1-prerelease-1 71 7/24/2024
3.2.0 131 7/16/2024
3.1.1 113 7/12/2024
3.1.0 601 6/18/2024
3.0.0 655 5/13/2024
2.0.1 255 4/10/2024
2.0.0 186 3/21/2024
2.0.0-prerelease2 200 3/20/2024
2.0.0-prerelease1 67 3/18/2024
1.0.2 827 2/1/2024
1.0.1 126 1/30/2024
1.0.0 135 1/26/2024
1.0.0-prerelease-2 80 1/26/2024
1.0.0-prerelease-1 100 1/24/2024