Google SA360 Enhanced Conversions Connector Setup Guide | Server-Side Connectors

Requirements

The Floodlight gtag.js tag is required for this connector to update the tag payload with Personally Identifiable Information (PII) data.
Update the Floodlight gtag.js to the latest version.

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: Campaign Manager 360 API

Batch Limits

This connector uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following 3 thresholds is met:

Max number of requests: 1000
Max time since oldest request: 60 minutes
Max size of requests: 1 MB

Connector Actions

Action Name	AudienceStream	EventStream
Send Conversion	✗	✓

Configure Settings

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article.

When you add this connector, you must accept the vendor’s data platform policy.

After adding the connector, configure the following settings:

Floodlight Profile ID

The Floodlight Profile ID that is provided by Campaign Manager 360, after adding the api@tealium.com user to your Campaign Manager 360 account.

Click Done when you are finished configuring the connector.

Action Settings — Parameters and Options

Click Continue to configure the connector actions. Enter a name for the action and then select the action type from the drop-down menu.

The following section describes how to set up parameters and options for each action.

Action — Send Conversion

Parameters

Parameter	Description
Floodlight Configuration ID	(Required) The Floodlight configuration ID of this conversion.
Floodlight Activity ID	(Required) The Floodlight activity ID of this conversion.
Match ID	(Required) A unique advertiser created identifier (passed via Floodlight) that can be synced with Google to attribute offline conversions.
Ordinal	(Required) The ordinal of the conversion. This is used to de-duplicate conversions of the same user and day.
Timestamp Micros	The timestamp of conversion, in Unix epoch microseconds. If not provided, it will be auto-generated. Should be within 1 minute of the Google recorded timestamp of the client-side conversion.
Quantity	(Required) Quantity of the conversion.
Value	(Required) Value of the conversion.
Profile ID	Overwrites the value defined in the configuration tab of the connector.
Email Address (already SHA256 hashed)	Provide an email address which has been already whitespace trimmed, lowercased, and SHA256 hashed.
Email Address (apply SHA256 hash)	Provide a plain text email address and the connector will 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, lowercased, and SHA256 hashed.
Phone Number (apply SHA256 hash)	Provide a plain text phone number and the connector will whitespace trim, lowercase, 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	2-letter country code of the user’s address in ISO-3166-1 alpha-2 format.

PII mapping restrictions

Ensure that you adhere to the following restrictions with PII data when using the Floodlight tag with this Connector:

Send PII data either through the Floodlight tag OR SA360 Enhanced Conversions API connector, but not both. Mapping PII in both will result in conversion already enhanced errors in the connector.
If there isn’t any PII in the connector data when it connects with Google, the connector will give an error that points to missing PII and it will not send any data to Google.
Tealium recommends restricting any conversions without PII by adding conditions to the Event Feed or Event Spec requiring PII to avoid connector errors.