Floodlight Setup for Data Manager

🚧

This document is under construction and is subject to change.

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
  • 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.

  • In Campaign Manager 360, navigate to the Floodlight configuration for the advertiser
  • Create or locate the Floodlight Activity you will use to track the conversions
  • Record the Floodlight Activity ID and its parent Floodlight Configuration ID

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