Google Campaign Manager 360 Floodlight Connector Setup Guide
The Google Campaign Manager 360 Floodlight connector inserts offline conversions into the Floodlight Conversion Tracking and Attribution system through the Google Campaign Manager 360 API.
Floodlight is the conversion tracking system for the DoubleClick Digital Marketing (DDM) platform. All properties within the DDM platform—Campaign Manager (DCM), Bid Manager, and DoubleClick Search (DS)—can use Floodlight. For more information, see Google: About Floodlight conversion tracking.
DS vs DCM
Use DoubleClick Search (DS) if you do not run paid search reports in Report Builder or do not need to see search-driven offline conversions in your DDM platform—Campaign Manager (DCM) reports.
Use DCM if you run Paid Search reports in Report Builder and can identify conversions by encrypted user ID, mobile device ID, or Google click ID.
It’s important that you use either DS or DCM, but not both: conversions you upload from both products are not de-duplicated and may cause data discrepancies.
Do not confuse Floodlight Conversion Tracking System with Floodlight tag, which is a tracking tag for DoubleClick platforms.
Requirements
- You must have a DCM account.
- Your DCM account must be enabled for API access.
- You must have a user profile with access to this account.
- Grant access to conversion data within your DCM account by enabling the
https://www.googleapis.com/auth/ddmconversions
scope for your DCM account. - Add user
api@tealium.com
to your account and grant it access to your DCM account with the Insert offline conversions permission. - After user
api@tealium.com
is added to your DCM account, use the generated profile ID in the connector, either on the configuration page or on an action page. If defined in both locations, the profile ID defined on an action page takes precedence.
API Information
This connector uses the following vendor API:
- API Name: Google Campaign Manager 360 API
- API Version: v4
- API Endpoint:
https://www.googleapis.com/dfareporting/
- Documentation: Google: Campaign Manager 360 API
Batch Limits
This connector uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:
- Max number of requests: 1000
- Max time since oldest request: 60 minutes
- Max size of requests: 1 MB
Delayed Actions
Actions are delayed for 30 minutes to accommodate uploading offline conversions, as per Google’s best practices. For more information about delayed actions using the Google Campaign Manager 360 Floodlight connector, see Google: Best practices for uploading offline conversions.
Actions are not delayed when using trace in EventSream or AudienceStream.
Connector Actions
Action Name | AudienceStream | EventStream |
---|---|---|
Track Floodlight Conversion | ✓ | ✓ |
Configure Settings
Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.
After adding the connector, configure the following settings:
- Floodlight Profile ID
- The Floodlight Profile ID that is given to you by Campaign Manager 360, after adding the
api@tealium.com
user to your Campaign Manager 360 account.
- The Floodlight Profile ID that is given to you by Campaign Manager 360, after adding the
When you add this connector, you will be prompted to accept the vendor’s data platform policy.
Action Settings - Parameters and Options
Click Next or go to the Actions tab. This is where you configure connector actions.
This section describes how to set up parameters and options for each action.
Action - Track Floodlight Conversion
Configuration ID Parameters
Parameter | Description |
---|---|
Profile ID |
|
Floodlight Configuration ID |
|
Floodlight Activity ID |
|
User/Device ID
- If multiple attributes are mapped, the first non-empty value will be sent.
- All the conversions are sent after a 30 minute delay.
Parameter | Description |
---|---|
Encrypted User ID |
|
Mobile Device ID |
|
Google Click ID |
|
Display Click ID |
|
Match ID |
|
Impression ID |
|
Additional Parameters
Parameter | Description |
---|---|
Ordinal |
|
Timestamp |
|
Limit Ad Tracking |
|
Child Directed Treatment |
|
Non-Personalized Ad |
|
Treatment For Underage |
|
User Identifiers
Parameter | Description |
---|---|
Email Address (already SHA256 hashed) | Provide an email address which has been already whitespace trimmed, lowercased, and SHA256 hashed. Remove all periods (. ) that precede the domain name in gmail.com and googlemail.com email addresses before hashing. |
Email Address (apply SHA256 hash) | Provide a plain text email address and the connector will remove all periods (. ) that precede the domain name in gmail.com and googlemail.com email addresses, whitespace trim, lowercase, and hash this value using SHA256 hash. |
Phone Number (already SHA256 hashed) | Provide a phone number which has been already whitespace trimmed and SHA256 hashed. |
Phone Number (apply SHA256 hash) | Provide a plain text phone number and the connector will remove all non-figit symbols, prefix the number with a plus sign (+ ), whitespace trim and hash this value using SHA256 hash. |
Address Info: First Name (already SHA256 hashed) | Provide first name which has been already whitespace trimmed, lowercased, and SHA256 hashed. |
Address Info: First Name (apply SHA256 hash) | Provide a plain text first name and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash. |
Address Info: Last Name (already SHA256 hashed) | Provide last name which has been already whitespace trimmed, lowercased, and SHA256 hashed. |
Address Info: Last Name (apply SHA256 hash) | Provide a plain text last name and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash. |
Address Info: Street Address (already SHA256 hashed) | Provide a street address which does not contain special characters, has been already whitespace trimmed, lowercased, and SHA256 hashed. |
Address Info: Street Address (apply SHA256 hash) | Provide a plain text street address and the connector will remove all special characters, whitespace trim, lowercase, and hash this value using SHA256 hash. |
Address Info: City | City of the user’s address. |
Address Info: State | State code of the user’s address. |
Address Info: Postal Code | Postal code of the user’s address. |
Address Info: Country Code | The 2-letter country code of the user’s address in ISO 3166-1 alpha-2 format. |
Encryption Parameters
Parameter | Description |
---|---|
Encryption Entity Type |
|
Encryption Entity ID |
|
Encryption Source |
|
Quantity and Value
Parameter | Description |
---|---|
Quantity | The quantity of the conversion. If not mapped, the default value is 1 . |
Value | The value of the conversion. |
Custom Data
- Map attributes to
U
custom variables as needed. Only populated values are sent. Use of the mapping destinations in this section supersede any mappings in the Custom Data Arrays - Legacy section.
Custom Data Arrays - Legacy
Parameter | Description |
---|---|
Custom Variable Values |
|
Custom Variable Types |
|
Vendor Documentation
This page was last updated: July 9, 2025