What is a campaign?

Campaign is created for income traffic processing. Every campaign has its own unique URL to accept traffic and distributes this traffic through streams.

What is an identifier?

An identifier forms the campaign's external URL. For example, “123” identifier forms “” address.

What the difference between campaign types?

  • Basic — is used for working with traffic. The entire campaign functionality and streams are available;
  • Banners — are used for banner displaying instead of working with streams;
  • Tracking — this campaign only gathers information and conversions from landing pages the same way as a tracker;

How does a campaign work in the tracking mode?

Please read page Tracking code.

What is "Stream sort mode?"

The mode defines the order in which the streams are sorted.

  • Consecutive. From the first to the last position (from up to down, if you look at the table of streams);
  • Random (split-testing). The stream is chosen randomly dependent on the weight indicated.

How is cloaking for bots used?

Check the Cloaiking page.

What is a "Default Action"?

This action starts when the streams are not created or filters declined the user.

How can traffic be sent to campaign?

You can see the address where traffic should be sent if you click the “Display link” button at the campaign page. To connect the campaign to advertising network and generationg code with redirects go to “Integration Assistant” page (“Other” menu).

How can the additional information about users be transmitted?

You can send the following information in parameters:

  • keyword — keyword (pseudonyms: keywords, tds-key, utm_term);
  • referrer — referrer for reports (pseudonym: referer);
  • se_referrer — search engine referrer. Transmit it if the keyword should be taken from it;(pseudonyms: seoref, se_referrer);
  • source — source (pseudonym utm_source);
  • se — search engine;
  • charset — keyword encoding (utf-8 by default);
  • cost — cost of click;
  • sub_id_1, sub_id_2, sub_id_3, sub_id_4 — channel identifiers, are saved in statistics;
  • extra_param_1, extra_param_2…, extra_param_7 — additional parameters, are saved in statistics;

Pseudonyms can be added or changed at “Settings > Other” page.

Reserved parameters: id, g, group, sid, subid.

How to get reports grouped by banner id, campaign id and other parameters?

You need to pass these values to Keitaro parameters (see the list above). Otherwise, they will be ignored and will not be shown at reports.

For convenience, it is recommended to adhere to these standards:

  • source — name of an advertising network (for example,;
  • sub_id_1 — website id or publisher id;
  • sub_id_2 — ID of an advertising campaign;
  • sub_id_3 — ID of banner, teaser;
  • sub_id_4 — unique click ID at advertising network. It is used in S2S postbacks to advertising network.

If you don't want to change the parameters names add aliases at the page “Maintenance > Settings > Misc”.

How can I move sub_id from an advertising network to a campaign and a partner page offer?

Use any of the following parameters: sub_id_1, sub_id_2, sub_id_3, sub_id_4.

To pass it to the partner page offer, insert a parameter name macro in the URL, i.e. {sub_id_1}, {sub_id_2}, {sub_id_3} or {sub_id_4}. For example,


How can the banners in the campaign be displayed?

Read at Banner rotation page.

Why banners open in frames on click?

Check that every URL is provided with the attribute target=“_parent” (<a href=“…” target=“_parent”><img…></a>)

How can I connect a campaign to an advertising network?

How can I connect Keitaro to a doorway?

Read at Connection to doorways page.

How can I get the stream result from API?

Go to “Integration Assistant” page, choose “API” from the list. You will get an example of work with API. Also check instruction on working with API

How is conversion collected?

Read at Postback connection and Conversions pages.

How to connect a postback?

Go to campaign page and press Postback button. Find your partner page on the list or choose “Default”, then follow the instructions and connect the Postback URL to your partner page.

How can the campaign costs be displayed?

There are several ways:

1. Display costs for the last period. Choose “Additional > Update Costs”. Indicate the sum of costs and the time interval when they were spent.

2. At the campaign settings set the visit cost.

3. Pass through the parameter cost, you can set a currency by currency. Fox example,

How are the costs calculated?

The costs sum is divided equally to the full amount of visitors. For example, if the cost is equal to 500 roubles, and 1000 visitors, the costs are equal to 0.5 roubles per visitor.

How to create A/B-campaign?

In campaign settings choose “Random” stream sorting mode. Create several streams with a certain weight. The bigger the weight, the larger part of traffic will get to this stream.

How to bind visitors to streams?

Enable the option “Bind visitors to streams” (available only with a random selection mode).

How split-testing works?

  1. The algorithm choose a random stream depending the weight.
  2. Filters of the stream will be checked. If the filters does not block a user then the user will perform a stream action.
  3. If the stream block the user by filters then the random selection mode will be run again.
  4. If all streams block the user by filters then the user will perform a default action.

Why the number of visitors changes nonuniformly at random stream choice?

There are two reasons:

  1. It happens because of filters in the streams. A randomly chosen stream might not take the user because of the filters set to it. That is why the user goes to another stream.
  2. The random number generator is used at the moment when a stream is selected. It gives some error (+- 10%) when the number of visitors is small (up to 1000)

How can the users who got under default action, be excluded from visitors statistics?

In campaign settings choose “Do not follow the default action performance”.

How can the campaign statistics be cleared up?

Choose “Clear statistics” in “Other” menu on the campaign page.

How to test filters?

Choose “Traffic simulation” in the “Other” menu.

How can I restore a deleted campaign?

Go to “Service > Archive” settings. There you can restore the previously deleted campaign. Campaigns are stored in the archive for 3 months, streams for 4 months.

Where go visitors who come to deleted or disabled campaigns?

To them triggers “Action for domain” that configurable in page settings.

How to import scheme file Sutra TDS to Keitaro?

At the page “Import” choose “Sutra TDS”

How to hide the source of the traffic from the affiliate program?

Use the action “JS-redirect”. Other methods are described at the page how_can_i_replace_or_hide_a_referrer.

What are the best to use for checking uniqueness?

If you have mostly desktop traffic use “Cookie”. If you have a big amount of Android traffic use “Cookie + IP”.

The methods of checking by “Cookie + IP” and “IP” send a request to MySQL (or Redis) and it has a negative impact on performance.