{"id":587,"date":"2018-12-14T04:49:44","date_gmt":"2018-12-14T04:49:44","guid":{"rendered":"https:\/\/www.leadshook.com\/help\/?p=587"},"modified":"2024-02-14T12:00:43","modified_gmt":"2024-02-14T12:00:43","slug":"how-to-use-url-parameters","status":"publish","type":"post","link":"https:\/\/www.leadshook.com\/help\/how-to-use-url-parameters\/","title":{"rendered":"How to use URL Parameters?"},"content":{"rendered":"\n

Introduction:<\/h2>\n\n\n\n

This guide explains how to pass variables to LeadsHook and send data back via URL to a third-party application, landing page, or website using URL parameters.<\/p>\n\n\n\n

Understanding URL parameters<\/h2>\n\n\n\n

You may configure your decision tree to accept URL parameters from referring URLs, such as coming from Facebook, Google paid ads, and save that information.<\/p>\n\n\n\n

For example you can send UTM parameters and any others you want to LeadsHook.  Append your URL parameters (e.g. UTM parameters) to the URL (see examples below).<\/p>\n\n\n\n

How to Save URL Params into Custom Field<\/h2>\n\n\n\n

Simply ensure your custom fields are the SAME as the URL params.  Then LeadsHook will save the values into those custom fields.<\/p>\n\n\n\n

E.g. if you want to pass ‘utm_source’ from google or facebook, then please create a text field in LeadsHook as ‘utm_source’<\/p>\n\n\n\n

URL parameters are set up with the following syntax:<\/p>\n\n\n\n

variable=value<\/strong><\/p>\n\n\n\n

E.g. adset_id=1233456789<\/p>\n\n\n\n

adset_id is the variable
1233456789 is the value<\/p>\n\n\n\n

Step by Step Instructions<\/strong><\/h1>\n\n\n\n

Incoming URL parameters<\/h2>\n\n\n\n

1. How to create and add a Custom Field<\/a><\/p>\n\n\n\n

The custom field type should be “text”:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Here is how you should create the custom fields:<\/p>\n\n\n\n

For example<\/p>\n\n\n\n

For this incoming URL..<\/p>\n\n\n\n

http:\/\/www.abcppc.com\/?utm_source<\/strong>=Chicago%2BTribuneutm_medium<\/strong>=Newspaper%2BOctober&;;
utm_campaign<\/strong>=Chicago%2BPPC%2BSale<\/p>\n\n\n\n

… you should create 3 custom fields, and you can name them exactly as:
utm_source<\/strong>
utm_medium<\/strong>
utm_campaign<\/strong><\/p>\n\n\n\n

Chicago%2BTribune<\/strong>, Newspaper%2BOctober<\/strong> and Chicago%2BPPC%2BSale<\/strong> are values sent by your traffic source.<\/p>\n\n\n\n

If the traffic source allows you to add variables, you should add variables. If you want to pass text or values, then simply add them, just like in the URL above.<\/p>\n\n\n\n

Warning: Please be sure to remove or add the trailing \/, if it does not work.<\/span><\/strong>
mydomain.com\/?  OR <\/span><\/strong>mydomain.com?<\/span><\/strong><\/p>\n\n\n\n

There is no need to add custom fields to a start page or decision tree.  As long as the custom field has been created in Leadshook, it will work.<\/p>\n\n\n\n

You can pass as many URL parameters as you want from any traffic source.<\/p>\n\n\n\n

As long as the variable names exist inside LeadsHook, the data will get saved into their respective fields.<\/p>\n\n\n\n

domain.com\/?utm_source=source&utm_medium=medium&utm_campaign=name&utm_term=term&utm_content=content<\/p>\n\n\n\n

Then, simply make sure you have the following custom fields setup:<\/p>\n\n\n\n

utm_source
utm_medium
utm_campaign
utm_term
utm_content<\/p>\n\n\n\n

Because LeadsHook has ZERO limits on the number of custom fields you can create you also pass additional details, such as:<\/p>\n\n\n\n

ad_id
ad_appeal
adset_bidding
conversion_goal<\/p>\n\n\n\n

Simply create the custom fields and your data will be saved into the respective custom fields.<\/p>\n\n\n\n

LeadsHook will grab the data even when your decision tree is embedded.<\/strong><\/p>\n\n\n\n

Your URL to the page where you embedded your decision tree will look like this:<\/p>\n\n\n\n

domain.com?utm_source=source&utm_medium=medium&utm_campaign=name&utm_term=term&utm_content=content&ad_id=ad_id&ad_appeal=ad_appeal&adset_bidding=adset_bidding&conversion_goal=conversion_goal<\/p>\n\n\n\n

Note: If the parameters are dynamic like ValueTrack, then be sure to add the traffic sources dynamic params like {source}. This way your traffic source will replace the params with values and pass those to your webpage.<\/p>\n\n\n\n

Outgoing URL Parameters<\/h2>\n\n\n\n

To pass data back out add the custom fields into your existing URL.<\/p>\n\n\n\n

The only change is now the custom field will be used as a value instead of the variable. The variable you use will be whatever your next platform or app uses.<\/p>\n\n\n\n

exit-domain.com\/?variable1={leadshook_customfield1}&variable2={leadshook_customfield2}&variable3={leadshook_customfield3}<\/p>\n\n\n\n

VIDEO: Using the Power of Decision Nodes to Distribute Leads<\/strong><\/p>\n\n\n\n

In this video, you’ll learn…<\/p>\n\n\n\n

How to capture data from your traffic source, such as a google ad, facebook ad, emails. native ads or from your own website.<\/p>\n\n\n\n

How to use captured data to add logic to a decision node to send the data back out to another web page or website via a url redirect, email marketing\/CRM connection or webhook.<\/p>\n\n\n\n