Google Tag Manager

• Subscribing to a paid plan
• Usage expansion (upgrading from one plan to another)

​

Prerequisites

Option 1: On a workspace-level

To enable conversion tracking for all future links in a workspace, you can do the following: To enable conversion tracking for all future links in a workspace, you can do the following:

1. Navigate to your workspace’s Analytics settings page.
2. Toggle the Workspace-level Conversion Tracking switch to enable conversion tracking for the workspace.

This option will enable conversion tracking in the Dub Link Builder for all future links.

Option 2: On a link-level

If you don’t want to enable conversion tracking for all your links in a workspace, you can also opt to enable it on a link-level.To enable conversion tracking for a specific link, open the Dub Link Builder for a link and toggle the Conversion Tracking switch.

You can also use the C keyboard shortcut when inside the link builder to quickly enable conversion tracking for a given link.

Option 3: Via the API

Alternatively, you can also enable conversion tracking programmatically via the Dub API. All you need to do is pass trackConversion: true when creating or updating a link:

Node.js

Python

Go

Ruby

Copy

Ask AI

const link = await dub.links.create({
  url: "https://dub.co",
  trackConversion: true,
});

​

Set up Dub Analytics in Google Tag Manager

​

Step 1: Add Dub Analytics Script to GTM

<script>
  !(function (c, n) {
    c[n] =
      c[n] ||
      function () {
        (c[n].q = c[n].q || []).push(arguments);
      };
    ["trackClick", "trackLead", "trackSale"].forEach(
      (t) => (c[n][t] = (...a) => c[n](t, ...a))
    );
    var s = document.createElement("script");
    s.defer = 1;
    s.src = "https://www.dubcdn.com/analytics/script.conversion-tracking.js";
    s.setAttribute("data-publishable-key", "dub_pk_xxxxxxxx"); // Replace with your publishable key
    document.head.appendChild(s);
  })(window, "dubAnalytics");
</script>

​

Step 2: Tracking sales events

• Order Confirmation Page Tracking (Recommended)
• Checkout Form Submission Tracking

​

Option 1: Order Confirmation Page Tracking (Recommended)

<script>
  (function () {
    // Get query parameters from URL
    var params = new URLSearchParams(window.location.search);
    var customerId = params.get("customer_id");
    var amount = params.get("amount");
    var invoiceId = params.get("invoice_id");

    // Only track if customer ID and amount are present
    if (customerId && amount) {
      // Track the sale event
      dubAnalytics.trackSale({
        eventName: "Purchase",
        customerExternalId: customerId,
        amount: parseInt(amount), // Amount in cents
        invoiceId: invoiceId || undefined,
        currency: "usd", // Customize as needed
        paymentProcessor: "stripe", // Customize as needed
      });
    }
  })();
</script>

• Trigger Type: Page View
• This trigger fires on: Some Page Views
• Add conditions like:
  • Page URL contains /order-confirmation
  • Or Page Path equals /checkout/success
  • Or whatever URL pattern matches your order confirmation pages

​

Option 2: Checkout Form Submission Tracking

<script>
  (function () {
    // Get checkout data - customize these selectors based on your form
    var customerId = document.getElementById("customer_id")
      ? document.getElementById("customer_id").value
      : "";
    var amount = document.getElementById("amount")
      ? document.getElementById("amount").value
      : "";
    var invoiceId = document.getElementById("invoice_id")
      ? document.getElementById("invoice_id").value
      : "";

    // Only track if customer ID and amount are present
    if (customerId && amount) {
      // Track the sale event
      dubAnalytics.trackSale({
        eventName: "Purchase",
        customerExternalId: customerId,
        amount: parseInt(amount), // Amount in cents
        invoiceId: invoiceId || undefined,
        currency: "usd", // Customize as needed
        paymentProcessor: "stripe", // Customize as needed
      });
    }
  })();
</script>

• Trigger Type: Form Submission
• This trigger fires on: Some Forms (or All Forms if you want to track all form submissions)
• Add conditions to specify which forms should trigger sales tracking (e.g., checkout forms)

​

Testing your setup

1. Enable Preview Mode: In your GTM workspace, click the Preview button in the top right corner
2. Enter your website URL and click Connect
3. Test your chosen tracking method:
   • For Option 1 (Order Confirmation): Navigate to your order confirmation page with query parameters (e.g., ?customer_id=123&amount=1000&invoice_id=inv_456)
   • For Option 2 (Form Submission): Navigate to a checkout page and complete a test purchase form
4. Check the GTM debugger to see if your tags are firing correctly

​

Verify sales tracking

1. Checking your browser’s developer console for any JavaScript errors
2. Using the Network tab to see if requests are being sent to Dub’s analytics endpoint
3. Viewing your Dub dashboard to confirm that sale events are appearing in your analytics

​

Common troubleshooting tips

• Tag not firing: Check that your triggers are configured correctly and that the conditions match your page structure
• Form data not captured (Option 2): Verify that your DOM selectors match your actual checkout form field IDs or names
• Query parameters missing (Option 1): Ensure your checkout process redirects to the confirmation page with the required query parameters
• Amount formatting: Ensure amounts are in cents (e.g., $10.00 = 1000 cents)
• Multiple events: Make sure your tags aren’t firing multiple times by checking trigger conditions
• Duplicate tracking: Verify you’ve only implemented one tracking method (Option 1 OR Option 2, not both)
• Missing publishable key: Ensure you’ve replaced the placeholder with your actual publishable key

​

View conversion results

• Time-series: A time-series view of the number clicks, leads and sales.

• Funnel chart: A funnel chart view visualizing the conversion & dropoff rates across the different steps in the conversion funnel (clicks → leads → sales).

• Real-time events stream: A real-time events stream of every single conversion event that occurs across all your links in your workspace.