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

## Get started

Once you have confirmed that the source platform supports sending events to DCM Floodlight, follow these steps:

1. From your [RudderStack dashboard](https://app.rudderstack.com/), add a source. Then, from the list of destinations, select **DCM Floodlight**.
2. Assign a name to the destination and click **Next**.

## Connection settings

To successfully configure DCM Floodlight as a destination, you will need to configure the following settings:

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

- **DoubleClick Advertiser ID:** Enter your Advertiser ID visible in the **Campaigns** or **Activities** tab in your dashboard.

{{< info >}}
Refer to the [FAQ]({{< ref "#faq" >}}) section for more information on obtaining the Advertiser ID.
{{< /info >}}

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

{{< info >}}
For more information on finding `cat` and `type` in your Campaign Manager dashboard, refer to the <a href="#faq">FAQ</a> section below.
{{< /info >}}

### Conversion events

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

- **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.
 
{{< info >}}
- **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.
- **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.
{{< /info >}}

- **Custom Floodlight variables:** Enter the custom Floodlight variables to capture additional reporting data beyond the usual metrics (like visits and revenue).

{{< info >}}
For more information on finding the custom Floodlight variables, refer to the <a href="#faq">FAQ</a> section below.
{{< /info >}}

### Client-side events filtering

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

{{< info >}}
This option is applicable only if you're sending events to DCM Floodloght via web device mode. Refer to the [Client-side Event Filtering]({{< ref "sources/event-streams/sdks/event-filtering.md" >}}) guide for more information on this feature.
{{< /info >}}

### Web device mode settings

{{< info >}}
All the settings mentioned in this section are applicable only for the [device mode]({{< ref "destinations/rudderstack-connection-modes.md#device-mode" >}}).
{{< /info >}}

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

- **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" >}}).

{{< 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. Note that your [conversion events]({{< ref "#conversion-events" >}}) configured in the RudderStack dashboard must be of the same tag format.

{{< info >}}
It is highly recommended to use the global site tag instead of the iframe tag. For more information, refer to the <a href="https://support.google.com/campaignmanager/answer/7564930#zippy=%2Ci-use-iframe-or-image-tags-directly-on-my-site-for-desktop-and-mobile-web">Campaign Manager 360 Help Center</a>.
{{< /info >}}

- **Conversion Linker**: Enabled by default, it 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.

{{< 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. Also, provide the below:
- **Google Network Id**: Enter the Google Network ID (NID) for the bidder account.

Finally, click **Next** to enable DCM Floodlight as a destination in RudderStack.

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