URL Parameters
Samantha avatar
Written by Samantha
Updated over a week ago

Default Parameters

By default, Friendbuy includes four of the the five standard UTM parameters in the URL when referred Friend traffic is directed to your site from a referral link.

  • Utm_campaign

  • Utm_content

  • Utm_medium

  • utm_source 

In addition to the four above UTM parameters, Friendbuy also always includes a URL parameter that represents a unique identifier for the referral.  This is the fbuy_ref_code parameter. 

Here is an example of what a fully redirected URL may look life for a referred Friend that is taken to your site when clicking on an Advocate's referral link sent via email: https://www.yourcompany.com/refer/friends/?utm_campaign=Refer-a-friend+Landing+Page&utm_content=email&utm_medium=referral&utm_source=Friendbuy&fbuy_ref_code=Zz012a

Custom URL Paramaters

Adding custom URL parameters can help you accomplish various tasks such as analyzing referral traffic in Google Analytics, applying a session based discount to the Friend’s shopping cart, or even displaying a pop-up based on whether or not the customer came in from your referral program.

If you’re interested in further customization such as adding new custom parameters, you can do so by adding static values to the Destination URL configured for a campaign or dynamically passing the values via the widget integration JavaScript . Custom parameters that are passed via the widget code will overwrite the values entered in the Custom Parameters Settings. The parameters for shares via email, Facebook, Twitter can not be updated however the parameters for PURLs will update with the custom parameter changes.

Learn how to pass custom dynamic parameters in our developer docs.

Modifying Values for Default UTM Parmaters

You can modify the values for the following UTM parameters within Friendbuy:

  • utm_source

  • utm_medium

To modify the default values, follow these steps:

  1. Log in to your Friendbuy account

  2. Navigate to Settings > Configuration > Custom Parameters

  3. Edit the custom value(s) associated with the parameters

Did this answer your question?