Webgains

Datafly Signal sends sales and leads to the Webgains S2S Conversion API (api.webgains.io/queue-conversion), attributed by the Webgains click ID (wgu), with an item-level basket.

Prerequisites

Get your program and event IDs

Your Webgains Integration Manager supplies the program ID and the commission event IDs. Use one integration per event ID: one for sales, another (with the lead event ID and the Lead Generation preset) for leads.

Keep wgu on landing URLs

Webgains links land with a wgu parameter, which the Datafly collector captures.

Configure in Signal

Configuration Fields

Field	Required	Description
`program_id`	Yes	Your Webgains advertiser program ID. Found in your Webgains advertiser dashboard, or ask your Webgains Integration Manager.
`event_id`	Yes	The Webgains commission event ID for this conversion type (sale or lead), from your Webgains Integration Manager. It is sent as eventId on every conversion, so use one integration per event ID: one with the sale event ID (Default, Retail or Travel preset) and, if you pay for leads, another with the lead event ID (Lead Generation or Insurance preset).

Management UI Setup

Go to Integrations > Add Integration > Webgains.
Choose a preset: Default (default), Retail (ecommerce), Travel (travel), Lead Generation (lead_gen), Insurance (insurance).
Fill in the fields above and click Save.

Request format

A sale:

POST https://api.webgains.io/queue-conversion
{"currency":"GBP","customerId":"86e0b9e56c17cc4d12387e1949b85053fbe73bc3ce5a1188713a9d300cc6133d","customerType":"new","eventId":"1083380","ids":[{"name":"s2s","value":"117_1633304_16651550532817_3f4e40a2a3"}],"items":[{"code":"SKU_1","name":"Parka \u0026 Hood","price":"240.00","voucher":""},{"code":"SKU_2","name":"Gloves","price":"19.99","voucher":""}],"location":"https://shop.example.co.uk/checkout/done?x=1","orderReference":"ORD-1001","programId":"312042","value":259.99,"voucherId":"SAVE10"}

Each item’s price is its line total (price multiplied by quantity): Webgains captures no quantity.

Event Mapping

Signal event	Vendor event	Presets
`purchase`	`sale`	Default, Retail, Travel
`booking_completed`	`sale`	Travel
`generate_lead`	`lead`	Lead Generation, Insurance
`sign_up`	`lead`	Lead Generation
`quote_completed`	`lead`	Insurance

Identity

wgu is sent as ids[{name: s2s, value}]; conversions without it are not sent. customerId is the SHA-256 of the normalised email. No plaintext personal data is sent.

Webgains asks advertisers to get consent before its landing-page script sets marketing cookies; Signal reads the click ID from the landing URL and sets no Webgains cookie. Affiliate conversions are not held back for marketing consent: the affiliate who referred the visitor is paid through them (product decision, #1219). Operators whose legal advice differs can set the pipeline’s affiliate_click_ids_require_consent, or assign a consent category to the integration.

Troubleshooting

Problem	Solution
Leads paid at the sale rate	Leads use the integration’s Event ID: install a separate Webgains integration with the lead event ID for the Lead Generation preset.
Commission on VAT	Webgains wants values net of VAT unless you pay commission on it; Signal sends the event value as it arrives (#1383).

Blueprint

The Webgains blueprint version is 0.9.0. It was last reviewed against the vendor’s documentation on 2026-09-23.