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
  • How it works
  • Migration Procedure
  • Freshpaint Google Tag Manager Destination not supported with Freshpaint GTM Template

Was this helpful?

  1. Integrations

Google Tag Manager integration

Freshpaint can integrate with your Google Tag Manager (GTM) installation to help prevent Protected Health Information (PHI) from being sent to your destinations.

PreviousiOSNextGoogle Tag Manager migration

Last updated 1 day ago

Was this helpful?

The Freshpaint GTM Integration supports Client-side GTM configurations. is not supported, but Freshpaint can help you migrate from Server-side GTM to Freshpaint tags on Client-side GTM.

Google Tag Manager (GTM) does not offer protection against (PHI) being sent to destinations like Google Analytics or Google Ads, when using native GTM tag types.

Freshpaint offers a way for you to continue using Google Tag Manager with supported Freshpaint destinations in a HIPAA-compliant way, by using Freshpaint's GTM Custom Template.

The currently supported GTM tag types and corresponding Freshpaint GTM Template Destinations (displayed as "Freshpaint Tag Type" in the template) are:

GTM Tag Type
Freshpaint GTM Template Destination

Google Tag

Google Analytics: GA4 Event

Google Analytics 4 (Proxy)

Google Ads Conversion Tracking

Google Ads

Google Ads Call Conversions

N/A

Google Floodlight Counter

Google Campaign Manager 360 Conversions API

Facebook Pixel (from Gallery Template or Custom HTML)

Facebook Conversions API

Microsoft Advertising Universal Event Tracking

Bing Ads

Basis

Basis

LinkedIn Insight (from LinkedIn Insight, LinkedIn Insight Tag 2.0, or Custom HTML)

LinkedIn Ads

impact.com Pixel (from custom HTML)

impact.com

TikTok (from Gallery Template)

TikTok Ads

N/A

Reddit Ads

N/A

Pinterest Ads

Twitter Universal Website Tag

Twitter Ads

StackAdapt conversion (from Custom HTML)

Stack Adapt

theTradeDesk conversion via static tracking tag (from Custom HTML)

theTradeDesk

How it works

A typical GTM configuration looks something like this:

The destinations of interest (Google Ads, Facebook CAPI, etc.) must be separately configured in Freshpaint.

The Freshpaint SDK snippet must be loaded either directly on your page (prior to the GTM snippet), or via a Custom HTML Tag in GTM. If the latter, use the Initialization trigger type to ensure the snippet is loaded prior to any Page-View-triggered Freshpaint event tags (and don't use GTM SetUp tags pointing to the SDK snippet tag, except for Freshpaint addEventProperties tags, if any)

Here's how it looks when using the Freshpaint GTM Template, with HIPAA Mode enabled:

Migration Procedure

There are two ways to migrate at this time:

  • Manual

  • Automated (run by Freshpaint)

The Manual approach can work when there are a small number of tags, or if trying a small initial trial set. You can perform this yourself in your GTM account. The steps for this are:

  • Configure each destination of interest in Freshpaint

  • Add the Freshpaint GTM template to your GTM container, by searching the Community Template Gallery and adding it to your GTM workspace

  • Modify one or more native-GTM tags to be their Freshpaint template equivalent:

    • Approach 1: Edit existing tag in-place

      • Tag Type: Select Freshpaint

      • Freshpaint Tag Type: Select appropriate Freshpaint Tag Type (e.g., Google Ads)

      • Enter tag-type-specific parameter settings

    • Approach 2: Create separate Freshpaint tag

      • Rename existing GTM-native tag, and mark it Paused

      • Create new GTM tag with the original tag name

      • Tag Type: Select Freshpaint

      • Freshpaint Tag Type: Select appropriate Freshpaint Tag Type (e.g., Google Ads)

      • Enter tag-type-specific parameter settings

      • Create same trigger(s) as GTM-Native tag

Here is an overview of how the automated migration works:

  • Ensures the Freshpaint GTM Template is installed

  • Supports specifying one or more filtering include and / or exclude GTM-folders, destination types, etc.

  • Excludes paused GTM tags by default

  • Supports a dry-run mode, making it possible to review changes without altering your GTM workspace

  • For each supported tag type, replaces the native GTM tag type with a Freshpaint GTM tag type

  • Creates any destination instances which are not yet configured, and reports any GTM tag properties that may need to be allowlisted

  • Creates draft changes in the GTM workspace. After you review the changes you can submit them to be published as the live version.

Freshpaint Google Tag Manager Destination not supported with Freshpaint GTM Template

Using the Freshpaint GTM Template and the Google Tag Manager Destination at the same time is not currently supported.

A given tag using a GTM native tag type is changed to a Freshpaint-template tag type, specifying the Freshpaint destination (e.g., Google Ads), preserving the same trigger and parameter settings, along with specifying a .

When the GTM trigger fires for the Freshpaint-template tag, this results in a Freshpaint SDK call, which generates a , delivered only to the designated Freshpaint destination.

During Freshpaint’s processing of the event, if in HIPAA mode, Allowlists are evaluated to allow only properties you've designated safe before sending to the destination. You'll need to add properties to the Allowlist to enable the sending of those properties to the destination.

The Automated approach is recommended when there are a large number of tags in your GTM workspace. The Freshpaint Support team makes the changes using an automated script against the GTM API, and coordinates with you to review the changes. Contact to get started.

The destination allows you to send any Freshpaint event to GTM (with properties filtered by Allowlists, if in ), where it may be used as a Custom Event trigger for any GTM tag.

🔷
Server-side GTM
Protected Health Information
Freshpaint Environment ID
track
precision event
HIPAA Mode
support@freshpaint.io
Google Tag Manager
HIPAA Mode