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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.freshpaint.io/integrations/destinations/apps/floodlight/floodlight-reference-beta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
