Floodlight Reference

Send advertising events directly to Floodlight from Freshpaint

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

Destination Info

Client-sideServer-side

Web

Mobile

Server

This is a reference document for the Floodlight destination. For information on how to set up this integration, see the 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

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

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

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.

View-Through Conversions and Retargeting

View-through conversions are possible in limited capacity using Enhanced Conversions (soon to be supported).

Remarketing campaigns will not work using the Freshpaint Floodlight implementation.

Last updated