Skip to main content

Rotator

A rotator is a traffic distribution tool that sends incoming traffic to destination based on various rules you set up.

You can use it as a redirection tool, a link shorter, or a shield to prevent unwanted traffic.

How it works​

Rotator consists of three concepts:

  • Default Destination

  • Conditional Destination

  • Redirection Method

When a visitor open a rotator link, the rotator will try to test all rules with visitor's features(country, browser, os...etc) in conditional destinations(if any), if a conditional destination is matched, it will be picked as "matched" destination.

If there are no conditional destionation, or all conditional destionations are not matched, rotator will pick up a default destination as "matched" destination.

Then, the rotator will use the "redirection method" you have set in rotator, to let this visitor go to the "matched" destionation. All parameters on rotator URL will be passed through to destination. You can add as many parameters as you like to rotator link.

When to use rotator​

MaxConv's default tracking setup is intended to use the direct link to let visitors go to the landing page or offer page.

But it's not rare that you want to add a redirect or split-testing to landing pages or offers, then rotator should come into play.

For example - if you want to split test multiple offers on a lander, you can just create a rotator will all the offers you want to test, and use that rotator url as CTA url on landing page.

Visit API​

The rotator visit API provides a method to rotate your destination with 0 redirection.

tip

To use this feature, you need a php-enabled server to host our api client.

Follow these steps to use rotator visit api

Step 1. Create rotator with all landing pages​

Go to "Rotators" page, Click the Create button, a creation form will show up.

create

  1. Provide a name for this rotator

  2. Provide rotator link slug, or you can use the "reload" button to generate random slug.

  3. Choose the redirection method, in this example, we choose "302 Redirection".

  4. Turn on Rotator Visit API field.

dest

  1. Click the "Default Destination" on the left menu to configure default destination.

  2. Set all landers you want to test.

Click "Save" button to create rotator.

tip

You should also put universal tracking script and CTA link to all landing pages as usual, rotator just pick one landing page to display, won't change anything in landing page.

Step 2. Generate API key​

Go to Settings >> Security >> API Keys, generate a new API key.

Step 3. Download the rotator visit api php file​

download-api

Go to Settings >> Tracking >> Rotator Visit API, click the button to download php file.

Open the php file, replace "Your API KEY Here" with your API key, then go to the rorator page, copy the rotator url and replace "Your Rotator Url Here" with it, so your rotator-visit-api.php file should look like this:

<?php

// --- config area start--- //
// get your api key from settings->security->api keys
$apiKey='ZvdHfpRogVqac75eCH8lnrhnVsTMV318';

//your rotator url
$rotatorUrl='https://demode.mcgo2.com/go/UkUWlcQ9';
// --- config area end --- //

Step 4. Rename file and upload to your server​

Now you can rename the rotator-visit-api.php file to any name you like, and upload to your server, for instance - let's rename it to page.php and upload it in the sub directory of /great-sale/ directory in website root.

We can visit the url https://domain/great-sale/page.php to see the result.

tip

All the assets's path in page html code will keep unchanged, the api php file just fetch the landing page source code.

So we suggest to put all assets in the same directory as api php file, or put all assets on a CDN, that way you landing page can be correctly rendered in browser.

Step 5. Generate ad campaign URL​

Now use the php file url to generate ad campaign url.

generate-url

Will landing page get messed in report when using rotator API?​

No, MaxConv will automatically attribute traffic to actual landing page, so your report will keep accurate.