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

FieldRequiredDescription
network_idYesThe 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_tokenNoIf 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_idNoInsurance preset: the numeric TUNE goal ID for the policy purchase. Leave blank to not send purchases as a goal.
lead_goal_idNoThe 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_idNoThe 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_idNoEcommerce preset: the numeric TUNE goal ID for add_to_cart. Leave blank to not send it.
begin_checkout_goal_idNoEcommerce preset: the numeric TUNE goal ID for begin_checkout. Leave blank to not send it.

Management UI Setup

  1. Go to Integrations > Add Integration > TUNE.
  2. Choose a preset: Default (default), Retail (ecommerce), Lead Generation (lead_gen), Insurance (insurance), Travel (travel).
  3. 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=1027c887059b47bc69c699f45466b9

A 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=1027c887059b47bc69c699f45466b9

Event Mapping

Signal eventVendor eventPresets
purchaseconversionDefault, Retail, Travel
generate_leadgenerate_leadDefault
sign_upsign_upDefault, Lead Generation
add_to_cartadd_to_cartRetail (no amount: a percentage-of-sale goal must not pay commission on a cart)
begin_checkoutbegin_checkoutRetail (no amount, as above)
generate_leadconversionLead Generation
quote_completedconversionInsurance
purchasepurchaseInsurance
booking_completedconversionTravel

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.

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

ProblemSolution
success=false; Invalid Trans. IDThe transaction ID is wrong or truncated: send the value TUNE passed on the click.
Goal events not sentSet the goal ID for that event; goal events are not sent without it.
HTTP 200 but no conversionTUNE 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.

See also