Google Campaign Manager 360 (Beta)

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.

• $gclid, $dclid, or $edimpid — At least one of these identifiers is required for Google to process a conversion. If multiple are available, Freshpaint will use the most specific available identifier (gclid first, then dclid, finally edimpid). These are listed as Recommended properties in the Freshpaint destination configuration.

If you are using HIPAA mode, these properties must be allowlisted for the destination to send events to CM360.

Click-through conversions

To support click-through conversions with CM360, 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.