Google Campaign Manager 360
Destination Info
Supports Track calls
Supports HIPAA mode
Supports Freshpaint Impression Pixel
Supports forwarding from the Google Tag Manager Integration
Refer to this destination as Google Campaign Manager 360 Conversions API in the Integrations object
Connection Modes:
Web
Mobile
Server
Getting Started
Freshpaint's Campaign Manager 360 (CM360) conversions destination allows for tracking click- and view-through conversions from ads managed in CM360, including those linked with other Google Marketing Platform products like Display and Video 360 (DV360). The integration is used to send conversion data to Floodlight Activities within CM360.
Connecting Campaign Manager 360 to Freshpaint
To proceed with setup, you will need the following:
A CM360 account that is enabled for API access (this is the case by default for most CM360 accounts)
A user profile in your CM360 account that has access to the advertiser and Floodlight activities you would like to connect and the "Insert offline conversions" permission
A Freshpaint account that has the CM360 Conversions API destination enabled
When adding a new CM360 destination to Freshpaint, you will need to specify a profile ID and advertiser ID
Profile ID is a seven digit number associated with the account you are going to connect to CM360. Note that for the CM360 integration to work, the profile ID here must belong to the account that is connected via OAuth.
The connected user profile must have permission to "Insert Offline Conversions" in Google Campaign Manager 360 for the destination to work. This permission can be added from the User Roles screen.
Advertiser ID is an eight digit number associated with the advertiser that you are connecting to Freshpaint. It is found in several places throughout the Google Marketing Platform suite of products and may be referred to by terms such as "Floodlight configuration ID". One place it can be found on the "All advertisers" screen.
Once the Profile and Advertiser IDs have been specified, select "Connect with Google CM360" from the Freshpaint configuration page and follow the onscreen prompts to connect your Google account with CM360. Note that the Google account used to connect to CM360 should be the same account that the Profile ID was taken from in the previous step.
Authentication
There are two different methods that can be used to authenticate the connection between Freshpaint servers and Google. Only one of these approaches is necessary.
User Account
A user who has access to both Freshpaint and Google Campaign Manager 360 may delegate access to Freshpaint using the user account. Freshpaint will be granted the limited permissions necessary to send conversion events to google CM360 and be directly tied to the account of the user who delegated access. If that user account is removed or reset, google may revoke the authentication credentials that have been delegated to Freshpaint under that user account.
Navigate to Apps > Destinations > Google Campaign Manager 360
and click either Connect
or Reconnect
in the Access Permission
row of the destination configuration page. In the popup dialog select User Account and then Connect with Google CM360
which will redirect you to Google to complete authentication and delegation of permissions to Freshpaint.
Service Account
A user account within google can be created only for Freshpaint that will provide Freshpaint with a set of credentials that are not tied to any specific user. The creation of this account will require working with someone with necessary permissions within an underlying google cloud account to configure a service account.
Please follow the Google documentation on the creation and configuration of a service account available at: https://developers.google.com/doubleclick-advertisers/service_accounts
Once the service account has been created within Google, the credentials file can be uploaded to the Freshpaint application.
Navigate to Apps > Destinations > Google Campaign Manager 360
and click either Connect
or Reconnect
in the Access Permission
row of the destination configuration page. In the popup dialog select Service Account
and upload the json file with the credentials for Freshpaint to use and click save.
Adding Required Properties
For an event to be processed and successfully forwarded to CM360, the following properties are required:
activity_id
— The 9-digit ID for the Floodlight Activity that conversions should be associated with. This may be added as an event transformation or directly sent with individual events.Navigate to the The Floodlight Activities Tab in CM360 to find this value.
$dclid
— This is the double click ID used for the majority of click-through conversions. Enhanced attribution must be enabled in CM360 for conversions to work correctly; see below. An event still can be sent to CM360 without a$dclid
present if one of$edimpid
or$gclid
is present on the event instead, but dclid always must be allowlisted.$edimpid
— This is used by view-through conversions with the Impression Pixel, and must be enabled to use the Impression Pixel.
Recommended Properties
$gclid
— This is used by Google's native advertising platforms, including Google Ads and Google Search Ads 360. You may want this enabled if you have CM360 connected to one of these platforms. If it is possible for gclids to come from a Google Ads account that is not connected to CM360, it is recommended to leave this off of events sent to CM360.match_id
— The custom unique match ID used for tracking conversions from your ad campaigns. Used as an alternative to standard Google identifiers (eg.$edimpid
,$dclid
, or$gclid
) when the use case requires supplying a custom unique identifier from outside of CM360 for linking ad impressions to conversions. This might be helpful in scenarios where CM360 is involved in conversion attributions but is not being used as a server for the ad creative. See Google's CM360 documentation for more information.
Note that if an event has multiple identifiers on it, conversions sent to CM360 will use the most precise ID available to it, preferring $dclid
first, $gclid
second, match_id
third, and $edimpid
last.
Optional Properties
Freshpaint supports sending optional properties documented in the CM360 Conversions API to CM360. For more details on these fields and the underlying API, see https://developers.google.com/doubleclick-advertisers/rest/v3.4/Conversion.
quantity
1
The number of conversions to count with the event. Can be used with both Floodlight Counter and Floodlight Sales tags, though typically should be set to 1 for standard conversion counting.
value
1.0
The value associated with a conversion. Used with Floodlight Sales tags.
ordinal
Event-specific ID
adDataUserConsent
GRANTED
Whether or not consent has been granted. If present, must be set to "GRANTED
" or "DENIED
" Since Freshpaint already strips out disallowed user data from the request, this is set to granted by default.
childDirectedTreatment
none
When set to true
, indicates that an event may be associated with a user under the age of 13. Used for COPPA compliance purposes.
treatmentForUnderage
none
When set to true
, indicates that an event may be associated with a user under the age of 16, country-dependent. Used for GDPR compliance purposes.
limitAdTracking
none
When set to true
, indicates the conversion will be used for reporting but not targeting and prevents remarketing.
nonPersonalizedAd
none
When set to true
, indicates the conversion was for a non-personalized ad.
Freshpaint also supports transmitting Floodlight custom variables of the form u1
, u2
, u3
...u100
. Note that these values must be individually allowlisted in order to be sent.
Linking a Freshpaint Event to a Floodlight Activity
Each Floodlight tag in Campaign Manager uses an Activity ID value to uniquely identify the conversion action. Follow these steps to link your Freshpaint event to your Floodlight activity:
At the Advertiser level, navigate to Floodlight > Activities from the left nav and find the specific Floodlight activity you want to link your Freshpaint event. The value beside the activity name is the Floodlight tag's Activity ID (save this for later).
Attach the Activity ID to the related event in Freshpaint by creating a Transformation in Freshpaint:
Click on "Create New" in Transformations
Click "Modify Data"
Select your Freshpaint conversion event, select the Google Campaign Manager 360 Conversions API destination, then click "Save & Add Transformations"
Select the "Send Constant Property" transformation option, use activity_id as the property name, and copy/paste the Activity ID value from step 1.
Click "Save" to complete your transformation rule
If you are a HIPAA account, you will need to add event properties to this destination's allowlist. If you are not a HIPAA account, you can skip this step.
Configure the destination's HIPAA Allowlist by navigating to Overview > DSP from the left nav and clicking Google Campaign Manager 360 Conversions API under the Destinations section.
Click on the "Configure" button beside the Required Properties row under the Configuration section
Ensure the
activity_id
property is allowlisted, along with other required properties for the destination.
De-duplicating conversions
The optional counting_method
property can be used to override the default behavior of ordinal
when a value for ordinal
is not provided. There are 3 supported values for counting_method
:
"standard": Default behavior. Counts every conversion.
"unique": Counts the first conversion for each unique user during each 24-hour day, from midnight to midnight, Eastern Time (US).
"session": Counts one conversion per user per session. Session length is set by the site where the Floodlight tag is deployed.
If you are managing events through Freshpaint directly and not through Google Tag Manager, you can specify the counting method by following the steps below:
Click on "Create New" in Transformations
Click "Modify Data"
Select a specific event to apply the transformation to or select All Events, select the Google Campaign Manager 360 Conversions API destination, then click "Save & Add Transformations"
Select the "Send Constant Property" transformation option, use
counting_method
as the property name, and set the value to "standard", "unique", or "session".
Click "Save" to complete your transformation rule
Click-through conversions
To support click-through conversions with CM360, the enhanced attribution feature needs to be configured on the floodlight configuration used within CM360.
Please see Google Support - Enhanced attribution on how to configure dclids to be attached to landing page links.
View-through conversions - Configuring an Impression PIxel
To track view-through conversions on CM360, you will need to configure the Freshpaint Impression Pixel for the destination. In the impression pixel config screen within the destination configuration page for the CM360 destination, ensure one or both of IP or Cookie based matching is turned on. Note that these matches are only used by the Freshpaint application to match users to prior impressions; this information is not forwarded to the destination unless explicitly allowlisted.
Copy the pixel configuration URL provided for use in CM360. On the advertiser in CM360, create a new Impression event tag with the "image" type and use URL from the Freshpaint configuration UI, as in the example screenshots below.
Setting Up a Test Campaign in Google Campaign Manager
Coordinate with your marketing team or Agency partner who manages your campaigns
Let them know it’s a small-scale test campaign designed to validate tracking and performance.
Link your Freshpaint event(s) to a Floodlight activity/activities
Choose your creative and create a campaign
Use existing, current, or new creative—your choice!
Choose your channel
Target a channel that tracks clicks and views for more accurate validation
Set your budget
Keep it small ($10-50); aim for 1,000–3,000 impressions
Verify results
Ensure that click- and view-through conversions are tracking correctly both in Freshpaint and in your Campaign Manager account
Verifying Conversion Reporting
Once you have followed the steps above, you can verify that conversions are being reported to Google Campaign Manager
Event Verification
In Freshpaint, you can use the event verification tab to see which events are being successfully sent to Google Campaign Manager. You can also dig into each event to see the data being sent or investigate errors if there are any.
Google Campaign Manager Reporting
Navigate to the Reporting and Attribution section. Under the Report Builder tab, create a new Instant Report:
Create an Activity report that breaks down the data by columns like view/click-through conversions and total conversion counts:
Last updated
Was this helpful?