website logo
WildlinkWildfire-corpFeaturesNetworkCompanyPricingResourcesContact us
⌘K
Wildfire Systems Knowledgebase
Partner Admin
Commission History
Performance Summary
Desktop Solutions
Browser Extension Authentication
Implementing Wildfire Coupons into an existing Chrome Extension
How to Implement OAuth in a Chrome Extension
Direct tracking code injection to extension
Mobile Solutions
Android MCA SDK Guide
Android MCA Permission Compliance
How to implement the Mobile Safari Extension
Wildfire APIs
Country filtering and multiple applications
Public Commission Sample Data
Getting to know the Wildfire JSON Data Feeds
Creating links
Commission History
Gift Card
Merchants and Domains
Merchant Images
Tracking Code (TC) Parameter
Syncing Commission Data via API and Callbacks
Working with Wildfire Coupon Data
Getting started with the Wildfire API Postman collection
FAQ and General Resources
Jump Track
Best Practices
6 Reasons Why a User Might Not Get Credit for Earning
FTC Compliance Overview
Stand-Down Policy Compliance
Docs powered by archbee 
16min

Creating links

Overview

There are two ways to create links that will attribute commissions to you and your users:

  • Vanity URLs
  • Expanded URLs

With Wildfire there are a couple of ways to create links that will give credit for commissions to you and your users.  There are two main use cases we support:

  1. Your user wants to share a link to a merchant (any page at a merchant, like a product page) so they can earn when their shared link is used to make a purchase. These links are usually shortened, so they're easy to add to an email, text message, etc. We call these Vanity URLs.
  2. Everything else, including when users want to earn cashback on their purchases, click through a cashback appeal in search results for products, etc. We call these Expanded URLs.

Vanity URLs

Because Vanity URLs are shortened, they need to be created "as needed" and so they require making a call against our APIs. You can learn about how to use our API to create a Vanity URL as part of our Postman collection.

Expanded URLs

If you want to create an Expanded URL, there's no API hit required. You'll build this URL yourself using a couple pieces of data. You just need to know the associated merchant ID and your branded domain.

Here's an example of an Expanded URL that uses wildlink.me as the example domain.

Text
|
https://wild.link/e?c=5483936&d=54321&url=https%3A%2F%2Fwww.walmart.com%2Fcp%2Fcamping-gear%2F4128

  • The c value in this example is the Wildfire Merchant ID.
  • The d value is an attributed Wildfire Device. If your product doesn't use devices because it's not a client-side software, just choose any of your devices for this value. You can learn more about how to create a Device for your application in the Postman collection.
  • For the url value it should match the Merchant ID referenced in the c value and it should be URL-encoded. Note that the url value is a deep link and not the merchant's homepage. The url parameter is optional. If no deep link is required for your use case (i.e. a user clicking through a directory of merchants) and none is specified, then the link will take the user to a default URL for the merchant (usually the homepage).

You can find more information on how to get Merchant IDs for use in building these URLs from the  Merchants and Domains article.

Optional Parameters

Once you have a URL of either type (Vanity or Expanded) you may add optional parameters to the URL for enhanced functionality.  Note that most browsers only accept URLs up to 2048 characters.  Because of this, we recommend having the deep link URL (if you're using it) as the last parameter to ensure that other parameters are not beyond the 2048 character limit where they may get dropped/ignored.

Tracking Code

A Tracking Code (often referred to as a TC parameter) can be added to a URL for tracking other information you want associated with purchases through these links. Learn more about Tracking Code (TC) Parameter.

Example Vanity URL with a TC value appended:

Text
|
https://wild.link/walmart/abc123?tc=foo


Example Expanded URL with a TC value appended:

Text
|
https://wild.link/e?c=5483936&d=54321&tc=foo&url=https%3A%2F%2Fwww.walmart.com%2Fcp%2Fcamping-gear%2F4128


Unique Identifier

In order to assign a unique value to each user you can add a UID parameter into the tracking code.

The UID value should be in the Universal Unique Identifier Layout: In its canonical textual representation, the 16 octets of a UUID are represented as 32 hexadecimal (base-16) digits, displayed in five groups separated by hyphens, in the form 8-4-4-4-12 for a total of 36 characters (32 hexadecimal characters and 4 hyphens).

For example:

  • 123e4567-e89b-12d3-a456-426614174000
  • xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx

Here is  additional resource for more help.

Preferred Country

A Wildfire application has a single country associated with it.  In some cases, our partners operate exclusively within a single country while others operate in multiple countries.  Our merchant programs often operate in several countries and matching your application and its users to the right merchant country is important.  By default, all links (Vanity and Expanded) will match your application's country to the appropriate merchant country to ensure proper affiliation.  For extension software, we further automatically match domain to merchant country (i.e. walmart.ca for Canada) so this association is handled automatically and there is no additional work required by our partners.

However, there are some use cases where a partner will want to select a specific merchant country.  A common example is an "offer wall" where the partner is using our APIs to present a list of feature merchants.  When using a single application to present a merchant to users in multiple countries where the merchant operates (i.e. UK, Canada) the partner needs to indicate which country Wildfire should reference.

Using the Preferred Country parameter (often described as the PC parameter), the partner can override the default application country.  It's important to note that not all merchants operate affiliate programs in all countries, so you will need to use Getting to know the Wildfire JSON Data Feeds that describes the countries each merchant supports. Because not every merchant supports every country you'll need to verify that you only use the codes specified for each merchant.

For example, the following merchant has IT, FR, and GB available for earning commissions. If your user is in one of these three countries this merchant can be used to earn commissions. However, when creating the wild.link the country code, matching the user’s location, must be specified. If the user is in Italy and you don’t specify the country code, using pc=IT, the system will default to your application’s default country and potentially prevent commissions from being earned. 

Example merchant data:

JSON
|
{
    "ID": 1234567,
    "Name": "Merchant Name",
    "PaysNewCustomersOnly": false,
    "ShareAndEarnDisabled": false,
    "Categories": [
        {
            "ID": 49,
            "Name": "Women",
            "ParentID": 1
        },
    ],
    "Countries": [
        "IT",
        "FR",
        "GB"
    ],
    "Images": [],
    "Score": 0
}


Here's an example Vanity URL that can be used for a US application to force the affiliate to the Walmart Canada program:

Vanity URL
|
https://wild.link/walmart/abc123?pc=CA


And here is the same example in an Expanded URL:

Expanded URL
|
https://wild.link/e?c=5483936&d=1912282&pc=ca&url=https%3A%2F%2Fwww.walmart.com%2Fcp%2Fcamping-gear%2F4128


Note that the value for the PC parameter is not case sensitive.

Also note that you should avoid selecting an invalid value for the PC parameter by all means. If an invalid value is passed in the PC parameter (either a completely invalid value like "XX" which is not a real country code or a a valid country code that isn't a country that the merchant operates in) the Wildfire system will select the program with the highest max commission amount which may not match the application's default country.

Updated 02 Mar 2023
Did this page help you?
Yes
No
UP NEXT
Commission History
Docs powered by archbee 
TABLE OF CONTENTS
Overview
Vanity URLs
Expanded URLs
Optional Parameters
Tracking Code
Unique Identifier
Preferred Country