Skip to main content
Skip table of contents

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:

  1. ref_adnetwork

    • The name of the Referral Source Provider (e.g., Meta, TikTok, Taboola)

    • Identifies where traffic was purchased

  2. 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

  3. 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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.