Floodlight Sales tags

The Floodlight Sales tag allows you to keep track of how many items users have purchased, as well as the total value of those purchases.

There are two ways to add Floodlight tags to a Google Tag Manager container:

  • Accept a tag that has been pushed from the Campaign Manager user interface.
  • Add the tag from the Google Tag Manager user interface.

Accept a pushed Floodlight tag

This tag can be pushed directly to your container from the Campaign Manager user interface. To allow this in Tag Manager, you need to approve the link request and pushed tag(s). Read Approvals to learn more.

To accept a pushed Floodlight tag:

  1. Navigate to Admin and then Approval Queue and then Tags.
  2. Click the activity name. Some parameters (e.g. the values for "src= ", "type= ", and "cat= ") will be pre-defined.
  3. The Revenue parameter value is populated with a {{cost}} Tag Manager variable. Create and configure a {{cost}} variable that retrieves the revenue amount. If you already have a variable created that captures the transaction revenue, change {{cost}} to the name of that variable.
  4. The Order ID parameter value is populated with an {{ord}} Tag Manager variable. Create and configure an {{ord}} variable that retrieves retrieve the order ID (or, if Item Sold is the counting method, configure this variable to be a count of the number of items sold.) If you already have a variable that captures the order ID, change {{ord}} to the name of that variable.
  5. Floodlight custom variables are key-value pairs that can be used to track data that you collect about your users. Custom Floodlight variables use the keys u1=, u2=, etc. For pushed tags, variable names will be populated in the custom variable fields. Map these custom Floodlight variables to Tag Manager variables so that their values can be passed to your Floodlight tag.
  6. Make desired modifications to your Floodlight tag, then click Approve.

Important: For optimal web browser compatibility, ensure that a conversion linker is enabled.

Create the Tag

To set up a new Floodlight Sales tag:

  1. Click Tags and then New.
  2. Click Tag Configuration and then Floodlight Sales.
  3. To gather the values required for tag configuration, open another browser window and sign in to Campaign Manager. Click Advertisers, and then click the name of the advertiser. Enter these values in your new Tag Manager Floodlight Sales tag:
    • Advertiser ID: The Advertiser ID will appear on the advertiser details page just below the advertiser's name. This value is also found as the value of src= in a generated Floodlight tag snippet.
    • Group Tag String: In the Activity table, identify the activity you want to work with and find the group tag string listed in a column to the right. This is also found as the value of type= in a generated Floodlight tag snippet.
    • Activity Tag String: In the Activity table, identify the activity you want to work with and find the activity tag string listed in a column to the right. This is also found as the value of cat= in a generated Floodlight tag snippet.
  4. For Revenue, select a variable that contains the revenue amount. For Order ID, select a variable that contains the order ID. If you have selected Item Sold as the Counting Method, select a variable that contains a count of the number of items sold. Create these variables in Tag Manager if they do not already exist.
  5. Floodlight custom variables are key-values that can be used to track data that you collect about your users, for example the genre of movie that a user purchases. Custom Floodlight variables use the keys u1=, u2=, etc. For each custom variable, select a Tag Manager variable that contains the value you want to pass to the Floodlight custom variable.
  6. Select a trigger that corresponds to a purchase event, or create one if it doesn’t already exist. There are several ways of creating such triggers which depend on your site and your Tag Manager implementation. For example: Create a pageview trigger. For the trigger filter, add the URL of the purchase confirmation page. Or, use the data layer to push a custom event to Google Tag Manager (dataLayer.push({ 'event': 'purchase' });) and set up your trigger as a custom event trigger with the event condition set to 'purchase'.
  7. When you have completed entering the tag information, click Save.

Important: For optimal web browser compatibility, ensure that a conversion linker is enabled.

Mobile Floodlight activities

The setup process for mobile Floodlight tags is similar to the process for regular Floodlight activities, with some minor changes:

  • Use a mobile container: If you have already deployed Floodlight tags in a web container, you still need to create and maintain mobile Floodlight tags from a mobile container.
  • When you receive the tags, you may also receive specific instructions with conditions for how they should fire. There are two mobile-specific settings you may have to configure:
    • Unrepeatable: Check this box if you want your Floodlight tag to fire only once over the lifetime of the app (for example, when a user downloads or installs an app).
    • Triggers: The activity must be tied to a trigger in Google Tag Manager so that the tag fires.

Related resources

Was this article helpful?
How can we improve it?