Tutorial: Using Taveo with your domain

  2 years ago by Admin

For some users, Taveo's tav.so , tav.pw or zo.gd domains are sufficient. But these have some limitations. You cannot choose what the public URL looks like when you create a new link and all of our domains use 5 randomly chosen characters. If you would like to have greater control over the public portion of your url read on to see how.

In order to add Taveo to your site, you will need to add information to your web servers config file (Apache, Nginx, etc). If you are uncomfortable doing this, please consult your web host provider for information on modifying your server config. We hope to have a Wordpress plugin finished shortly that will automate this process!

Wouldn't it be nice to have your tracking links look just like regular links? Or run your own personal URL shortening service just for your website? With Taveo custom domains you can do just that! For instance, if you are the owner of www.ablog.com you can have Taveo tracked links at www.ablog.com/links/link1 or www.ablog.com/l/z. By doing this, you can hide the fact that you are even using a link tracking service and you have full control over the text in the link. You can also use Taveo on sites that do not allow URL shorteners (such as Pinterest). Read on to learn how.

First, determine which website you want Taveo links enabled on. This should be a website / domain you are the owner and have control of. You CANNOT enable Taveo on websites you don't control. Lets pretend I am a blogger and I own the domain name www.joetheblogger.com

Second, choose a base path for where all of the Taveo urls on your domain will start. This should be a a few characters long, the shorter the better. 1 or x is a good choice. For example purposes I am going to choose x. You will see me use this throughout the tutorial. Replace x with what you have chosen.

Putting this together, we end up with a final path of www.joetheblogger.com/x. Let's enter this data into Taveo's admin panel. Open Domain Management. Open this link and click the blue button that says "New Domain". In the popup, enter the final path you have chosen above, like this:

Optionally add a comment and click the "Submit" button. Once the domain page refreshes you should now see your new domain has been added. Additionally, you will notice a "Key" has been created for your domain. This API Key is required for Taveo to attribute clicks to your domain. Using your mouse, highlight and copy this key, we will use it again in a few minutes. In this example, the key is 3986c078df22b5bdeac29245809d0dcb

Now we need to edit your servers configuration file, depending on what server software you are running.


For Apache, we will be adding a few lines to your sites "VirtualHost" file. On some servers this can be found at /etc/apache2/sites-enabled/default. We will be using Apaches ProxyPass directive to forward requests to our server. Ensure Apache has the mod_proxy module enabled. Add the following lines of code inside the <VirtualHost> directive:

   <Location /x>
       ProxyPass http://tav.so/api/l/<YOUR-API-KEY-HERE>



For Nginx we need to add a few lines of configuration to your "server" block. We will be using the proxy_pass directive to accomplish this. Add the following lines of code to your configuration, under the "server {" block.

    # ShortLinks
    location /x {
        proxy_pass http://tav.so/api/l/<YOUR-API-KEY-HERE>
        proxy_set_header X-Real-IP $remote_addr;


These configuration options tells your server to forward all requests that start with /x to Taveo's server. The API key is used by Taveo to route the incoming request to the correct location. Restart your web program to apply the configuration. Now we can add links to Taveo using your website. Head over to the Link Management page to add a new link on this custom domain.

The method for adding links for this domain is the same as our Creating your First Link tutorial, only you select "Your Website" in Step -1. Below I am creating a new link that will be publicly available at http://www.joetheblogger.com/x/joerocks.

And there you have it, we just added your domain to Taveo, configured your server to forward data to us and added a new Link using your new domain. In this demonstration I enabled the public URL to http://www.joetheblogger.com/x/joerocks track clicks and forward end users to wherever I want.

Can't find the answer to your question? Contact our support team