Google Tag Manager setup

Install the official template

The version 2 Web template requires the publishable Installation Token from Workspace → Setup & Attribution. It never uses a raw workspace ID as browser identity.

Import and configure

1. In Google Tag Manager, open Templates → New → Import and choose the downloaded linkube-conversion.tpl file.
2. Create a new tag and select Linkube Conversion Tracking.
3. Paste the publishable Installation Token shown in Linkube.
4. Set a stable Event ID from your order, transaction, or application event identifier.
5. Set the Event Name, and optionally map Value, Currency, and Custom Data from Data Layer variables.
6. Choose the trigger that represents a completed conversion.
7. Preview the container, confirm the tag succeeds, and publish.

Template fields

Installation Token, Stable Event ID, and Event Name are the core inputs. Value is optional, Currency defaults to USD, and Custom Data accepts optional key-value pairs. The template reads lkid from the URL or Linkube first-party cookie and loads the canonical token-aware pixel only once per page.

Legacy cutover

If Setup & Attribution reports a legacy installation, create the token, replace the old template with version 2, bind Stable Event ID to the order/transaction identity, publish and validate the container, then disable legacy ingestion early. During the displayed bounded grace both paths can operate; after the deadline raw workspace calls return LEGACY_UPGRADE_REQUIRED. Historical events remain intact.