Admitad Teleport

  • Aggiornato

Admitad Teleport is a tool for Admitad Affiliate publishers who own a website, browser, or browser extension. When Teleport is enabled, users will get to the advertiser’s website directly through your link: with no redirects to the affiliate network’s website. Down the road, more target actions will be tracked and captured.

You can find Admitad Teleport in the upper menu of your personal account in the Tools section.
 

Who can access Admitad Teleport?

Currently, Admitad Teleport is only available to publishers owning the following types of ad spaces:

  • A website: a cashback service, forum, personal blog, review/testimonial website, news or media portal, coupon service, affiliate store, loyalty program
  • A browser or browser extension.

If you own an ad space of any other type but can modify its code, please contact tech support or your manager to learn whether you’re eligible to use the tool.
 

Admitad Teleport benefits

Admitad Teleport eliminates redirects to the affiliate network’s website and accidental blocks

The diagram reflects the standard model flow and Admitad Teleport’s flow. You can find the description under the diagram.

3_teleport-EN.png


Usually, when a user clicks on an affiliate link in your ad space, the user travels across a few redirects: link → Admitad Affiliate website → advertiser’s website.

 

Since the browser performs a redirect to the Admitad Affiliate website in the background, the user doesn’t notice it. But this is when the link obtains special tags that allow target action data to be tracked.
In some cases, this data may be lost. For instance, when the browser/ad blocker/antivirus program blocks a redirect.

As a result, part of the redirects and target actions go under the radar, and the conversion rate declines.

 

When you enable Admitad Teleport, the user lands straight on the advertiser’s website—with no redirect to the affiliate network’s website. Concurrently, target actions are fully recorded. In the aftermath, you don’t lose the income that ad blockers may take away from you when Admitad Teleport is disabled.
 

Admitad Teleport helps boost conversions amidst GDPR, ePrivacy, and other personal data protection regulations

 

With GDPR and ePrivacy rules—and their analogs in other regions—having become law, the user has to give their consent to having their personal data processed on every website along the redirect journey, i.e., both on your website and the Admitad Affiliate website.

This may lead to a situation where users don’t agree to disclose any data.

 

 

And since Admitad Teleport excludes any redirects to the affiliate network’s website, the user will only have to accept the processing of personal data on your website.

This will hugely contribute to your conversions when the age of strict privacy comes.
 

 

How to use the tool

To date, there are two options for setting up and using Admitad Teleport:

Using Teleport Script

Subsection contents:

Who can (or should) use Teleport Script?

Setup via script will work for you if:

  • Your ad space is a blog, forum, news or data portal, coupon service, affiliate store, or loyalty program.
  • Affiliate links are contained in the page code, i.e., the website does not employ internal redirects to affiliate links.
  • You don’t have a backend developer, or Teleport API cannot be integrated.
     

How Teleport Script works

The mechanism behind the script is depicted in the diagram below. A description of all the steps is provided below the diagram.

2_teleport-EN.png


1. After installation, the script will look for all affiliate links to advertiser’s websites in your ad space and prepare them for the at-click substitution.

2. When a user clicks on the link, a background request is sent to Admitad Affiliate special domains, whereby:

  • SubID and other additional parameters are passed (if they are specified in the link).
  • admitad_uid is created to further track target actions.

3. The script converts affiliate links into ultimate links to the advertiser’s website.

4. The script immediately redirects the user to the advertiser’s website (without any redirects to ad.admitad.com that the browser may detect).

5. The advertiser accepts a user on their website or the internal platform to track target actions. With that, they save the parameter values from the link and use them to monitor target actions.
 

How to install Teleport Script

1. Go to the tool page (Tools → Teleport) and click Set up in the Via Script section.

2. Select an ad space where you are going to deploy the script.

3. Click Generate script.

4. Copy the script and install it on your website before the closing tag </body>.

If you need to install the script on several websites, generate a code for each of them. Scripts for different ad spaces operate independently.

Admitad Affiliate doesn’t store the codes of scripts you generate.
If you can’t find a previously created script, go through the process again. The code for the selected ad space will be the same as at the first generation.

How to prevent certain affiliate links from converting when using Teleport Script
 

How to test a script

When first installing the script, deploy it on the page without traffic so you can make sure that links work correctly.

Place a test order to make sure target action tracking is working correctly. The action must appear in your reports.

In some programs, actions take up to 24 hours to appear in statistics.


Restrictions and possible errors

  1. The script won’t convert inactive affiliate links.
  2. Some programs’ affiliate links are temporarily unsupported by the script.
  3. The script won’t process links loaded asynchronously after loading the home page.
     

1. The script won’t convert inactive affiliate links

If:

  • You or the advertiser decided to terminate cooperation and disconnected the ad space from the affiliate program
  • The program was suspended
  • The affiliate link contains an error,

the script will redirect the user to the dummy.

Track such errors in the Broken links section. Correct the affiliate links or redirect traffic to the programs to which your ad space is connected.
 

2. Some programs’ affiliate links are temporarily unsupported by the script

 

The list of such programs is constantly changing. We’re trying to make Teleport available for all integrations, so the program may appear in and disappear from the list of programs with limited support.

How do I know that my program is temporarily unsupported by Teleport?

 

You’ll still be able to publish affiliate links to such programs in your ad space. Traffic will go through classic redirects, and actions will still be tracked.
 

3. The script won’t process links loaded asynchronously after loading the home page

If your ad space employs asynchronous content loading, the script won’t process the new links that appear after the home page is loaded.

To use such links with Teleport, you can call the ADMITAD.pubtag.runAllPlugins() function after loading the content.
 

Using Teleport API

Subsection contents:

Who can (or should) use Teleport API?

Setup via API will work for you if:

  • Your ad space is a cashback service, browser, browser extension, dropshipping store, affiliate store, coupon service, or loyalty program.
  • You lead users to an internal page from which they are redirected to the advertiser’s website.
  • You have experience using Admitad API, or there is a technical specialist on the team.
     

How Teleport API works

The diagram below visualizes the logic behind the Teleport API operation. A description of all the steps is provided below the diagram.

1_teleport-EN.png


1. A user clicks on the product link that leads to the redirect page on your website. This is the moment when you send a server request to Admitad Affiliate according to the guide below.

2. Admitad Affiliate registers the click and returns a JSON array with a link to the product page on the advertiser’s website. The link will contain all the necessary parameters for tracking target actions.

3. Extract the link from the array and route the user to it. They’ll be redirected to the advertiser’s website (and they’ll notice it).
 

How to set up Teleport API

1. Decide on the Admitad Affiliate affiliate links you want to transform.

Apart from ad.admitad.com, all Admitad Affiliate’s tracking domains are supported, except for link shorteners (e.g., fas.st or ali.ski).

Example of a link: https://ad.admitad.com/g/1e8d114494b7e165239416525dc3e8/

2. Replace the link part /g/ with /tptv2/.

For example, we’ll transform the above link: https://ad.admitad.com/tptv2/1e8d114494b7e165239416525dc3e8/

3. Add the following parameters to the link:

Parameter name Parameter description
user_agent
(url-encoded)
required

It helps Admitad Affiliate filter out bot traffic from your ad spaces (e.g., from search engine crawlers) and not display it in your reports.

referer
(url-encoded)
required

It assists in troubleshooting action tracking and resolving disputes with the advertiser.

ip_addr
(url-encoded)
required

It’s needed to ensure that:

  • Rewards for programs where the rate depends on the user country are accrued to your account correctly.
  • You can work with the programs where the advertiser’s website’s final URL depends on the user country.
  • It’s easier to troubleshoot action tracking and help resolve disputes with the advertiser.

Since a request via Teleport API will come from your server, our system won’t be able to detect the user country.

 

Important: You have to pass the IPs of visitors who clicked on the link leading to the advertiser’s website. Don’t pass your server’s IP as the parameter value.

What to do if you can’t detect a user’s IP or pass ip_addr

country_code
(two letters per ISO standard 3166-1 alpha-2)
optional
This parameter may be required by programs that only allow traffic from one or several certain countries.
You can detect a user’s country with services like MaxMind.
subid
(string, up to 50 characters long, combination "%00" is not allowed)
optional
Pass this parameter if you want to analyze the performance of a certain link or ad. You can pass up to five different SubIDs. Learn more about SubID


 

 

Example of a link with all parameters:

https://ad.admitad.com/tptv2/1e8d114494b7e165239416525dc3e8/?country_code=RU&ip_addr=0.0.0.0&user_agent=Chrome&referer=https%3A%2F%2Fwww.google.com&subid=1&subid1=2&subid2=3&subid3=4&subid4=5 

 

5. Instead of redirect, forward the GET request from your server to the Admitad Affiliate server.

Teleport API only allows requests from your server; browser requests won’t pass moderation. Make a request with every user click. You can’t store requests in the cache.

6. Admitad Affiliate will return a JSON array with the link to the advertiser’s website.

[
"redirect_url"
]

 

Example of a redirect_url link:

https://www.advertiser.com?admitad_uid=b8b3fba19a9d6788408610c627f5045e&utm_source=admitad&utm_medium=affiliate

 

7. Extract the link from the array and route the user to it.
 

How to test Teleport API

Place a test order to make sure target action tracking is working correctly. The action must appear in your reports.

In some programs, actions take up to 24 hours to appear in statistics.


Restrictions and possible errors

  1. If you pass a broken affiliate link in the request, the response will contain a dummy URL.
  2. If you try to send a request to the affiliate program without passing ip_addr, the response will be a 404 error, and the following message: {"error": "ip_addr is mandatory"}.
  3. Affiliate links of some programs are temporarily unsupported by Teleport API.
     

1. If you pass a broken affiliate link in the request, the response will contain a dummy URL

If:

  • You or the advertiser decided to terminate cooperation and disconnected the ad space from the affiliate program
  • The program was suspended
  • The affiliate link contains an error, 

the response will contain a dummy URL.

You’d better still redirect the user to the dummy page but track such redirects in the Broken links section. If necessary, correct the affiliate link or redirect traffic to the programs to which your ad space is connected.
 

2. If you try to send a request to the affiliate program without passing ip_addr, the response will be a 404 error, and the following message: {"error": "ip_addr is mandatory"}.

If you see this error, add ip_addr to the request and try again.

The parameter ip_addr is required since you have to ensure the legitimacy of receiving and passing a user’s IP to Admitad Affiliate per Clause 9.6 of the Terms for Publishers.

If you can’t pass ip_addr in the request, use a series of redirects to the standard address (change /tptv2 back to /g/).

Teleport API will accept such links, and the traffic will pass through classic redirects.

You can also conclude a Data Processing Agreement with Admitad Affiliate. This agreement regulates the specifics of processing users’ personal data and can guarantee the legitimacy of using Teleport API. To do so, create a ticket or contact your personal manager.
 

3. Affiliate links of some programs are temporarily unsupported by Teleport API

Some programs in the catalog are temporarily incompatible with Teleport API. The list of such programs is constantly changing.

We’re trying to make Teleport API available for all integrations, so the program may appear in and disappear from the list of programs with limited support. How do I know that a program is temporarily incompatible with Admitad Teleport?

After sending a request for such programs, you will get a reply error 403 with the following message:

{"error": "teleport API response is currently not being supported for affiliate program id {campaign_id}"}

Where {campaign_id} is the affiliate program’s ID.

If the error occurs, log it and lead the user through a regular affiliate link (change /tptv2/ back to /g/). Traffic for such programs will go through classic redirects, and actions will be tracked.

User consent to passing online identifiers

If your website visitors are subject to GDRP/ePrivacy, Clause 9.6 of the Admitad Affiliate Terms for Publishers prescribes that you must obtain their consent to passing online identifiers from the users when using Admitad Teleport.

You can also conclude a Data Processing Agreement with Admitad Affiliate. This agreement regulates the specifics of processing users’ personal data and can guarantee the legitimacy of using Teleport API. To do so, create a ticket or contact your personal manager.
 

Admitad Teleport FAQ

How do I find out if Teleport doesn’t support my program?

1. Copy the program’s affiliate link and replace /g/ with /tptv2/. How to get an affiliate link

 

2. Follow the link with /tptv2/ in your browser to see what loads.

If the program is temporarily unsupported, you’ll see the following error message:

 

{"error": "teleport API response is currently not being supported for affiliate program id {campaign_id}"}

Instead of {campaign_id}, you’ll see the affiliate program ID.
 

Why do I see redirects for some programs even when using Teleport?

In some programs, users can be redirected to their internal action tracking platform rather than to the advertiser’s website, after which another redirect will happen. In the future, we plan to set up tracking so that the user will be redirected straight to the ultimate advertiser address in any case.
 

Will an extra request to Admitad Affiliate affect my ad space’s performance and page loading speed on the user’s end?

An extra request takes dozens of milliseconds, so Teleport’s operation doesn’t differ much from the regular handling of affiliate links. Our server is ready to bear a load similar to the one it experiences during clicks without using the tool.
 

What if a user follows a link again (after saving it to Bookmarks or from browser history)?

If the user follows a Teleport link saved in their browser to get to the advertiser’s website:

  • The repeating click won’t be counted.
  • Target actions will be attributed to you during the Postclick Cookie lifetime (you can find it on the program page).
  • The Postclick Cookie lifetime will be calculated from the time of the original click.
     

Can there be any antispam issues with the AliExpress affiliate program?

No, there won’t be any issues of this kind.
 

Does using Teleport affect cookie lifetime?

No. The period during which the user remains "associated" with the program after the original click on your link will be the same.
 

What do I do to prevent certain affiliate links from converting into affiliate links when using Teleport Script?

Add the pubtag="0" attribute to the link in your website code. Once you do this, the script will ignore such a link.

Example: <a href="https://advertiser.com/" pubtag="0">A link that shouldn’t be converted</a>

Questo articolo ti è stato utile?