Google Campaign Manager 360
This integration is currently in beta. Contact your MetaRouter support team to get started.
What Is Campaign Manager 360?
Campaign Manager 360 (CM360) is a comprehensive advertising management platform developed by Google. It offers advertisers a centralized solution for planning, executing, and measuring digital marketing campaigns across multiple channels and devices. With features like audience targeting, ad creative management, and real-time reporting, CM360 empowers marketers to optimize their campaigns for maximum effectiveness and return on investment.
What are the benefits of integrating MetaRouter with CM360?
- Unified data collection from CM360 campaigns and other sources.
- Efficient data management and activation through MetaRouter.
- Enables Floodlight tag removal.
CM360 Notes & Limitations
- Geolocation data is not currently supported by this integration
- This integration tracks click data through CM360 Offline Conversions API.
Getting Started - From Your CM360 Account
Prerequisites
- You must have a Campaign Manager 360 account. See Advertisers/Agencies for signup information.
- Your Campaign Manager 360 account must be enabled for API Access. Most accounts have this enabled by default; if you're not sure, contact your account representative or the Campaign Manager 360 support team for assistance.
- You must have a user profile with access to this account. Have your Campaign Manager 360 account administrator create a user profile associated with this account.
- Check user profile permissions in the Campaign Manager 360 UI. These control what the user profile can access from the API. There are no separate API permissions.
- Manage user access
- NOTE: You will need to grab your user profile ID for the CM360 playbook in MetaRouter
Generate credentials
All requests you make to the Campaign Manager 360 API must be authorized. For a brief overview of authorization, read about how to authorize and identify your application to Google.
The following instructions guide you through the process of creating an OAuth 2.0 client ID to use with the installed application flow. For instructions on generating credentials for use with the service account flow, refer to the Service Accounts guide.
- Follow the steps to configure a Google API Console project.
- Open the Credentials page in the API Console.
- Click CREATE CREDENTIALS > OAuth client ID.
- If you hadn't configured an OAuth consent screen for this project previously, you'll be directed to do so now. Click CONFIGURE CONSENT SCREEN.
- Select the user type and click CREATE.
- Fill out the initial form. You can edit this later if needed. Click Save when done.
- Navigate back to Credentials > CREATE CREDENTIALS > OAuth client ID to continue.
- Select Desktop app as the application type, give it a name, then click Create.
When done, you'll be presented with an OAuth 2.0 client ID and client secret, which you can download in JSON format and save for later use.
Floodlight Activities
- Floodlight activities correspond to specific events you’d like to track, such as conversions on your website or adding users to audience lists.
- For this integration, Floodlight ActivityID and the corresponding Floodlight ConfigurationID are required
- To find Configuration ID, use the Advertiser ID
- To find Activity ID, go to Advertiser level > Floodlights to find the Floodlight Activity ID within the dashboard. You will assign a Floodlight Activity ID to every event within integration.
Getting Started - From Your MetaRouter Account
Adding a CM360 integration.
From the integration library, add a “Google Campaign Manager” integration. Then, fill out the Connection Parameters:
Connection Parameter | Description |
---|---|
**CREDENTIALS_JSON** | Paste in credentials in JSON format. |
**CONFIG_ID** | Use your Advertiser ID. |
**PROFILE_ID** | From https://support.google.com/campaignmanager/answer/6098287?hl=en, use the Profile ID associated with your user. |
Adding a Google Gtag Sync
To gather the gclid
value, you must add a Google Gtag sync. You can skip this step if you’ve already set up the Google Gtag Sync.
- From the Pipelines page, find the pipeline associated with the web property you’d like to add a sync to. Hover over the three dot dropdown and select “Build AJS File.”
- In the Identity Syncs section, select the Google Gtag sync.
- Fill out the following fields:
- GTAG.js Tag ID - You can find more information on GTAG.js Tag ID here.
- Destination IDs - Allows the sync to connect and direct events to the correct Google product. For Google Ads, the destination ID is the same as the conversion tracking ID, for example AW-98765.
- Floodlight Advertiser ID Object - The Floodlight Advertiser ID. In CM360, the Advertiser ID will appear on the advertiser details page just below the advertiser's name. This value is also found as the value of src= in a generated Floodlight tag snippet.
- Cookie Lifetime (in days) - 45 days default
- Fire on Re-sync - Re-syncs for an updated identifier when an Identify call is made.
- Send MetaRouterSync to GA4 - Sends a MetaRouterSync event to GA4 when the sync is loaded on the page.
- Enable Google Consent Mode - If enabled, consent categories 'ad _storage, 'ad_user_data', 'ad _personalization', 'analytics_storage' will be sent to Google when user is opt-in or opt -out
- Advanced Consent Mode Type (when consent mode is enabled) - If consent mode is enabled, the consent mode will be set to advanced' when this is on, and 'basic' when this is off
- Scroll down and click the Save and Build File button.
- Deploy your AJS file to propagate changes to your web property.
Event Mappings
MetaRouter provides all of the event mappings that CM360 integrations typically require. You may add custom events, parameters or mappings in accordance with CM360’s API documentation.
Global
Global mappings will be applied to all events. If your parameter names do not match the Expected Inputs provided, you will need to overwrite the Inputs provided with your own.
Output Key | Description | Expected Input |
---|---|---|
floodlightConfigurationId Required | Type: String The Floodlight configuration used by the specified activity. | Enrichment - CONFIG_ID |
kind Required | Type: String Identifies what kind of resource this is. | Enrichment - dfareporting#conversion |
timestampMicros Required | Type: String The timestamp of the conversion, in microseconds since the Unix epoch. | N/A - Expression |
gclid Required, unless using another identifier. See below. | Type: String A Google Click Identifier generated by Google Ads or Search Ads 360. | N/A - Expression |
ordinal Required | Type: String The deduplication identifier associated with the conversion. | messageId |
customVariables | Type: String A custom floodlight variable. | N/A - Expression |
Event Specific
All default parameters are required.
page
Output Key | Description | Expected Input |
---|---|---|
floodlightActivityId | Type: String The Floodlight Activity ID that corresponds with this event. | N/A - Customizable |
product_added
Output Key | Description | Expected Input |
---|---|---|
floodlightActivityId | Type: String The Floodlight Activity ID that corresponds with this event. | N/A - Customizable |
value | Type: Number The amount of revenue generated by the conversion. | N/A - Expression |
quantity | Type: Number The number of items associated with the conversion. | properties.quantity |
order_completed
Output Key | Description | Expected Input |
---|---|---|
floodlightActivityId | Type: String The Floodlight Activity ID that corresponds with this event. | N/A - Customizable |
value | Type: Number The amount of revenue generated by the conversion. | N/A - Expression |
quantity | Type: Number The number of items associated with the conversion. | properties.quantity |
Required & Recommended Identifiers
An identifier must be mapped to CM360 in order for successful user matching to occur. Without an identifier, any events sent to CM360 may not be reflected in reporting. For your convenience, required and recommended IDs are mapped as Global parameters to ensure they are added to every event.
Please note, you may only use one identifier at a time per CM360 integration. A single CM360 integration cannot use more than one identifier at a time.
Attribute | Example | Sync Injector Required? |
---|---|---|
gclid Required, unless using a different identifier as listed below. | &gclid=CjwKCAjwt-OwBhBnEiwAgwzrUkyNMRwtorgWNStUyWMG50WbzKNMWAFeWOHtq5q0cEbAHYKX7a4hNBoCwugQAvD_BwE | Yes |
Additional Identifiers
One of the following identifiers can be alternatively mapped to CM360 if using the gclid is not an option. If using these identifiers, they must be added as Global or Event Specific mappings.
Please note that only one identifier can be used at a time.
Attribute | Description | Example |
---|---|---|
dclid | Conversions can be attributed to ad clicks through the use of Display Click IDs (DCLIDs). If you are connecting to CM360 for DV360, then you will need to use dclid as the main identifier. See more here. | &dclid=CKDdz-fE_IUDFYtTCQkdbyMOPg |
matchID | Conversions can be attributed through your own first-party identifier that has been synced with Google using the [match_id](https://support.google.com/campaignmanager/answer/7554821#custom&zippy=%2Ccustom-fields) feature in Floodlight. | 130161d0-8fee-4167-aa4d-d151eed27c6b |
mobileDeviceID | Conversions can be directly attributed to mobile or Connected TV devices through the use of advertising device identifiers. See supported identifiers here. | EB2B2675-AE94-44FB-836B-9CB3E038B11C |
Additional CM360 Documentation
Updated about 1 month ago