Freshpaint
HomeLogin
  • Documentation
    • What is Freshpaint?
    • ⚕️HIPAA Mode
    • 🏗️Building Out Your Account
    • 🌐Overview of Features
    • Guides
      • 📡Add Autotrack to your website to collect data from your users
        • Installing the Freshpaint Javascript SDK
        • Installing the Freshpaint SDK with a Content Security Policy (CSP)
        • Installing the Freshpaint Javascript SDK with Server-Side Rendering (SSR) + React
        • Autocapture + React
        • Configuring a Destination
        • Labeling User Actions
        • How do I install Freshpaint with Typescript?
      • 🔁Send historical data to any destination with Time Machine
      • Next.js Quickstart Guide
      • Android Quickstart Guide
        • Installing the Freshpaint Android SDK
        • Configuring a Destination
        • Instrumenting Your App
      • iOS Quickstart Guide
        • Installing the Freshpaint iOS SDK
        • Configuring a Destination
        • Instrumenting Your App
      • React Native Quickstart Guide
        • Installing the Freshpaint React Native SDK
        • Configuring a Destination
        • Labeling User Actions
        • Configuring Property Capture
    • Setting up Properties
    • Setting up Your Destinations
      • Enabling and Disabling a Destination
      • Deleting a Destination
    • Setting up Your Events
    • User Identification
      • Designated Identify Properties
    • Maps
    • Analytics (Beta)
      • Web Analytics Dashboard
      • Campaigns
      • Service Lines
      • Data Glossary
    • Translations
    • Web Tracker Monitoring
      • Tracker Resolution Types
      • Historical Scans
  • Integrations
    • Destinations
      • Demand Side Platforms (DSPs)
        • Basis
          • Basis Quick Start Guide
          • Basis Reference
        • Google Campaign Manager 360
        • StackAdapt
          • StackAdapt Quick Start Guide
          • StackAdapt Reference
        • theTradeDesk
          • theTradeDesk Quick Start Guide
          • theTradeDesk Reference
          • theTradeDesk with CM360 Configuration Guide
        • Viant
          • Viant Quick Start Guide
          • Viant Reference
      • Direct Response Ads
        • Facebook Conversions API
          • Facebook Conversions API Quick Start Guide
          • Facebook Conversions API Reference
        • Google Ads Conversion API
          • Google Ads Conversion API Quick Start Guide
          • Google Ads Conversions API Reference
        • Google Ads
          • Google Ads Quick Start Guide
          • Google Ads Reference
        • LinkedIn Ads
          • LinkedIn Ads Quick Start Guide
          • LinkedIn Ads Reference
        • Microsoft Ads (formerly Bing Ads)
          • Microsoft Ads Quick Start Guide
          • Microsoft Ads Reference
          • Microsoft Ads Multi-Config Reference
        • Pinterest Ads (Beta)
          • Pinterest Ads Quick Start Guide
          • Pinterest Ads Reference
        • Pinterest Tag
        • Reddit Ads
          • Reddit Ads Quick Start Guide
          • Reddit Ads Reference
        • TikTok Ads
        • Twitter Ads
      • Data Activation
        • ActiveCampaign
          • ActiveCampaign Quick Start Guide
          • ActiveCampaign Reference
        • Amplitude
          • Amplitude Quick Start Guide
          • Amplitude Reference
        • Braze (formerly Appboy)
          • Braze Quick Start Guide
          • Braze Reference
        • Customer.io
          • Customer.io Quick Start Guide
          • Customer.io Reference
        • Freshsales
        • Google Analytics 4 Proxy
          • Google Analytics 4 Proxy Quick Start Guide
          • Google Analytics 4 Proxy Reference
          • Google Analytics 4 Proxy Advanced Tracking Configurations
        • Google Analytics 4 Server-Side
          • Google Analytics 4 Server-Side Quick Start Guide
          • Google Analytics 4 Server-Side Reference
        • Heap
        • Hotjar
        • HubSpot Cloud
        • HubSpot Web
        • impact.com
          • Impact.com Quick Start Guide
          • Impact.com Reference
        • Intercom
          • Intercom Quick Start Guide
          • Intercom Reference
        • Iterable
          • Iterable Quick Start Guide
          • Iterable Reference
        • June
        • Klaviyo
        • Mixpanel
          • Mixpanel Quick Start Guide
          • Mixpanel Reference
        • OneSignal
          • OneSignal Quick Start Guide
          • OneSignal Reference
        • Podscribe (Early Access)
        • Sendinblue
        • Sentry
        • Vero Cloud
        • Webengage
        • Webhooks
        • Woopra
        • Zendesk
      • Data Warehouses
        • Azure Warehouse Setup
        • BigQuery Warehouse Setup
        • Databricks Warehouse Setup
        • Postgres Warehouse Setup
        • Redshift Warehouse Setup
        • S3 Warehouse Setup
        • Snowflake Warehouse Setup
      • Consent Management
        • Osano
        • OneTrust
        • Custom Consent Manager
    • Sources
      • Web
        • Autotrack
        • Precision Tracking
      • CallRail
      • Invoca
      • Customer.io
      • Intercom
      • Mailchimp
      • React Native
      • SendGrid
      • Sendinblue
      • Server-Side
      • iOS
    • 🔷Google Tag Manager integration
      • Google Tag Manager migration
      • Quick Start Guide
    • 📺Freshpaint Video Platform
    • 🖼️Impression Pixel
  • Admin Panel
    • Event Library
      • Event Library Bulk Actions
      • Event Definition Filters
      • Event Tester
      • 🔁Time Machine
      • Visual Tagger
      • Advanced Options
        • Tag Manager
        • Disabling Target Text Capture
        • Cross Domain Tracking
    • Projects & Environments
    • Teams
      • Role-Based Access Control (RBAC)
    • Transformations
      • Standard Events
      • Modify Data
      • Modify User Data
      • SQL Transformations
    • 📈Destination Monitoring
    • 🔎Investigate: Testing and Debugging
      • Live View
      • Event Verification
  • Reference
    • Developer Docs
      • Freshpaint Web SDK Reference
      • Freshpaint Web SDK Options
      • Freshpaint React Native SDK Reference
      • Freshpaint iOS SDK Reference
      • Freshpaint Android SDK Reference
      • HTTP API
    • Frequently Asked Questions
      • How do I circumvent ad blockers?
      • Can Freshpaint track users across domains?
      • Can I install Freshpaint on a Chrome extension?
      • What properties are captured with my events?
      • How Do I Switchover From Segment?
      • How Do I Switch From Native Google Analytics to the Freshpaint Google Analytics Destination?
      • Where do I find my Environment ID?
      • Is Freshpaint GDPR & CCPA Compliant?
      • Can I use transformations to anonymize data for client-side destinations?
      • How do I QA or debug my data?
      • Why Do My Numbers Differ Across Different Tools?
      • Billing: How Does Freshpaint Determine MTUs?
      • Can I Use Freshpaint on Multiple Sites?
      • How Can I Export Data From Freshpaint?
      • How Does Freshpaint Identify Users?
      • How Many Events Should I Create?
      • What Should I Name My Events?
      • How do I track scroll depth?
      • What Data Does Freshpaint Collect?
        • Data Collected on Web
        • Data Collected on React Native
      • Does Freshpaint's Autotrack slow my site down?
      • Running Freshpaint with a Proxy
      • Should my Environment ID be treated as a sensitive key?
      • How Does Freshpaint Determine Session Count?
      • What is the difference between client-side and server-side connection mode?
      • What is a Proxy Integration?
      • Where can I view Freshpaint’s Status?
      • Does Freshpaint provide HIPAA audit logs?
      • Freshpaint Cookie Too Large
      • How does Freshpaint compare to server-side Google Tag Manager?
      • If a user re-installs my app, will Freshpaint generate a new device ID?
      • Why doesn't Freshpaint need a BAA before sending data to Google Ads and Facebook Ads?
      • What Implementation Services Does Freshpaint Offer?
      • Single Sign On (SSO) Setup
Powered by GitBook
On this page
  • Overview
  • Migrating Tags
  • Other Migration Features and Options
  • GA4 Notes
  • Validating
  • Publishing

Was this helpful?

  1. Integrations
  2. Google Tag Manager integration

Google Tag Manager migration

Freshpaint can migrate your GTM tags using an automated script.

PreviousGoogle Tag Manager integrationNextQuick Start Guide

Last updated 1 day ago

Was this helpful?

The Freshpaint Google Tag Manager Integration supports Client-side Google Tag Manager configurations. is not supported at this time.

The Freshpaint Google Tag Manager Integration supports Client-side Google Tag Manager configurations. is not supported at this time.

Overview

When migrating more than just one or two Google Tag Manager (GTM) tags to the Freshpaint GTM Template, the process can be error-prone and time-consuming.

To help with this, Freshpaint offers a migration script which automates the process. Currently, Freshpaint must run this script on your behalf, after you’ve invited us with access to your GTM account. Please contact for further details.

Migrating Tags

Freshpaint currently supports migrating from native GTM tags to the following Freshpaint Destinations, using the Freshpaint GTM Template:

  • Google Analytics 4 (Proxy)

  • Google Ads

  • Google Ads Call Conversions (migrates to the freshpaint.registerCallConversion sdk call, not to a destination track call)

  • Facebook Conversions API (from Gallery template or Custom HTML)

  • Bing Ads

  • Google Campaign Manager 360 (from Floodlight Counter or Floodlight Sales)

  • Basis

  • Impact.com

  • LinkedIn Ads

  • Twitter Ads

  • StackAdapt conversion (from Custom HTML)

  • theTradeDesk conversion via static tracking tag (from Custom HTML)

When Freshpaint runs the migration, the changes will be written to a GTM Workspace of your choosing.

The changes will not be “Live” in the GTM Workspace until you submit them for publishing.

The target GTM Workspace will typically be the “Default Workspace” present on any GTM Container.

If you want to be able to keep the Freshpaint migration output in a Workspace separate from the Default Workspace used for your ongoing maintenance work, you can create a separate GTM Workspace for migration test purposes, such as “Freshpaint migration”.

Other Migration Features and Options

When Freshpaint runs the migration, in addition to migrating tags for the above destinations, it will:

  • Ensure the Freshpaint destinations for the migrated tags are created - if a given Destination already existed, then the non-sensitive config parameter is checked (the non-sensitive config paramter is automatically set if the destination is created by the migration). A note specific to Facebook Conversions API: The Access Token must be set by you, post-migration.

  • Report any not-yet-Allowlisted event properties encountered in the migrated tags

There is also an option to have the migration configure GTM for the Freshpaint snippet (as an alternative to including it in your page source). Here's how this works:

  • A "Freshpaint Snippet" (or other name you specify) Custom HTML tag is created for the Freshpaint snippet, referencing a "Freshpaint Environment ID" GTM Variable, triggered on All Pages: Initialization

  • Any Freshpaint addEventProperties created, which can occur for Google Analytics 4 migrations, are configured with a SetUp tag to the Freshpaint Snippet, and triggered on All Pages: Initialization

Finally, the following filtering options are available to include or exclude sets of tags from being migrated:

  • Include or Exclude GTM Folder(s)

  • Include Paused Tags

  • Include or Exclude specific Destinations

GA4 Notes

If you have GA4 event tags which are conversions, you'll need to manually add event property conversion with a value of true either to the GA4-event tag pre-migration or the Freshpaint-GA4-event tag post-migration:

Validating

For each tag, perform the action that fires that tag, confirm the event comes through the Freshpaint Live View, and confirm the event shows up in the destination.

Publishing

When you’re comfortable that the migrated changes are correct, you can Submit them for publishing as the “Live” version.

If you're submitting from a Freshpaint-specific GTM workspace such as "Freshpaint migration", be sure to sync any pending changes in the GTM Default Workspace to what was just published.

If for any reason you need to go back to your previous “Live” version, you can quickly do so via the GTM UI, by clicking ‘Set as Latest Version”, from the GTM "Versions" tab.

Use to try out the migrated changes in the target Workspace before they are published as the "Live" version. In this mode, when you run your site in the Preview window, it will use the tags in the Workspace, not the “Live” version. The GTM Tag Assistant browser tab allows you to inspect what Tags are firing, the Tag Parameter values being sent, Variables, the Data Layer, and Errors (if any).

🔷
Server-side Google Tag Manager
Server-side Google Tag Manager
support@freshpaint.io
GTM Preview Mode