Overview
The integration provides:- Offer sync: Import offers from TUNE
- Conversion tracking: Conversions pulled via
Report/getConversionsAPI on a schedule - Revenue sync: Automatic payout updates
Setting Up
Step 1: Get TUNE Credentials
In your TUNE dashboard:- Go to Settings > API
- Create or copy your
NetworkToken - Note your network ID
Step 2: Add Integration in Trackly
- Go to Integrations
- Click Add Integration > TUNE/HasOffers
- Enter:
- Network ID (
network_id) - Network Token (
network_token) - Base URL (
base_url) — your network’s TUNE domain (e.g.,https://clicks.itstracking.com) - Affiliate ID (
affiliate_id) — your affiliate ID in the network
- Network ID (
- Click Test Connection to verify credentials
- Save the integration
- Message ID Field (
message_id_field): Which HasOffers field carries the Trackly message ID for conversion attribution. Default:aff_sub. Valid values:aff_subthroughaff_sub5,affiliate_unique1throughaffiliate_unique5,source. - Global URL Params: Parameters appended to every offer URL, supporting macros:
{{messageId}},{{offerId}},{{externalId}}
Step 3: Configure Conversion Tracking
Trackly syncs conversions from TUNE hourly via theReport/getConversions API with a 7-day lookback window. The sync uses a two-pass revenue bridge:
- Primary: The
ad_idon the TUNE conversion is looked up as aclick_idin Trackly’s click tracking, resolving to the original message - Fallback: The configurable
message_id_field(default:aff_sub) carries the direct 8-character message ID
Step 4: Configure Postback URL (Optional)
For offers you manage directly, configure a postback URL in TUNE pointing to Trackly’s conversion endpoint. The postback URL format and macros are generated in the offer’s Postback Config section.Offer Sync
Manual Sync
- Go to Offers
- Click Sync from TUNE
- Select offers to import
- Click Import
Automatic Sync
Enable automatic sync:- Go to Integrations > TUNE
- Enable Auto-sync offers
- Set frequency (daily, hourly)
What Syncs
| TUNE Field | Trackly Field |
|---|---|
| Offer name | Name |
| Destination URL | Tracking URL |
| Default payout | Payout |
| Payout type | Payout type |
| Advertiser | Advertiser |
| Status | Status |
Conversion Tracking
When conversions are pulled from TUNE:- Trackly calls the
Report/getConversionsAPI on a scheduled basis - System receives
click_idandpayoutfrom conversion data - System matches to original click
- Revenue attributed to message/creative/offer
Required Parameters
Your tracking URLs must passclick_id:
{click_id} is replaced with Trackly’s click identifier.
Troubleshooting
Offers not syncing
Offers not syncing
Check:
- API credentials are correct
- Network ID matches your account
- API access is enabled in TUNE
Conversions not tracking
Conversions not tracking
Verify:
- TUNE API credentials are valid and have report access
click_idparameter is being passed in tracking URLs- Conversion sync schedule is running
Payout mismatch
Payout mismatch
TUNE payouts may differ from Trackly if:
- Sync hasn’t run recently
- Offer has custom payouts per affiliate
- Currency conversion is involved
Multiple TUNE Accounts
If you have multiple TUNE networks:- Add each as a separate integration
- Prefix offer names to distinguish
- Conversion sync runs independently per network
Best Practices
Sync before campaigns
Sync before campaigns
Run a sync before launching campaigns to ensure offers are current.
Verify conversion sync
Verify conversion sync
Check integration logs to verify conversions are being pulled correctly from TUNE.
Monitor sync logs
Monitor sync logs
Check integration logs for sync errors or missing offers.
Next Steps
Revenue Tracking
Attribution and reporting
Offers Overview
Offer management basics