Overview
The integration provides:- Offer sync: Import offers from TUNE
- Conversion tracking: Conversions pulled via
Conversion/findAllAPI 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 pulls conversions from TUNE via theConversion/findAll API hourly over the past day, plus once nightly (Monday–Saturday) over the past three days. If a conversion sync fails or the integration is paused, the next run widens its window to cover the gap since the last successful conversion sync, up to 90 days. Conversions are matched back to the originating message in two ways:
- 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 Integrations
- (Optional) To scope the sync, click Edit on your TUNE integration, turn on Filter by Offer ID, and paste the offer IDs to include
- Click Sync on your TUNE integration
Automatic Sync
Confirm automatic sync is on:- Go to Integrations and click Edit on your TUNE integration
- Confirm Auto Sync is on — it is enabled by default
What Syncs
Conversion Tracking
When conversions are pulled from TUNE:- Trackly calls the
Conversion/findAllAPI on a schedule - System receives
click_idandpayoutfrom conversion data - System matches to original click
- Revenue attributed to message/creative/offer
Required Parameters
No click-id parameter is required in your tracking URL — Trackly appends its own click identifier asad_id when a contact clicks. To enable the message-ID fallback as well, add the message ID to Global URL Params using the field named in Message ID Field, for example aff_sub={{messageId}}.
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
- Contacts are clicking Trackly’s tracked link (so the click identifier gets attached automatically)
- 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