Google Campaign Manager 360 (Early Access)
This destination is currently under development and in a closed beta. If you are interested in participating in the beta, please reach out to your account manager for more details. This documentation may be subject to changes and use of this destination is considered experimental.
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:
Client-side | Server-side | |
---|---|---|
Web | ||
Mobile | ||
Server |
Getting Started
Freshpaint's Campaign Manager 360 (CM360) conversions destination allows for tracking 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.
The user delegating access to their User Account needs to have the "Insert offline conversions" permission as part of their role within Campaign Manager 360.
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
The service account should be provided with the https://www.googleapis.com/auth/ddmconversions scope which will allow access to send conversion events to Google.
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.
If you're using Google Tag Manager, and have been using either the native Floodlight tag or the Freshpaint Floodlight tag, where the
Activity tag string
is specified, you'll need to map that to theactivity_id
via the the Floodlight Activities tab described above.
$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.
Recommended Properties
$edimpid
— This is used by view-through conversions with the Impression Pixel, and must be enabled to use the Impression Pixel.$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.
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, 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.
Property Name | Default Value | Description |
---|---|---|
quantity |
| 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 |
| The value associated with a conversion. Used with Floodlight Sales tags. |
ordinal | Event-specific ID | A deduplication ID used to prevent double-counting conversions. The default behavior should cover typical CM360 use cases. |
|
| Whether or not consent has been granted. If present, must be set to " |
| none | When set to |
| none | When set to |
| none | When set to |
| none | When set to |
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.
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.
Last updated