Home > Other Systems (CPVLab, iMobiTrax, P202, Track Revenue, Click, Google Analytics, etc.) > The STM Mobile Tracker

How To Set Up Geo, Carrier, Device And Other Redirects With STM Mobile Tracker v3/4 (56)

04-19-2013 02:36 PM #1 caurmen (Administrator)
How To Set Up Geo, Carrier, Device And Other Redirects With STM Mobile Tracker v3/4

Hey, everyone! Welcome back to this introduction series for the new Stack That Money Mobile Tracker v3/4.

This week we're looking at one of the coolest and most requested features of the tracker - the ability to easily set up redirects for location, mobile device, OS, carrier and more, with no coding required. Just select a few fields, and users will automatically be redirected to the right landing page, offer or URL depending on where they are or what they're browsing with.

Get The STM Mobile Tracker V4 here.

Other STM Mobile Tracker Tutorials

Video Tutorial

In this tutorial, I go through the process of setting up a redirect, and explain how to do it for yourself!

Password is "STMTuts"

How To Set Up A Redirect

In STM Mobile Tracker, at the top left select "Setup", then select "Redirects" from the sub-menu that appears right below the main menu.

You'll see a screen like this appear. Follow through the numbers to set up your redirect!

1. Redirect Name. Redirects are for a single traffic source URL only, so name your redirect something that will allow you to easily remember what it is. "Adult Mobile on TJ", for example.

2. Rule Nickname. Each rule redirects a specific subset of the people who have clicked on your URL - so, for example, one rule would be "UK Users", whilst another might be "US Users". You can select multiple conditions for each rule if you want to, say, redirect based on country and carrier. Name your rule appropriately - "US Rogers Users", for example.

3. Condition. This is where you select your conditions for redirection. It can appear complicated, but it's actually pretty simple!

First, select the type of redirect you want - the options are "Carrier", "OS", "Model", "Brand" and "Country". If you want to redirect based on several of these, choose one for now, and then add another Condition with the other one you want to consider (4 - Add A Condition)

Now, select the match type you want. Most of the time, you'll want either "Equals" or "NOT Equal" - that will exactly match the text you enter in the third box. So, for example, if you want to redirect United Kingdom traffic, choose "Equals", then type "United Kingdom" in the text box. If you want to redirect all traffic BUT UK traffic, choose "NOT Equal", then type "United Kingdom" in the text box.

If you want to match multiple entries - like redirecting all Windows phones, say - choose "Contains". You can then type a word that you know all the options you wish to redirect will include - "Windows", for example - and all Windows OS phones (if you selected OS in the first box) will be redirected.

Finally, type the words that you want to match in the text box. You can find the correct name of countries for matching in the MaxMind list of countries - use the full name, not the country code.

For Carrier, OS, Model and Brand, your best bet is to run your traffic source for a little while, then check names recorded by the tracker in Overview -> Group Overview. You can sort by Carrier, OS, Model and Brand there, copy-paste the names, and be sure they're right!

I've included a list of common Carriers, OSes, Models and Brands below.

Confused? Don't worry - check out my list of example rules below.

4. Add More Criteria. Click this if you want to add a second Condition for your Rule. So, for example, if you want to redirect all iPhone users in the UK, choose Country Equals United Kingdom as your first Condition, then click Add More Criteria, and add Model Equals iPhone in the second Condition.

Rules are always evaluated as an AND logical statement - in other words, the redirect will only happen if ALL Conditions for a Rule are true.

5. Redirect To. Pretty simple - either choose a landing page, a direct link (from your list of campaigns) or another URL to which the Tracker will redirect any user who fits your Conditions.

6. Delete This Rule. Remove this rule from the list.

7. Add New Rule. Often you'll just want a single rule - for example, "Redirect All UK Traffic to my lander". You can set the default destination for everyone else in "Default Fallback" (8). However, if you want several redirect options - one for UK traffic and one for DE traffic, or one for UK iPhone users and one for UK Android users, say - add another rule to set additional redirect options.

Again, if you're confused by this, see my Sample Rule Setups below.

8. Default Fallback. The LP, link or URL that anyone who does not fit your Rules will be directed to. So, if I've got a rule that redirects UK users on iPhones and a rule that redirects UK users on Android, anyone who is not in the UK OR not on an iPhone or Android phone will be redirected to this location.

9. Create. Click this to create your rule! Once you have created it, a standard STM Link creation dialog will open to the left of the rule pane:

Follow the steps as usual (see How To Set Up A Campaign With The STM Tracker) to generate a URL from this which you can paste into your traffic source!

And that's it! If you're confused, bemused or uncertain about anything I've said here, do let me know and I'll clear it up - or see the examples below!

04-19-2013 02:36 PM #2 caurmen (Administrator)

Example Rules

Here are a couple of example redirects that should show how the system works!

UK/DE Redirect

This will redirect UK users to one location, German users to another location, and everyone else to a third location.

UK Phones Redirect

This will redirect UK iPhone users to one location, UK Android users to another location, all other UK users to a third location and everyone else to a fourth location.

04-19-2013 02:36 PM #3 caurmen (Administrator)

Common Carriers, OSes, Models and Brands

Pulled straight from the still-beating heart of my mobile Follow-Along campaign, here are some of the more common identifiers you'll use in redirects.

Common Carriers

Comcast Cable
Verizon Wireless
Road Runner
AT&T U-verse
AT&T Wireless
Sprint PCS
T-Mobile USA
Verizon FiOS
Cox Communications
Opera Software ASA
Charter Communications
AT&T Internet Services
Optimum Online
Level 3 Communications
CenturyLink
Wangsu Science and Technology (US)
Verizon Internet Services
MetroPCS Wireless
BellSouth.net
Cricket Communications
Opera Mini Proxies
Embarq Corporation

Common Brands

Apple
Samsung
HTC
LG
Nokia
Opera
Motorola
[No Brand]
Acer
Google
ZTE
Huawei
RIM
Coolpad
Amazon
Kyocera
Generic
SonyEricsson
generic web browser
Barnes and Noble
T-Mobile

Common Models

Obviously, this will rapidly change over time!

iPhone
iPod Touch
Mini 7
GT-I9300
SGH-I727
SPH-D710
[No Model]
A210
LG855
Lumia 820
001HT
9292
Nexus 4
SGH-T989
Mini 5
Android
Inspire 4G
MS770
D01400
Nexus S

Common OSes

iPhone OS
Android
[No OS]
Windows Phone OS
RIM OS
Symbian OS
webOS
Windows Mobile OS
Windows RT
Palm OS
Linux Smartphone OS

04-19-2013 09:14 PM #4 w3061 (Member)

Man, awesome tutorials caurmen. I appreciate all the work you're putting into this. I've got a couple of probably stupid questions for you, but just wanted to clarify them.

In the UK Phones Redirect example above, I'm assuming it follows the logical path of evaluating the first expression, then the second, etc. where the user is redirected the first instance an expression returns true. So if the user meets the criteria for both #1 and #2 (for whatever reason), they are redirected the #1. Is that right?

Is the Passing Device Info option where you would include dynamic variables from the traffic source, assuming they are available?

04-20-2013 10:06 AM #5 caurmen (Administrator)

@w3061 - Thanks! Glad you're finding them useful!

Passing Device Info: you'd include dynamic variables under the Tracking Variables section (c1 through c8). So, for example, if you were doing POF, you'd use {age:} as Tracking ID C1, {state:} as Tracking ID C2, and so forth.

Evaluation order: let me just go check the code to be sure ... elevator music ... OK, back.

Rules are evaluated in the order that they were entered into the database - oldest first - NOT first listed first. However, I'd strongly recommend that you don't use overlapping rules - it'll make debugging your rules setup a lot easier.

(bbrock32, feel free to correct me if I'm wrong on that one!)

04-29-2013 03:13 PM #6 sarsap (Member)

Hi caurmen,

Do you know how can I fix that annyoing error?

Cannot use the new link too, it spits an error about the geoip.inc

Thanks

04-30-2013 10:41 AM #7 caurmen (Administrator)

@Sarsap - Aha, right, a few people have had this problem. Open /202-config/setup-config.php file, and on lines 105-106, change

Code:

'/usr/local/share/GeoIP/GeoIPOrg.dat'

Code:

$_SERVER['DOCUMENT_ROOT'].'/3rd-parties/GeoIP/'

That should fix the problem - please let me know if it doesn't!

04-30-2013 03:32 PM #8 sarsap (Member)

Hi caurmen,

Editing the setup-config.php didn't work for me, but I found another solution based on your code
I edited the checkdata.php line 45 from:

Code:

$dirs = array($_SERVER['DOCUMENT_ROOT'] . '/3rd-parties/geoip/', '/usr/local/share/GeoIP/');

to:

Code:

$dirs = array($_SERVER['DOCUMENT_ROOT'] . '/3rd-parties/geoip/', $_SERVER['DOCUMENT_ROOT'].'/3rd-parties/geoip/');

Now testing a new link gave the following error:
Warning: fopen(/usr/local/share/GeoIP/GeoIPOrg.dat): failed to open stream: No such file or directory in /home/myuser/public_html/mydomain.com/public/3rd-parties/geoip/geoip.inc on line 385
Can not open /usr/local/share/GeoIP/GeoIPOrg.dat

Fixed by editing 202-config.php lines 9-10 from:

Code:

$geoOrgFile = '/usr/local/share/GeoIP/GeoIPOrg.dat';
$geoCountryFile = '/usr/local/share/GeoIP/GeoIP.dat';

to:

Code:

$geoOrgFile = $_SERVER['DOCUMENT_ROOT'].'/3rd-parties/geoip/GeoIPOrg.dat';
$geoCountryFile = $_SERVER['DOCUMENT_ROOT'].'/3rd-parties/geoip/GeoIPCountry.dat';

Also needed to case sensitive geoip folder in both lines.
Everything works great so far.

Thanks

04-30-2013 06:06 PM #9 caurmen (Administrator)

Nice work there! I'm sure that'll be useful for other people hitting the same issue.

Glad it's all up and running.

05-01-2013 04:20 AM #10 w3061 (Member)

I'm confused by the Passing Device Info part. Is this only for circumstances where dynamic tokens are available from the traffic source? What do you need to do to support these parameters and how do you access them from your lander? Are they in the URL? In the database? Are the variable names explicitly named "carrier, brand, os and model?"

05-01-2013 10:13 AM #11 caurmen (Administrator)

I'm confused by the Passing Device Info part.

No problem - this is one of the coolest features of the new tracker IMO, but it does take a little getting your head around!

Once I get back from Amsterdam, I'll do a mini-guide to using this info in your landers.

Is this only for circumstances where dynamic tokens are available from the traffic source?

No - the WURFL and Org IP plugins will give you the data regardless of your traffic source, because they're actually parsing the useragent string and IP.

What do you need to do to support these parameters and how do you access them from your lander? Are they in the URL? In the database?

The tracker passes them to the LP as GET parameters - so you can just use

Code:

$carrier=@$_GET['carrier']

and then

Code:

<? echo $carrier ?>

to echo the carrier in your LP.

Are the variable names explicitly named "carrier, brand, os and model?"

Yes, that's exactly right - those are the names of the GET variables passed to your lander.

05-03-2013 03:32 PM #12 aeroian (Member)
Analyzing

I've pretty much only used CPVLab so please forgive the basic question - What is the best way to analyze the carrier/os/etc conversion data on this interface? The only place i'm finding a call out for these is under overview > group overview. Is there anywhere else I should be looking? Thanks

~Ian

05-20-2013 04:34 PM #13 kyuss (Member)

Hey Caurmen, cheers for the tutorials!

Just a couple of questions, what is the best way to make a rule that will redirect to a rotating lander (while keeping c1-c8 variables etc.)?

With the geo redirects, it works if I redirect to a custom URL. If I set it to redirect to a simple landing page it doesn't work for me, it goes to: trackingdomain.com/tracking202/redirect/tracker.php?t202id=&t202kw=

Any help would be appreciated!

05-21-2013 11:24 AM #14 caurmen (Administrator)

Hmm, that's odd.

I'll need to test and reproduce this. Can you list ALL the steps you go through to set up your geo redirect with a simple LP?

I'll follow them through and figure out what's going on.

05-28-2013 11:41 PM #15 avalanche (Member)

Where do we get the country names to use in our redirects? For example, I'm not sure if I should put in United States, USA, or United States of America for a redirect. I'm clicking all through the reports but can't seem to find where that data would be.

05-28-2013 11:58 PM #16 w3061 (Member)

Originally Posted by avalanche

Based on caurmen's examples above, you would put United States. The list of countries can be found at http://dev.maxmind.com/geoip/legacy/codes/iso3166

05-29-2013 10:00 AM #17 caurmen (Administrator)

Yup, that's correct - follow the naming conventions in the document w3061 listed.

06-15-2013 02:12 PM #18 kyuss (Member)

Originally Posted by caurmen

I think I found the problem. If I create a redirect and then generate the link it will work. If I edit any of the rules at all, then try to use the previously generated link it will not work anymore, even if I switch it back to exactly the way it was before. If I generate a new link it will work fine until the rules are changed again. I was just testing between a few countries using GEO rules to redirect between simple LPs and custom URLs.

06-15-2013 02:46 PM #19 caurmen (Administrator)

@kyuss - have you tried clearing your memcache? Either wait 5-10 minutes or use Flush All - tutorial here: http://www.cyberciti.biz/faq/linux-u...ched-instance/

That's often the problem behind these sorts of issues. It can look hella wierd if memcache is still holding half the data for old rules.

06-25-2013 12:15 PM #20 soulest (Member)

Hi caurmen

I have got this message once I purchase.

Thanks for your order with MaxMind. For licensing purposes, we ask for information on where the database will be deployed. Please send us the following:

1. Established website where you plan to deploy the database or web service
2. Email based with that website
3. How you plan to use the database or web service
If we are unable to process the order, your credit card will not be charged.

Should I just inform them to deploy on the domain where I got the prosper installed ?

06-25-2013 01:15 PM #21 caurmen (Administrator)

That's new! They didn't do that when I purchased the database.

Did you definitely purchase the "GeoIP Organization" database? It might be that you accidentally bought one of their bigger-ticket products.

Failing that, I'd get in touch with them and explain that you're deploying on a new website, and you'd prefer not to reveal too much information, and see what they say.

Let us know how you get on, this might be rather important! Thanks for posting about it.

06-25-2013 03:50 PM #22 dollar5 (Member)

Thanks for the great tutorial @caurmen

06-25-2013 05:26 PM #23 soulest (Member)

Lol caurmen

This is wat I get after tat...

" Do you have another established website with an email that you could utilize for processing this order? "

06-25-2013 06:23 PM #24 soulest (Member)

Actually these max mind ppl don really appeared to be friendly. Here's wat I got at the end

"On our shopping cart, it says:
"We require an email associated with an established website in order to process the order."
https://www.maxmind.com/en/cart

It would make it much easier if we had an email with established website to process the order. How are you using the database?
If you prefer to not provide this information, we could cancel the order, no problem."

Anyway..since I have to rely on STM mobile tracker which rely on their database...wat to do...
I have created my email..but really no idea how to tell them how I plan to use the database.

06-25-2013 07:57 PM #25 bbrock32 (Administrator)

^^ Just tell them you need to use to detect carriers on your website

06-25-2013 10:29 PM #26 soulest (Member)

Shud I give him my lp domain email or prosper tracking domain email? Since they brought up licensing issue...jus worry if they say its only for certain website..n has to be deploy on the same...

06-26-2013 12:49 AM #27 zeno (Administrator)

Can you not say it's for detection of carrier during data logging in a private non-commercial click tracking system. It is not being deployed on a website providing content to internet users.

Surely that would suffice as an explanation. As for email, lol use a gmail address, gmail.com is a well established and reputable website.

06-26-2013 01:44 AM #28 soulest (Member)

Hi Zeno

Actually i am still struggling on the way to reply on "how you plan to use the database", the only reason is if they come out with follow up question, i am afraid that i couldn't answer d lol

Also, as for email, i did offer my gmail and they have actually insisted on having email from my established website or they can cancel my order lol

06-26-2013 02:25 AM #29 zeno (Administrator)

Originally Posted by soulest

Do you not have an 'established' website? Most marketers have a generic page about who they are, contact details etc just to look semi-legit and to provide to affiliate networks when they join. It need only be a single page with a professional-ish design and contact detail. You can then use your email from that site, e.g. accounts@bosslevelmarketing.com.

06-26-2013 03:00 AM #30 soulest (Member)

Originally Posted by zeno

Hi Zeno,

Yes, in fact i have 2 domain, 1 is for tracking purpose (www.trackingxxxxxx.net) , 1 is www.landingpagename.com. I have created email for both domains. However, i have yet to create the semi-legit professional layout yet. working on it now. Anyway, i have sent you a PM, appreciate if you can have a look on it. thx

06-26-2013 09:51 AM #31 caurmen (Administrator)

Easiest way to get yourself an "established website" for this purpose would probably be to get a cheap hosting package with Wordpress. Shared hosting will be fine, Bluehost or something is probably perfect. Get a domain at the same time.

Stick a free "business" theme on it - Google can give you hundreds of options - change the header graphic and fill in some very basic contact details. Voila - one reasonably professional-looking site for $14 and half an hour's work.

You can then use that for, as Zeno says, getting into affiliate networks, and also for getting MaxMind to get their nose out of your business

06-26-2013 01:25 PM #32 zeno (Administrator)

Originally Posted by soulest

Here you go, save yourself some time: http://stmforum.com/forum/showthread...878#post110878

07-31-2013 12:17 AM #33 cosmeivan ()

Hey Kyuss, did find a workaround for this issue? I'm having the same problem when using redirects to landing pages..

I mean, yeah I gotta generate a new link if I change the rules. But I already submitted some banners with the old link.
Is this a normal process or a bug maybe?

Originally Posted by kyuss

07-31-2013 11:55 AM #34 caurmen (Administrator)

@cosmeivan - Try flushing your Memcache after you add the rotating lander to your rule. Either use http://www.cyberciti.biz/faq/linux-u...ched-instance/ or just wait 10 minutes and see if it works then.

Let me know if that works - if not, we'll figure out what's going on and fix it.

07-31-2013 01:52 PM #35 cosmeivan ()

Sure Caurmen, I waited about an hour for the Cache to get cleared. But the issues persist. The thing is I set a Redirect rule for Android (OS), so Android users would go to a landing page from camp1.
Everything else would go to Lander2 from Camp2.

When I tried the first time, it worked fine with my Android phone, and on Web it redirected to the default lander I set. But when I changed the rules to point to another landers. The old generated link only worked for the default redirect, when I try with Android it just doesn't work.

On the other hand, if I generate a new link for the redirect rule, it works just fine. So, I take it I won't be able to change the rules after I upload my banners to the traffic source?

07-31-2013 04:24 PM #36 caurmen (Administrator)

Let me look into that and get back to you.

12-16-2013 11:15 AM #37 dynamicsoul (Member)

Any help with redirect appreciated here.. The tracker works for normal linking to a lander, and collecting all the geo and carrier data etc..

But I tried to set up a redirect rule based on operating systems.. and when I take the link it gives you (set up from right of the redirect rules page,in the "test it" box) I get this error..

Warning: fopen(/usr/local/share/GeoIP/GeoIP.dat): failed to open stream: No such file or directory in /home/surf/public_html/3rd-parties/geoip/geoip.inc on line 385
Can not open /usr/local/share/GeoIP/GeoIP.dat

I looked at what seems a similar issue on the first page of this thread.. But not sure if that is same issue or not?

12-16-2013 11:51 AM #38 caurmen (Administrator)

Aha, this problem!

Copy GeoIP.dat from the 3rd-parties directory to /usr/local/share/GeoIP on your machine. It should work then.

12-16-2013 12:02 PM #39 dynamicsoul (Member)

I don't have a GeoIP.dat? only an GeoIPOrg.dat and GeoIPCountry.dat

http://prntscr.com/2bkpiu

12-16-2013 02:18 PM #40 kyleirwin (Member)
How To Set Up Geo -, Carrier, Device And Other Redirects With STM Mobile Trac...

Originally Posted by dynamicsoul

I don't have a GeoIP.dat? only an GeoIPOrg.dat and GeoIPCountry.dat

http://prntscr.com/2bkpiu

The GeoIP country dat file is the "GeoIP" .dat file. You need to rename the file, or update the file path in 202-config.php with the valid file name.

12-16-2013 03:33 PM #41 dynamicsoul (Member)

Ah.. I'm giving up.. I renamed it, then it said it couldn't find the GeoIPCountry.dat

So I added both file names into folder.. now it redirects.. but not to my landers.. just to the fall back link.. Tried with my android mobile, and it's not having it.

I will just try creating seperate campaigns for each device type.. pain..

Thanks anyway..

12-16-2013 03:40 PM #42 kyleirwin (Member)

Originally Posted by dynamicsoul

Nooo! Don't give up!

Sorry my instructions didn't help. I PM'd you my contact info. Hit me up on chat and we'll get you straightened out

12-16-2013 07:46 PM #43 dynamicsoul (Member)

If I could thanks you 100 times I would. Thanks so much kyle for helping me out!

01-30-2014 11:19 PM #44 dario (Member)

I've added a rotating LP item, adding 3 LPs into a new "#10 Get Rotating Lander" item called "Rotating 001".
Is it possible to add a Geo-redirect rule that redirects toward this "Rotating 001" instead of just one single LP ?

Excuse me if this has been asked before, but I didn't find an answer.

01-31-2014 04:02 PM #45 caurmen (Administrator)

I am reasonably certain that it is possible to do that, yes.

02-04-2014 03:50 PM #46 dario (Member)

I have a question about the MaxMind DB we added to our server in order to get the geo-redirect rules working: can I use this DB to show other info to the user ? (not saying exact city but a least region?). What's the best solution to show on a Landing page the visitors' area/region name ?

02-04-2014 03:53 PM #47 bbrock32 (Administrator)

Nope you need another DB for that.

It's called GeoIPCity , can buy directly from the same site.

06-27-2014 08:35 AM #48 wisejackass (Member)

Originally Posted by dario

Hello,
Did you manage to achieve this? I was thinking about using the rotator's generated URL in the direct link section of the Rule. But in this way i won't be able to pass keywords, because the direct link would be static.
Thanks in advance!

08-18-2014 07:26 PM #49 julien (Member)

Hey Caurmen, I'm not sure if it has been answered sorry for asking again

Is it possible, instead of choosing a single LP, to choose a rotating lander in addition to a redirect rule?

Thank you very much for your answer

08-19-2014 09:59 AM #50 caurmen (Administrator)

@Julien - Yep, that should work fine.

08-19-2014 10:22 AM #51 julien (Member)

Thank you, but how do you set it up technically?

Because under the tab #9 Redirects, I don't see the rotating landers created at step10 in the <select> elements.
I dont' find them, neither in Landing Page, nor in Campaign, nor in Direct Link (URL).

08-20-2014 03:40 PM #52 julien (Member)

Oh, I was trying to sort this out and I was just wondering:
To make geo redirect working with rotating landers, maybe I can try to:

1/ setup a rotating lander on tab #10 Get Rotating Lander
2/ get the link of the rotating lander then
3/ and put this link in in the field "Direct Link (URL):" under the tab #9 Redirects

Is this the proper way to set this up?

Thank you for your answers

08-20-2014 06:37 PM #53 bbrock32 (Administrator)

^ Yes that is correct

08-20-2014 08:41 PM #54 julien (Member)

Thank you Besmir, so it was that simple

And for the C1, C2, C3 etc. tracking parameters that I want to fill with the tokens provided by ad netwoks, do you add them under the tab #10 (Get Rotating Lander) or at the very end under the tab #9 (Redirects)?

EDIT:
After testing Cx parameters and Keyword parameter in the URL, it seems that they are not tracked anymore when you use a rotating lander in a redirect rule... Can you confirm that?

08-20-2014 09:04 PM #55 julien (Member)

Hmmm ok, actually it worked... But since we have to enter all the parameter at step #10, if one of them have to change (i.e. if the networks doesn't have an automated token like [creative]), we have to create one rule per creative.

At least, it's working now, I'll check out later if that can be optimized in some way

08-22-2014 07:24 PM #56 caurmen (Administrator)

Phew, glad this was sorted!

Home > Other Systems (CPVLab, iMobiTrax, P202, Track Revenue, Click, Google Analytics, etc.) > The STM Mobile Tracker