# Floodlight Reference (Beta)

{% hint style="warning" %}
The Floodlight destination is deprecated. Please instead use: [google-campaign-manager-360](https://documentation.freshpaint.io/integrations/destinations/demand-side-platforms-dsps/google-campaign-manager-360 "mention")&#x20;
{% endhint %}

Optimize your Google Ads spend by attributing ad clicks to conversion and other key behaviors.

## Destination Info

* Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) calls
* Supports [HIPAA mode](https://documentation.freshpaint.io/hipaa-mode)
* Refer to this destination as **Floodlight** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-the-integrations-object)
* Connection Modes:

<table><thead><tr><th align="right"> </th><th width="229" data-type="checkbox">Client-side</th><th data-type="checkbox">Server-side</th></tr></thead><tbody><tr><td align="right">Web</td><td>false</td><td>true</td></tr><tr><td align="right">Mobile</td><td>false</td><td>true</td></tr><tr><td align="right">Server</td><td>false</td><td>true</td></tr></tbody></table>

This is a reference document for the Floodlight destination. For information on how to set up this integration, see the [Quick Start guide](https://documentation.freshpaint.io/integrations/destinations/advertising-destinations/floodlight/floodlight-quick-start-guide).

## API Mapping

### Events

Freshpaint.`track()` events map to any **Floodlight Activities** you've already created in Campaign Manager 360. Any custom variables you've created will be passed along as well.

## Track Events

When you send an event to Floodlight, you can track conversions from your ad campaigns based on those events.

### Server-side

{% hint style="info" %}
The Proxy integration allows you to re-use you're existing google ads configuration. If you're starting fresh, we recommend using the [Google Ads Conversion API](https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/google-ads-conversion-api) destination.
{% endhint %}

You may provide the following additional event properties:

| **Freshpaint property**        | **Floodlight parameter** | **Type** | **Required?** | **Description**                                                                                                                                                                                                                                                                                                                          |
| ------------------------------ | ------------------------ | -------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `group_tag_string`             | `type`                   | string   | Required      | The Conversion Label configured within google ads to identify which conversion action the event should trigger                                                                                                                                                                                                                           |
| `activity_tag_string`          | `cat`                    | string   | Required      | The conversion id can be used to select which Google Ads account to send conversion events to. When set, this will override the conversion Id configured within the destination configuration.                                                                                                                                           |
| `counting_method`              | `ord`/`num`              | string   | Required      | Allows overriding the [Transaction ID](https://support.google.com/google-ads/answer/6386790) generated by Freshpaint with a custom id to avoid duplicate conversions in Google Ads.                                                                                                                                                      |
| `$gclid`                       | `gclid`/`gclaw`          | string   | Optional      | gclid (Google Click ID) is generated at ad click time and appended to the landing page URL. This is mainly used by Google Ads and Search Ads 360. **Freshpaint will automatically capture gclid for events from your website**. If you wish, you may provide `$gclid` as an event property to override the automatically captured value. |
| `$dclid`                       | `dclid`/`gcldc`          | string   | Optional      | dclid (Display Click ID) is generated at ad click time and appended to the landing page URL. This is mainly used by Display Video 360. **Freshpaint will automatically capture dclid for events from your website**. If you wish, you may provide `$dclid` as an event property to override the automatically captured value.            |
| `$gclsrc`                      | `gclsrc`                 | string   | Optional      | gclsrc (Google Click Source) is generated at ad click time and appended to the landing page URL. This is mainly used by Search Ads 360. **Freshpaint will automatically capture gclsrc for events from your website**. If you wish, you may provide `$gclsrc` as an event property to override the automatically captured value.         |
| `u1`, `u2`, etc.               | `u1`, `u2`, etc.         | string   | Optional      | Floodlight custom variables that you define.                                                                                                                                                                                                                                                                                             |
| `user_agent_arch`              | `uaa`                    | string   | Optional      | The User-Agent Architecture                                                                                                                                                                                                                                                                                                              |
| `user_agent_bitness`           | `uab`                    | string   | Optional      | The User-Agent Bitness                                                                                                                                                                                                                                                                                                                   |
| `user_agent_full_version_list` | `uafvl`                  | string   | Optional      | The User-Agent Full Version List                                                                                                                                                                                                                                                                                                         |
| `user_agent_mobileness`        | `uamb`                   | string   | Optional      | The User-Agent Mobileness. Must be 1 for a mobile device and 0 for non-mobile devices.                                                                                                                                                                                                                                                   |
| `user_agent_platform`          | `uap`                    | string   | Optional      | The User-Agent Platform.                                                                                                                                                                                                                                                                                                                 |
| `user_agent_platform_version`  | `uapv`                   | string   | Optional      | The User-Agent Platform Version                                                                                                                                                                                                                                                                                                          |
| `user_agent_wow64`             | `uaw`                    | string   | Optional      | The User-Agent WoW64 (Win32 on Win64)                                                                                                                                                                                                                                                                                                    |
| `$referrer`                    | `~oref`                  | string   | Optional      | The referrer to the page being visited                                                                                                                                                                                                                                                                                                   |

{% hint style="info" %}
Freshpaint will events to Floodlight even when click IDs (`gclid`, `dclid`, etc.) are missing. However, this will prevent Floodlight from correctly attributing your conversions, so make sure you configure your allowlist to send these recommended properties.
{% endhint %}

## View-Through Conversions and Retargeting

View-through conversions are possible in limited capacity using [Enhanced Conversions](https://developers.google.com/doubleclick-advertisers/guides/conversions_ec) (soon to be supported).

Remarketing campaigns will not work using the Freshpaint Floodlight implementation.
