TUNE
Datafly Signal fires TUNE (HasOffers) conversion postbacks server-to-server, keyed by the TUNE transaction ID the offer URL passed to your site, either to the offer’s default goal or to a numeric offer goal.
Prerequisites
Find your network subdomain
The postback host is {network_id}.go2cloud.org; enter the subdomain.
Store the TUNE transaction ID
The network’s offer URL passes the transaction ID to your site in a parameter you agree with them. Store it on landing and send it on conversion events as properties.tune_transaction_id (collector capture: #1514).
Note the goal IDs
For events other than the offer’s default goal, copy each goal’s numeric ID from the offer’s goals and enter it in the matching goal setting.
Configure in Signal
Configuration Fields
| Field | Required | Description |
|---|---|---|
network_id | Yes | The subdomain of your TUNE network’s postback host: the postback host is {network_id}.go2cloud.org (enter demo for demo.go2cloud.org). Enter the subdomain only. |
security_token | No | If the offer has an Advertiser Security Token enabled in TUNE, paste it here. It is appended to every postback as the security_token parameter; without it TUNE rejects the conversion (while still returning HTTP 200). Leave blank if the offer does not require one. |
purchase_goal_id | No | Insurance preset: the numeric TUNE goal ID for the policy purchase. Leave blank to not send purchases as a goal. |
lead_goal_id | No | The numeric TUNE goal ID for generate_lead (Offer > Payout > Goals). Leave blank if leads are not a goal of the offer: they are then not sent. |
sign_up_goal_id | No | The numeric TUNE goal ID for sign_up. Leave blank if sign-ups are not a goal of the offer: they are then not sent. |
add_to_cart_goal_id | No | Ecommerce preset: the numeric TUNE goal ID for add_to_cart. Leave blank to not send it. |
begin_checkout_goal_id | No | Ecommerce preset: the numeric TUNE goal ID for begin_checkout. Leave blank to not send it. |
Management UI Setup
- Go to Integrations > Add Integration > TUNE.
- Choose a preset: Default (
default), Retail (ecommerce), Lead Generation (lead_gen), Insurance (insurance), Travel (travel). - Fill in the fields above and click Save.
Request format
A purchase to the offer’s default goal:
GET https://demo.go2cloud.org/aff_lsr?adv_unique1=ORD-1001&amount=259.99&datetime=2025-09-22+00%3A13%3A20&promo_code=SAVE10&security_token=tok123&transaction_id=1027c887059b47bc69c699f45466b9A lead to its goal:
GET https://demo.go2cloud.org/aff_goal?a=lsr&datetime=2025-09-22+00%3A13%3A20&goal_id=7&security_token=tok123&transaction_id=1027c887059b47bc69c699f45466b9Event Mapping
| Signal event | Vendor event | Presets |
|---|---|---|
purchase | conversion | Default, Retail, Travel |
generate_lead | generate_lead | Default |
sign_up | sign_up | Default, Lead Generation |
add_to_cart | add_to_cart | Retail (no amount: a percentage-of-sale goal must not pay commission on a cart) |
begin_checkout | begin_checkout | Retail (no amount, as above) |
generate_lead | conversion | Lead Generation |
quote_completed | conversion | Insurance |
purchase | purchase | Insurance |
booking_completed | conversion | Travel |
Identity
The TUNE transaction ID is the only match key; conversions without it are not sent. The order or lead reference goes in adv_unique1. No personal data is sent.
Consent
TUNE documents no consent parameter. 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 |
|---|---|
| success=false; Invalid Trans. ID | The transaction ID is wrong or truncated: send the value TUNE passed on the click. |
| Goal events not sent | Set the goal ID for that event; goal events are not sent without it. |
| HTTP 200 but no conversion | TUNE answers 200 even for rejected postbacks; check its server postback logs. |
Blueprint
The TUNE blueprint version is 0.4.0. It was last reviewed against the vendor’s documentation on 2026-09-23.