Documentation sections

Catalog of source and network templates

What the catalog contains, how to find the template you need in it, and what a template fills in when you create a traffic source or an affiliate network.

The catalog is a list of ready-made settings built into the tracker: 178 traffic sources and 333 affiliate networks. You choose a template in the Create source («Создать источник») window of the Sources («Источники») section and in the Create network («Создать сеть») window of the Networks («Сети») section. Sources and networks can be created by the owner and the admin.

Catalog contents

CatalogTemplatesWhere it is selectedSelected by default
Traffic sources178The Sources section, the + Add («+ Добавить») button, the Source template («Шаблон источника») fieldFacebook Ads
Affiliate networks333The Networks section, the + Network («+ Сеть») button, the Affiliate network template («Шаблон партнёрской сети») fieldCustom template («Свой шаблон»)

In the source list, Facebook Ads, Google Ads, TikTok Ads and Geozo come first, and the rest follow in alphabetical order. The network list is sorted alphabetically.

The catalog is updated only together with the tracker — see Updating the tracker from the panel. You cannot add your own template to it: for a service that is not in the list, choose Custom template and fill in the settings manually.

Choosing a template

The picker works the same way in both windows.

  1. Click the template field. The list opens, and the cursor moves to the search box.
  2. Type part of the name in the Search by name… («Найти по названию…») box. The number of matching templates is shown to its right.
  3. Click the row you need.

The list closes, and the template name appears in the field. The next time you open the list, the selected row is marked with a check mark.

Search rules:

  • the text is matched anywhere in the name, case-insensitive;
  • only the name is searched — a template is not found by its parameters or postback URL;
  • the Custom template item with the caption “Set up manually” («Настроить вручную») always comes first and is never hidden by the search;
  • if nothing matches, the row “Nothing found. Change the query or choose a custom template.” («Ничего не найдено. Измените запрос или выберите свой шаблон.») appears.

Keyboard controls:

KeyAction
Down or Up arrow on the closed fieldOpen the list
Down or Up arrow in the listMove to the next or previous row, wrapping around
Enter in the search boxSelect the highlighted row. After you type a query, the first matching template is highlighted. If nothing is found, Enter selects nothing
EscapeClose the list without changing the selection

Clicking outside the list or clicking the field again also closes the list without changes.

What a source template fills in

Below the picker there is a Template parameters and postback («Параметры и постбек шаблона») block. Expand it to view the template before you create the source: the link parameters, one per line in the form parameter=value, and the postback URL. For Google Ads, the block looks like this (the last line means “No postback set”):

text
gclid=
campaignid={campaignid}
creative={creative}
keyword={keyword}
Постбек не задан

On creation, the template fills in:

WhatHow it is filled in
Name («Название»)The template name — at the moment you select it, and only into an empty field. A filled-in field does not change, including when you choose another template
Source tokens («Токены источника»)All of the template's parameters: the Slot («Слот»), Name, Parameter («Параметр») and Placeholder columns. 70 templates have no parameters: such a source is created without tokens
S2S postback to source («S2S-постбэк в источник»)The One URL for all statuses («Один URL на все статусы») mode
URL for all conversion statuses («URL на все статусы конверсий»)The URL from the template. 134 templates have one, and in 49 of them it requires setup. If there is no URL or it requires setup, the field stays empty

For Facebook Ads, which is selected by default, the name is not filled in automatically: type it or pick the template in the list. While the Name field is empty, the Create source button is inactive.

The header of the created source's card shows a label with the template ID and version, for example facebook · v1. A source without a template has the label “custom source” («свой источник»). Tokens and the postback are changed in the card.

For creating a source step by step, see Traffic sources.

What a network template fills in

WhatHow it is filled in
NameThe template name. It replaces whatever was in the field. You can change the name after selecting the template
Postback parameters («Параметры постбэка»)The postback parameters with this network's macros. In every template the string starts with ?
Final postback URL («Итоговый URL постбэка»)The URL you paste into the affiliate network's account. It changes right after you select a template
Offer link parametersThe parameter in which the network receives the click ID, for example sub1={subid}. They are not shown in the create window
NoteA line below the picker. 128 templates have one

In 155 templates, the network's status lists are already set in the postback parameters: lead_status, sale_status and rejected_status — what counts as a lead, a sale and a rejection, and ignore_status — what not to record. For how the tracker reads them, see Incoming postback.

The offer link parameters are shown in the network table under the name: “In the offer link: sub1={subid}” («В ссылку оффера: sub1={subid}»). When such a network is selected in an offer, an Add the selected network's parameters («Добавить параметры выбранной сети») button appears under the link field. It appends to the link only the parameters that are not there yet.

Tip.

Editing the Postback parameters field after selecting a template switches the selection to Custom template. Such a network is created with your parameter string but without offer link parameters, and the button will not appear in the offer.

When you choose Custom template, the Name and Postback parameters fields are cleared. For creating a network step by step, see Affiliate networks.

Templates that require setup and REPLACE

REPLACE is a placeholder in place of a value that only you know. In source templates, it is your ID or key in the ad network; in affiliate network templates, it is most often the event status.

Sources

In 49 source templates, the postback requires setup. In the expanded Template parameters and postback block, they show a hint: “The postback requires your ID or key: it will not turn on automatically. After creating the source, insert the URL from the template and replace REPLACE.” («Постбек требует вашего ID или ключа: он не включится автоматически. После создания вставьте адрес из шаблона и замените REPLACE.»)

Such a source is created with an empty postback URL. To turn sending on:

  1. Open the source card.
  2. Click Insert postback from template · replace REPLACE and your parameters («Вставить постбек из шаблона · замените REPLACE и свои параметры») above the URL for all conversion statuses field.
  3. Enter your values in the field in place of REPLACE and the other account parameters.
  4. Click Save («Сохранить»).

In templates that do not require setup, the button is called Insert postback from template («Вставить постбек из шаблона») and fills the field with the URL from the template. Templates without a postback URL have no button.

Affiliate networks

In networks, the placeholders are in the postback parameters. The note under the picker says what to replace. A single note can contain several instructions in a row.

NoteWhat is in the parametersWhat to enter
“Replace REPLACE before connecting” («Замените REPLACE перед подключением»)REPLACE, most often status=REPLACEYour own value in place of the placeholder
“Specify the event status” («Укажите статус события»)status=REPLACE_STATUSThe event status or the network's status macro
“Specify the network's click ID macro” («Укажите макрос click ID сети»)subid=REPLACE_CLICK_IDThe network macro that returns the click ID

You can replace the placeholders in one of two places:

  • In the affiliate network's account. Create the network from the template, click copy («копировать») in its row and enter your values in the URL after pasting it. The network keeps its offer link parameters.
  • In the Postback parameters field of the Create network window. The selection then switches to Custom template, and the network is created without offer link parameters.

Template versions

Each template has a version. The template list is loaded when the page opens. On creation, the tracker checks that a template with that version exists in its catalog. If the template changed in the catalog after the page was opened, creation fails.

MessageWhere it appearsWhat to do
“Template changed or missing. Refresh the catalog.” («Шаблон изменился или отсутствует. Обновите каталог.»)At the top of the Sources page when you create a source. The create window stays openRefresh the page and choose the template again
“Network template not found or outdated” («Шаблон сети не найден или устарел»)On the Networks page above the table when you create a network. The create window stays openRefresh the page and choose the template again
“Template catalog unavailable” («Каталог шаблонов недоступен»)In the Create source window under the template field; on the Networks page above the tableThe template list did not load. Refresh the page. While the catalog is unavailable, the list contains only Custom template: with it, the record is created manually

A template is applied once — at the moment of creation. Sources and networks that have already been created do not change when the catalog is updated.

What a template does not do

  • A template is a set of parameters and URLs, not a connection to an account. It does not log in to the ad account and does not call the source's or network's API.
  • A template does not load spend from the ad account. For how the tracker calculates cost, see Campaign cost models; for Facebook there is the spend extension.
  • A source template does not change the parameters of campaigns that have already been created. For carrying tokens over to campaigns, see Applying a source to campaigns.
  • A network template does not change offer links. Parameters are added to an offer with the Add the selected network's parameters button.
Updated Need help? ↗