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

Configuration for a CM360 destination in Freshpaint.

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.

User profiles screen in Campaign Manager 360. In this example, the profile ID for "my_account" is 0451343

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.

All advertisers screen in Campaign Manager 360. In this example, the advertiser ID for "My Advertiser" is 01234567

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 the activity_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	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	A deduplication ID used to prevent double-counting conversions. The default behavior should cover typical CM360 use cases.
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.

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.

Freshpaint impression pixel config. At least one form of matching must be enabled.

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.

Impression event tags section in CM360

A newly configured Impression event tag. The "name" field can be any value. Tag Type should be "Image", enabled "Yes", and the URL should match the one provided by the Freshpaint config screen.