Streams

How streams work

In campaigns with “Without Rotation” settings, all streams are checked one by one. If clicks can’t get to a first stream because of filters, the click is sent to a next stream where filters are also checked. This happens until either the click is accepted to a stream, or it’s sent to a “Default” stream type. If the click is not accepted to any of the streams and there’s no “Default” stream in a campaign, a click is sent to a default action which is set up in a tracker Settings.

If “Split testing” is selected, first any of Forced streams is checked, then the next “Forced”. After Forced streams, “Regular” streams are randomly checked. “Default” stream is always the last one.

Also, when you use “Split testing”, there’s a “Bind visitors to streams” feature available.If this feature is enabled, te visitor will be redirected to the same stream as he had been visiting before.

Creating a stream

Main Tab

Stream Name

The name of the stream.

Stream type

  • Regular stream works according to the rotation rule, which is set at the campaign settings.
  • Forced. The special stream. It is intended for the interception of the specific traffic before it gets to the regular streams.
  • Default stream is used when none of the streams has worked. For example, user did not pass through the filters. It is recommended that you always create a default stream in order not to lose the remaining traffic.

Read more about the streams in our blog post.

Position/Weight

The position indicates in which order the suitable stream is selected. The weight is used to calculate the proportion (%) in the receiving traffic.

Proportions can be calculated in the following way. For example, we need 25%, 25% and 50%. In this case, 100 is the total weight of all streams. Then we set the weight for the streams 25, 25 and 50.

Collect clicks

Save statistics of this stream in a database.

Status

Enable/Disable the stream.

Schema Tab

Schema

  • Landing Pages & Offers — select if you want to work with landing pages and offers in this stream.
  • Direct URL — this schema redirects visitors to a definite link. Different redirect types can be used.
  • Action — select if you want to execute any type of an action in this stream.

In redirects and actions, you can use macros to dynamically insert some information. Read more on the page Macros.

Filters Tab

Filters are terms complying with which a visitor can get into the stream.

More about filters read on the page Filters and in our post in Keitaro's blog.

Monitoring Tab

Monitoring allows for running tasks. Tasks are run with cron, thus the minimal interval between tasks is one minute.

Read more about this feature on the page Monitoring.

How can the repeat visitor be redirected to the next stream?

Add to the streams a filter “Uniqueness” with mode “Allow” and value “for the stream”.

How to limit count of visitors to a stream

Use the “Limit” filter.

How to create multiple streams

1. Create a stream with needed filters.

2. Export to JSON (Additional -> Export);

Open the file. The code looks like this

[
  {"campaign_id": 1, "redirect_url": "http://site1.com", ...}
]

3. Copy the stream section and create any other streams:

[
  {"campaign_id": 1, "redirect_url": "http://site1.com", ...},
  {"campaign_id": 1, "redirect_url": "http://site2.com", ...},
  {"campaign_id": 1, "redirect_url": "http://site3.com", ...}
]

Notice the commas between sections.

4. Delete the existing stream from the campaign and upload a new list of streams (Additional > Import Streams).

If there are no streams after the import, then probably there is a mistake in the json format. Often it can be an extra comma after the last block.

How to change part of URL in several streams at once

  1. Use the search box or open page Streams of the campaign.
  2. Check the streams
  3. Press button “Replace”
  4. Enter text to replace and to what it must be replaced

How to update URL in stream from external page

How to move streams to another Keitaro

Choose “Others > Export”, download the campaign dump. Choose “Others > Import” on the other TDS. The second TDS should be no lower than the first one, otherwise incompatibility is possible.

How to send traffic to a specific stream

Stream rotation must be set to No rotation.

  1. Create a stream and add a filter by a parameter;
  2. At the filter set any parameter name, for example, stream and any value, for example, s1;
  3. Create other streams similarly.

Now you can add the parameter to the campaign link.

Only that stream will work, on which you set the parameter name and value correctly.

How to split traffic by keywords

  1. Make sure that you get keywords from the traffic source. You can see the keywords in the log of clicks.
  2. In each stream add the “Keyword” filter. Set the values according to your requirements. For example, in the first - *online game*, in the second - *free game*, in the third - *rpg*. Asterisks are needed because the search is not strict.

How to split traffic by country (video)

Create streams with the filter “Country”. Select the appropriate country for each stream. Watch video tutorial on our YouTube channel about splitting the traffic in a campaign based on the country of the visitor.

How to split traffic by cities

In the streams add the filter “Cities”. Enter the cities.

Splitting traffic to mobile and desktops

  1. Create streams for each type of device.
  2. Add the filter by a device to the streams and select the devices: in the first “Phone”, in the second “Desktop”.