# DCM Floodlight Setup Guide


This guide will help you set up DCM Floodlight as a destination in RudderStack.

## Connection compatibility

{{< destination-config >}}

{{< info >}}
In the web device mode integration, that is, using [JavaScript SDK]({{< ref "sources/event-streams/sdks/rudderstack-javascript-sdk/_index.md" >}}) as a source, RudderStack loads the DCM Floodlight native SDK from the `https://www.googletagmanager.com/` domain.

Based on your website's content security policy, you might need to [allowlist this domain]({{< ref "sources/event-streams/sdks/rudderstack-javascript-sdk/load-js-sdk.md#allowlist-destination-domain" >}}) to load the DCM Floodlight SDK successfully.
{{< /info >}}

## Setup

1. In your [RudderStack dashboard](https://app.rudderstack.com/), set up a source.
2. Go to the **Overview** tab of your source and select **Add Destination** > **Create new destination**.

{{< image src="images/event-stream-destinations/add-new-destination.webp" alt="Add new destination in RudderStack dashboard" >}}

3. Select **DCM Floodlight** from the list of destinations. Then, click **Continue**.

## Connection settings

| Setting | <div style="width:350px">Description</div> |
| :----| :-----|
| DoubleClick Advertiser ID | Enter your Advertiser ID visible in the **Campaigns** or **Activities** tab in your dashboard. <br /><br />See the [FAQ]({{< ref "#faq" >}}) section for more information on obtaining the Advertiser ID. |
| Activity Tag | Enter the Floodlight Activity Tag (`cat`) to define the same parameter value across all conversion events. Alternatively, you can define this value for each conversion event mapping in the **Floodlight Activity Tag** field below. |
| Group Tag | Enter the Floodlight Group Tag (`type`) to define the same parameter value across all group conversion events. Alternatively, you can define this value for each conversion event in the **Floodlight Group Tag** field below. <br /><br />For more information on finding `cat` and `type` in your Campaign Manager dashboard, see the [FAQ](#faq) section below. |
| Counting Method | Use this setting to define the same parameter value across all conversion events. Alternatively, you can define this value for each conversion event in the **Floodlight Counting Method** field in the [Conversion events](#conversion-events) settings. |

### Conversion events

| Setting | <div style="width:350px">Description</div> |
| :----| :-----|
| RudderStack Event Name | Enter your RudderStack event name which will be mapped to the Floodlight tag. |
| Floodlight Activity Tag | Enter the `cat` of your tag string. If left blank, RudderStack will pick the value from the **Activity Tag** field mentioned above. |
| Floodlight Group Tag | Enter the `type` of your tag string. If left blank, RudderStack will pick the value from the **Group Tag** field mentioned above. |
| Floodlight Counting Method | Specify the counting method for the conversion event. RudderStack uses this as a fallback value if `properties.countingMethod` is not present in the event. |
| Fire as Sales Tag | Enable the toggle button for Sales tag. Keep it disabled if it is a **Counter tag**. <br /><br />{{< info >}}**Counter tag vs. Sales tag** <br /><br /><ul><li>**Counter tag**: Used to count the number of conversions. It is supposed to be placed on the confirmation page after a sale with information about the `ord` property passed to the tag.</li><li>**Sales tag**: Used to count the number of conversions, the total number of sales that take place, and the total associated revenue. It is supposed to be placed on the confirmation page after a sale with information about the sales, like `cost`, `qty`, or `ord` properties passed to the tag.</li></ul>{{< /info >}} |
| Custom Floodlight variables | Enter the custom Floodlight variables to capture additional reporting data beyond the usual metrics (like visits and revenue). <br /><br />For more information on finding the custom Floodlight variables, see the [FAQ](#faq) section below. |

### Client-side events filtering

This setting is applicable only if you're sending events to DCM Floodloght in web device mode. 

See the [Client-side Event Filtering]({{< ref "sources/event-streams/sdks/event-filtering.md" >}}) guide for more information on this setting.

### Web device mode settings

The following settings are applicable only when sending events to DCM Floodlight in [web device mode]({{< ref "destinations/rudderstack-connection-modes.md#device-mode" >}}):

| Setting | <div style="width:350px">Description</div> |
| :----| :-----|
| Use device mode to send events | Enable this setting to send events via the [RudderStack device mode]({{< ref "destinations/rudderstack-connection-modes.md#device-mode" >}}). <br /><br />{{< info >}}You can change the setting to enable or disable device mode to send events at any point. However, it takes some time for the new changes to be reflected.{{< /info >}} |
| Tag Format | Select the tag format from the dropdown — RudderStack supports both the **Global site tag** and the **Iframe** tag. <br /><br />RudderStack recommends using the global site tag over iframe tag — for more information, see the [Campaign Manager 360 Help Center](https://support.google.com/campaignmanager/answer/7564930#zippy=%2Ci-use-iframe-or-image-tags-directly-on-my-site-for-desktop-and-mobile-web)<br /><br />{{< warning >}}Your [conversion events]({{< ref "#conversion-events" >}}) configured in the RudderStack dashboard must be of the same tag format.{{< /warning >}} |
| Conversion Linker | Enabled by default, this setting sets the first-party cookies on your site’s domain. |
| Allow ad personalization signals | Enabled by default, it lets the global site tag to collect remarketing data. <br /><br />{{< warning >}}The **Conversion Linker** and **Allow ad personalization signals** settings are only applicable for the global site tag.{{< /warning >}} |
|  DoubleClick Id | Enable this setting if you want to use the Google’s cookie matching functionality. Then, provide the **Google Network ID**. |
| Google Network ID | Enter the Google Network ID (NID) for the bidder account. |
| Consent management settings | Configure the consent management settings for the specified source by choosing the **Consent management provider** from the dropdown and entering the relevant consent category IDs. <br /><br />See [Consent Management in RudderStack]({{< ref "data-governance/consent-management/overview.md" >}}) for more information on this feature. |

## FAQ 

#### Where can I find the activity tag string (cat) and group tag string (type)?

In your Campaign Manager dashboard, go to **Floodlight** > **Activities**. Here you can see all activity names along with their **Activity tag string** (`cat`) and Group tag string (`type`):

{{< image src="images/event-stream-destinations/dcm-floodlight-cat-vs-type.webp" alt="DCM Floodlight cat and type strings" >}}

#### Where can I find the Advertiser ID?

To get the Advertiser ID, go to your [Campaign Manager 360](https://campaignmanager.google.com/) account and navigate to the **Campaigns** or **Activities** tab in your dashboard to obtain the `Advertiser ID`:

{{< image src="images/event-stream-destinations/dcm-floodlight-advertiser-id.webp" alt="DCM Floodlight advertiser ID" >}}

#### Where can I find the custom Floodlight variables?

To create custom Floodlight variables, refer to this [Campaign Manager guide](https://support.google.com/campaignmanager/answer/2823222?hl=en).

You can find the custom Floodlight variables for your activities by going to **Floodlight** > **Activities**. Then, click any activity to view the custom variables associated with it:

{{< image src="images/event-stream-destinations/dcm-floodlight-custom-variables.webp" alt="DCM Floodlight custom variables" >}}

#### How can I get the reports of the events in DCM Floodlight?

In your Campaign Manager dashboard, you get two reporting options under **Report Builder** - **Instant Reporting** and **Offline Reporting**:

{{< image src="images/event-stream-destinations/dcm-floodlight-report-builder.webp" alt="DCM Floodlight report builder" >}}

To generate an offline report of the events, follow these steps:

1. Go to **New** > **Floodlight**.
2. Select the **Floodlight Configuration** and other fields like **Activities**, **Dimensions**, and **Metrics** as per your requirement.

{{< image src="images/event-stream-destinations/dcm-floodlight-report-settings.webp" alt="DCM Floodlight report settings" >}}

{{< info >}}
It may take up to 24 hours for your events to reflect in the reports.
{{< /info >}}

#### What are unattributed cookie conversions?

A conversion is said to be unattributed if the user has a DoubleClick cookie but it is converted without any exposure. This means that the user did not click or view any ad from the advertiser within Floodlight, or the interaction happened outside the lookback window.

<br />