Documentation sections

Stream actions and redirect methods

What a stream does with the visitor: nine actions, five redirect methods and two modes of the landing page → offer funnel.

The action defines what the visitor gets when the click lands in a stream. It is chosen in the Stream settings («Настройки потока») window on the General («Основное») tab, in the Action («Действие») field. The window opens with the + Stream («+ Поток») button or the gear button in the stream card — see Managing streams. A new stream has the Landing → offer funnel («Воронка ленд→оффер») action selected.

List of actions

ActionWhat the visitor getsWhat to fill in
Offer («Оффер»)An offer from the stream's rotationOffers on the Rotation («Ротация») tab
Landing page («Лендинг»)A landing page from the stream's rotationLanding pages on the Rotation tab
Landing → offer funnelA landing page, then an offer after the click-throughLanding pages and offers on the Rotation tab, the When to choose the offer («Когда выбрать оффер») field
Direct URL («Прямой URL»)A redirect to the given addressDestination URL («URL назначения») and Redirect method («Способ редиректа»)
HTMLA page with your HTML codeThe HTML · supports macros («HTML · поддерживает макросы») field
Show text («Показать текст»)A page with your textThe Text · supports macros («Текст · поддерживает макросы») field
Send to campaign («Передать в кампанию»)A redirect to the link of another tracker campaignTarget campaign alias («Alias целевой кампании»)
404 stub («Заглушка 404»)A 404 response with no contentNothing
Nothing (empty response) («Ничего (пустой ответ)»)An empty 204 or 200 responseResponse code («Код ответа»)

General rules:

  • The click is recorded in statistics with any action, including 404 stub and Nothing (empty response).
  • The Rotation tab works only for the Offer, Landing page and Landing → offer funnel actions. For the others, it says: “The selected action does not use landing page/offer rotation. Set the destination on the ‘General’ tab.” («Выбранное действие не использует ротацию лендингов/офферов. Настройте назначение во вкладке «Основное».»)
  • When the stream is saved, the items the selected action does not use are removed from the rotation: landing pages for the Offer action, offers for the Landing page action, and everything for the other actions except the funnel.
  • A new action starts working after you click Save stream («Сохранить поток») — see When changes take effect.

Offer and Landing page

The tracker picks one item from the rotation: by weight or by another selection mode. How to set shares is described on the Rotation and split tests page.

  • A hosted offer or landing page opens right at the campaign link: the address in the browser does not change. Hosted pages are covered in the Hosted pages section.
  • An external landing page opens with an HTTP 302 redirect.
  • An external offer opens by the method set in the Delivery type («Тип доставки») field of the offer settings.
  • Macros are substituted into the URL of an external offer and landing page.
  • Offers with the paused («пауза») and archived («архив») status aren't used in the choice — see Offer status.
  • If an offer has reached its daily sales cap, the visitor gets a replacement — see Replacement order.
  • The Landing page action has no click-through to an offer: the {offer} link on the landing page will respond 404, and an external landing page will not get the to parameter. To go from a landing page to an offer, choose Landing → offer funnel.

Landing → offer funnel

The visitor first sees a landing page, then follows the click-through link on it to an offer. The stream's rotation needs both a landing page and an offer.

The tracker creates the click-through link of the form /clk?_t=… itself for each click:

  • The tracker adds the to parameter with the full click-through link to the URL of an external landing page: https://track.example.com/clk?_t=….
  • In a hosted landing page, the {offer} macro inserts the link: href="{offer}".

The first click-through is recorded as a landing page click in the LP clicks («LP клики») column. Repeat click-throughs of the same click do not increase it. The click-through link is valid for 24 hours after the landing page is shown. Code examples and checks are on the From landing page to offer and multi-offer page.

When to choose the offer

The field exists only for the funnel.

OptionHow it works
Before the landing page is shown · shares fixed on entry («До показа лендинга · доли фиксируются на входе»)The offer is chosen on entry, together with the landing page, by weight or by another selection mode. The landing page has {offer_id} and {offer_name} of this offer. This is the default
After a click on the landing page · the choice is fixed before the redirect («После клика на лендинге · выбор фиксируется перед переходом»)The offer is chosen at the moment of the click-through, by weight or by another selection mode. On the landing page, {offer_id} and {offer_name} are empty

In both options, the first click-through from the landing page pins the offer to the click: the postback and reports are counted by it. Repeat click-throughs of the same click lead to the same offer.

Link to a specific offer

The {offer:ID} macro in a hosted landing page leads to the given offer from the stream's rotation. It works with both options of the When to choose the offer field.

  • ID is the full offer identifier, not a number like #12. To copy it, click the number in the ID column of the Offers («Офферы») section.
  • If there is no offer with this ID in the stream's rotation, or it is paused or archived, the click-through responds 404.
  • An offer with share 0 is not chosen by weight, but it opens via its own {offer:ID} link — see Share 0.

How to build a landing page with several offers and pass the ID from an external landing page is described in the Multi-offer section.

Direct URL and redirect methods

The visitor goes to the address from the Destination URL field. Macros work in the address, for example https://offer.example.com/?cid={click_id}. Fill in the address: a stream with an empty field is not saved — the panel opens the General tab and shows the message “Enter an address for the ‘Direct URL’ action or choose the ‘404 stub’ action” («Укажите адрес для действия «Прямой URL» или выберите действие «Заглушка 404»»). A stream that was saved earlier with an empty address responds 404.

The Redirect method field exists only for the Direct URL action.

MethodHow it is done
HTTP 302A redirect by a server response. This is the default
Meta refreshAn empty page with an instant redirect via the refresh meta tag
JS (location.replace)An empty page; the redirect is done by a script. The tracker page does not stay in the browser history
Direct (no-referrer) («Прямой (no-referrer)»)An empty page with a redirect via the refresh meta tag and a ban on passing the referrer
Double meta (referrer = tracker) («Double meta (реферер = трекер)»)Two redirects in a row via the refresh meta tag, the second from a tracker service page. The recipient sees the tracker domain as the referrer

The same five methods exist in the offer's Delivery type field — see Delivery types. The method chosen in the stream does not apply to offers.

Automatic domain substitution note under the URL field

When the tracker itself has replaced the domain in Destination URL according to the blocklist registry, a line appears under the field: “Domain … is in the blocked registry … and was replaced automatically. Rollback — in Settings, replacement log.” («Домен … попал в реестр заблокированных … и заменён автоматически. Откат — в Настройках, журнал замен.») The substitution conditions and the rollback are described on the registry page.

HTML and Show text

HTML returns the code from the HTML · supports macros field as a page with a 200 response. An empty field gives a 404 response.

Show text returns the contents of the Text · supports macros field as a plain page. Tags in this field do not work and are shown as text. Line breaks are not preserved on the page.

In both fields, macro values are substituted URL-encoded, as in links: for example, a space becomes +. To get a value without encoding, put an underscore before the name: {_campaign_name}. See the Encoding and escaping section for details.

Send to campaign

The visitor gets an HTTP 302 redirect to the link of another campaign on the same domain: https://track.example.com/<alias>.

  1. Choose the Send to campaign action.
  2. In the Target campaign alias field, enter the alias of the campaign the traffic goes to, for example abc1234. The alias is shown on the campaign page in the Traffic link block.
  3. Click Save stream.

The parameters of the source link are passed to the target campaign. The stream in it is chosen anew by its own rules. The click is recorded in both campaigns: the source and the target.

An empty alias field gives a 404 response. The visitor gets the same response if there is no campaign with this alias or it is not in the “active” («активна») status.

404 stub and Nothing (empty response)

  • 404 stub — the visitor gets a 404 response with no content. The action has no extra fields.
  • Nothing (empty response) — the visitor gets an empty response. The code is chosen in the Response code field: 204 · no content («204 · без содержимого») or 200 · empty page («200 · пустая страница»). 204 is the default.

In the stream card, the action is shown together with the code: “Nothing (204)” («Ничего (204)») or “Nothing (200)” («Ничего (200)»).

Error responses

If a stream is not fully configured, the visitor gets an error code instead of a page.

ResponseCauseWhat to do
404The Offer action has no available offer in rotation, the Landing page action has no landing pageCheck the Rotation tab, the offers' status and their daily sales cap
404The funnel has no landing page or no available offer in rotationAdd both kinds on the Rotation tab
404An empty Destination URL with any redirect method, including when the address is a macro with an empty value; an empty field in the HTML action, an empty Target campaign alias, or the alias of a campaign that does not exist or is not activeFill in the fields on the General tab
404An external landing page in the Landing page or Landing → offer funnel action has no address, an external offer in the Offer action has no address, a hosted offer or landing page has no main page — see Index fileCheck the settings and files of the landing page or offer
404 on the click-through from a landing pageThe stream's action is Landing page, not the funnel; the link was changed or is more than 24 hours old; the offer from {offer:ID} is not in rotation; all of the stream's offers have reached their daily cap; the offer has no address — such a click-through is not counted in LP clicksCheck the stream action, the link on the landing page, the ID in {offer:ID} and the offer address
503A temporary tracker failure on entry via the campaign link or on the click-through from a landing pageRepeat the visit in a few seconds. If the response repeats, open System status

A click that matched no stream also gets 404 — see Final stream and the 404 response.

The Campaign target diagnostics and monitoring («Диагностика и мониторинг целей кампании») block on the campaign page helps find offers and landing pages without an address or without uploaded files. It does not check the address from the Direct URL action.

Updated Need help? ↗