🔷Google Tag Manager integration
Freshpaint can integrate with your GTM installation to help prevent Protected Health Information (PHI) from being sent to your destinations.
Google Tag Manager (GTM) does not offer protection against Protected Health Information (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 | NA |
Facebook Pixel (from Gallery Template or Custom HTML) | Facebook Conversions API |
Microsoft Advertising Universal Event Tracking | Bing Ads |
impact.com Pixel | impact.com |
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:
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 Freshpaint Environment ID.
The destinations of interest (Google Ads, Facebook CAPI, etc.) must be separately configured in Freshpaint.
When the GTM trigger fires for the Freshpaint-template tag, this results in a Freshpaint SDK track call, which generates a precision event, delivered only to the designated Freshpaint destination.
The Freshpaint SDK snippet must be loaded either directly on your page, or via a Custom HTML Tag in GTM. If the latter, any Freshpaint Pageview-triggered tags must be configured with the Custom HTML tag as a Setup Tag.
During Freshpaint’s processing of the event, if in HIPAA mode, 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.
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
Download the Freshpaint custom template
Otherwise, you'll need to copy / paste the file contents into a text editor, then save to a file named template.tpl.
Install the Freshpaint custom template into your GTM account, via Templates -> New -> ...menu -> Import -> select template.tpl
Modify one or more native-GTM tags to be their Freshpaint template equivalent:
Approach 1: Edit existing tag in-place
Tag Type
: Select FreshpaintFreshpaint 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 FreshpaintFreshpaint 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
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 support@freshpaint.io to get started.
Here is an overview of how the automated migration works:
Installs the latest Freshpaint GTM Template
Supports specifying one or more filtering include and / or exclude GTM-folders
Excludes paused GTM tags by default
Supports a dry-run mode, making it possible to review changes without altering your GTM workspace
Generates a log of actions
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
The Google Tag Manager destination allows you to send any Freshpaint event to GTM (with properties filtered by Allowlists, if in HIPAA Mode), where it may be used as a Custom Event trigger for any GTM tag.
Using the Freshpaint GTM Template and the Google Tag Manager Destination at the same time is not currently supported.
Last updated