Referral URL Builder
Referral URL Builder
The Referral URL Builder is a tool provided within your Ads.com account to help you generate properly formatted referral URLs for use in your advertising campaigns.
While this tool ensures your URLs are structured correctly, it is still your responsibility to ensure full compliance with all Ads.com policies and applicable guidelines.
Simply visit the Referral URL Builder within your account.
Purpose of the URL Builder
The Referral URL Builder is designed to:
Help format your referral URLs with the required parameters
Ensure proper URL encoding
Streamline setup for new campaigns
Reduce formatting errors that prevent traffic from rendering
However, this tool does not validate the accuracy, legality, or policy compliance of the information you provide. You are responsible for making sure all referral traffic meets Ads.com’s Compliance Policy, Tracking Requirements, and Terms and Conditions.
Required Parameters
To display the monetization feed, your referral URL must include the following three required parameters:
ref_adnetwork
The name of the Referral Source Provider (e.g., Meta, TikTok, Taboola)
Identifies where traffic was purchased
ref_pubsite
The Referral Source Publisher Site, or the specific site, app, or placement where the creative was shown
For platforms like Meta or TikTok, use
"meta"
or"tiktok",
since the Referral Source Publisher Site is typically the same as the Referral Source Provider.For Taboola/Outbrain, use the actual publisher site or domain
ref_keyword
The headline of the creative, plus any visible text or transcribed audio
This ensures the landing page and ads reflect the actual ad seen by the user
❗ If any of these parameters are missing or incorrectly formatted, your traffic will not render properly and the parked domain or site may not display content or results.
Additional Optional Parameters
The URL Builder also supports the following optional but useful parameters for campaign optimization and tracking:
terms (Dynamic Terms):
Suggest specific keywords to be displayed on the destination parked domain or site. These must be relevant to the topic of the parked domain or site and relevant to the Referral Source.s2s:
If your account uses multiple postbacks, you can use this parameter to select which postback to trigger on conversion.subid:
Add tracking identifiers to help monitor campaign performance. These values can be retrieved via both the API and Server-to-Server (S2S) postbacks.Custom Parameters:
Add any custom values required by your ad tracker or network. These are supported in S2S postbacks but not in the Ads.com API.
Your Compliance Responsibility
While the URL Builder simplifies URL creation and reduces errors, it does not check whether:
Your creatives are policy-compliant
The data you're submitting is accurate
The referral source or publisher meets eligibility requirements
⚠️ You are solely responsible for ensuring that all traffic you run complies with the full set of Ads.com policies and requirements. Refer to the Monetizer Terms and Compliance Policy for more information.