---
title: Webgains Tag Setup Guide
description: This article describes how to set up the Webgains tag.
url: https://docs.tealium.com/client-side-tags/webgains-tag/
---
## Tag tips

* Use the E-Commerce extension to set values for `_corder`, `_csubtotal`, `_ccustid`, `_cpromo`.
* Map an array value to `wgvouchercode` to set product-level vouchers.
* Requires that `_cprice` has a list of prices.
* `wgitems` is set automatically using E-Commerce Extension values (`_cprice`, `_cprodname`, `_cprod`). To override these E-Commerce Extension values, map a string to this variable.
* Map a discount value to `wgDISCOUNT` to set an order-level discount. The tag converts this value to a negative amount and adds a discount line item to the product list.
* The tag fires a landing page script on every page and a conversion script on order confirmation pages. The conversion script sends a `cvr` object built from your data layer variables and an `items[]` array built automatically from `_cprice`, `_cprodname`, `_cprod`, and `_cquan`. Only one conversion fires per unique order reference per page load.

## Tag configuration

Go to the tag marketplace to add a new tag. For more information about how to add a tag, see [Manage tags](https://docs.tealium.com/manage-tags/).

When adding the tag, configure the following settings:

* **Program ID**: Your Webgains Program ID. The tag uses this value to construct the analytics endpoint URL: `https://analytics.webgains.io/{programid}/main.min.js`. See the [Webgains Default Tracking Guide](https://knowledgehub.webgains.com/home/webgains-default-tracking-guide) for details.
* **Event ID**: Required value. Webgains uses Event ID to determine commission rate. See the [Webgains Default Tracking Guide](https://knowledgehub.webgains.com/home/webgains-default-tracking-guide) for your Event/Commission Group ID.
* **Enable Legacy Transaction Pixel**: When enabled, the tag fires both the new `analytics.webgains.io` conversion tracking and the legacy `track.webgains.com/transaction.html` pixel. Disable this option after you complete migration to Default Tracking.

## Load rules

Load the tag on all pages or set conditions for when the tag will load. For more information, see [About load rules](https://docs.tealium.com/about-load-rules/).

## Data mappings

Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For more information, see [About data mappings](https://docs.tealium.com/about-data-mappings/).

The available categories are:

### Standard

| Variable | Data Type | Description |
|:---------|:------------|:------------|
| `wgsubdomain` | String |The subdomain of the server that is being tracked. |
| `wglang` |  String |The two-letter ISO 639-1 language code of the content being tracked. |
| `wgslang` | String |The two-letter ISO 639-1 sublanguage code of the content being tracked.  |
| `wgprogramid` |  String |The Webgains program ID.|
| `wgeventid` | String |The unique event ID.  |
| `wgvalue` |  String |The monetary value of the event.|
| `wgorderreference` |  String |The unique reference ID of the transaction in the event.|
| `wgcomment` | String |Comments about the event. |
| `wgmultiple` |  Boolean | Whether multiple occurrences of this event should be tracked or counted separately. A `1` indicates that every event should be tracked separately while a `0` indicates that only the first event should be tracked. |
| `wgitems` | String | Details about the items or products in this transaction. |
| `wgcustomerid` |  String | The customer ID. |
| `wgproductid` | String | The product ID. |
| `wgvouchercode` | String | The voucher or discount code for the event. |
| `wgchecksum` | String | The checksum for the event.  |
| `wgDISCOUNT`  | String | Adds a discount product with this value. | 
| `wgcurrency`  | String | Transaction currency, such as `USD`. |   
| `wglanguage`  | String | The language of the order, such as `en_EN`. |   
| `wgcustomertype`  | String | Customer type: `new`, `existing`, or custom value such as `trial` or `subscription`. |   
| `wglocation`  | String | The URL of the order confirmation page, such as `https://example.com/checkout`. |