Floodlight Setup for Data Manager

This guide covers the Campaign Manager 360 (CM360) side of preparing a client for the Data Manager API integration. It walks through the account access, Floodlight activity, and IDs required to send offline conversions to Floodlight, and lists the values MetaRouter needs to complete the configuration.

Before You Begin

  • Floodlight conversions are configured in Campaign Manager 360. The Floodlight Configuration (the container for your tags) must exist in CM360; Floodlight Activities (the specific events you track) can be created in CM360.
  • Google recommends upgrading offline-conversion workflows to the Data Manager API rather than the legacy CM360 API. Do not send data to the same Floodlight activity through both the CM360 API and the Data Manager integration at once — importing from both simultaneously can cause a loss of measurement signals, since only the latest conversion is counted.
  • Do not set up a Floodlight tag for any activity configured to receive offline data.

Setup Steps

1. Create a Service Account

Follow Google's guide: Set up access — Service Account

Set the scope to include the Data Manager scope:

scopes="https://www.googleapis.com/auth/datamanager"

Once the Service Account is created, go to Keys → Add Key → JSON and download the key file.

2. Enable the Data Manager API

  • Open the Google Cloud Console left-side menu → APIs & Services → Library
  • Search for Data Manager API
  • Click it, then click Enable API

3. Grant the Service Account Access in CM360

  • Sign in to Campaign Manager 360 as an administrator
  • Grant the Service Account's email access to the advertiser / Floodlight configuration you will upload to which is under Admin - User profiles
  • Ensure the assigned role includes Floodlight access and the permissions to insert and update offline conversions

4. Create (or Identify) a Floodlight Activity

Creating a dedicated activity for offline conversions is recommended. A common best practice is to use a placeholder Floodlight activity that is not implemented on your live site for these uploads.

  • All Advertisers → select your advertiser → Floodlight → Conversions
  • Click New and name the activity
  • Fill in the required fields. Note that the Conversion group must match the Type you select (counter or sales)
  • Click Save
  • Copy the ID next to the name in the Conversion name column — that is the Floodlight Activity ID (productDestinationId)
  • Copy the advertiser ID on that page — that is the Floodlight Configuration ID. If your advertiser is a child of a parent advertiser, use the parent advertiser's ID instead.

What MetaRouter Needs

Needed ForFieldWhere to Get It
AuthenticationService Account emailThe Service Account created in Step 1
AuthenticationService Account private keyprivate_key value inside the downloaded JSON key file
Conversion uploadsFloodlight Configuration IDCampaign Manager 360 advertiser / Floodlight configuration
Conversion uploadsFloodlight Activity ID (one per activity)The Floodlight Activity from Step 4