Разделы документации

Ротация по непосещённым и по порядку

Как выдавать вернувшемуся посетителю лендинги и офферы, которых он ещё не получал, или показывать их по очереди в заданном порядке.

По умолчанию поток выбирает лендинг и оффер случайно, по долям. В режиме Непосещённые по долям вернувшийся посетитель получает лендинг или оффер, который ему ещё не выдавался, в режиме Последовательно — следующий по заданному порядку. Режим задаётся в окне Настройки потока на вкладке Ротация и работает в потоках с действием Оффер, Лендинг или Воронка ленд→оффер. Менять его могут те, кто может менять кампанию.

Режимы выбора

Режим один на поток: он действует и на лендинги, и на офферы. Элемент здесь — лендинг или оффер из ротации потока.

РежимНовый посетительВернувшийся посетитель
По долямСлучайный элемент пропорционально долямТак же: выбор каждый раз случайный, история не ведётся
Непосещённые по долямСлучайный элемент пропорционально долямСлучайный элемент пропорционально долям среди тех, которые ему ещё не выдавались. Когда выданы все, начинается новый круг: выбор снова идёт среди всех
ПоследовательноПервый элемент по порядкуЭлемент, следующий за выданным в прошлый раз. После последнего — снова первый

По долям стоит по умолчанию и описан на странице Ротация и сплит-тесты лендингов и офферов.

  • История лендингов и история офферов ведутся отдельно. В воронке лендинг и оффер выбираются независимо друг от друга.
  • В режиме Непосещённые по долям первым в новом круге может оказаться элемент, выданный последним в прошлом круге.
  • В режиме Последовательно каждый новый посетитель начинает с первого элемента. Посетитель, который пришёл один раз, получает только его.

Пример: воронка в режиме Последовательно, два лендинга и три оффера, оффер выбирается до показа лендинга.

Визит посетителяЛендингОффер
ПервыйПервыйПервый
ВторойВторойВторой
ТретийПервыйТретий
ЧетвёртыйВторойПервый

Включите режим

  1. Откройте кампанию в разделе Кампании.
  2. В карточке потока нажмите кнопку с шестерёнкой — откроется окно Настройки потока.
  3. Перейдите на вкладку Ротация.
  4. В поле Режим выбора выберите Непосещённые по долям или Последовательно. Рядом появится поле Запоминать посетителя, часов.
  5. Укажите, сколько часов хранить историю посетителя.
  6. В режиме Последовательно расставьте строки элементов кнопкой ↑.
  7. Нажмите Сохранить поток.

В этих двух режимах под полями показана подсказка: «После полного обхода начинается новый круг. Посетитель определяется по IP и браузеру; привязка посетителя имеет приоритет. Порядок — сверху вниз отдельно для лендингов и офферов.»

ПолеЗначенияПо умолчанию
Режим выбораПо долям, Непосещённые по долям, ПоследовательноПо долям
Запоминать посетителя, часовЦелое число от 1 до 720. Поле показано, пока выбран режим Непосещённые по долям или Последовательно24
Кнопка ↑ в строке элементаПоказана в режиме Последовательно. Поднимает строку на одну позицию. В первой строке списка неактивна—

Строки элементов и доли добавляются так же, как при выборе по долям, — см. Добавьте элементы ротации. Чтобы вернуть выбор по долям, выберите По долям и сохраните поток. Сохранённые настройки начинают действовать на трафик в течение примерно 15 секунд.

Порядок в режиме «Последовательно»

  • Порядок задаёт положение строк на вкладке Ротация, сверху вниз. Он считается отдельно среди лендингов и отдельно среди офферов: строка лендинга между строками офферов порядок офферов не меняет.
  • Строка, добавленная кнопкой + Элемент, встаёт последней.
  • При следующем открытии окна сначала идут лендинги, затем офферы — каждый вид в сохранённом порядке.
  • В карточке потока режим и порядок не показаны: блок Ротация · A/B выводит элементы и их доли. Режим виден на вкладке Ротация.

Как трекер узнаёт посетителя

Посетитель определяется по IP-адресу и User-Agent. Вариант в поле Уникальность кампании на это не влияет — в отличие от привязки посетителя.

  • История своя у каждого потока. Посетитель, который попал в другой поток той же кампании, начинает в нём с нуля.
  • Два человека с одним IP-адресом и одинаковым User-Agent для трекера — один посетитель.
  • Если у посетителя сменился IP-адрес или User-Agent, трекер считает его новым.
Совет.

Если в кампании несколько обычных потоков, вернувшийся посетитель может попасть в другой поток. Чтобы он возвращался в тот же, включите в кампании привязку посетителя со значением Поток в поле Запоминать.

Срок памяти

Поле Запоминать посетителя, часов задаёт, сколько часов хранится история посетителя. Наибольшее значение 720 — это 30 суток. Следующие визиты срок не продлевают.

  • Непосещённые по долям: срок отсчитывается от первого выбора в круге. Когда посетитель получил все элементы, начинается новый круг и новый срок. Если срок истёк раньше, все элементы снова считаются невыданными.
  • Последовательно: срок отсчитывается от первого выбора, новый круг его не обновляет. Когда срок истёк, очередь начинается с первого элемента, даже если круг не пройден.

Что считается выданным

В историю попадает элемент, который трекер выбрал для посетителя. Открылась ли страница, трекер не проверяет.

В историю записывается только выбор по режиму. Резервный оффер и оффер, выбранный по долям взамен недоступного, в неё не попадают.

Что выбираетсяКогда попадает в историю
ЛендингПри входе по ссылке кампании
Оффер в потоке с действием ОфферПри входе по ссылке кампании
Оффер в воронке, в поле Когда выбрать оффер — До показа лендинга · доли фиксируются на входеПри входе по ссылке кампании. Оффер считается выданным, даже если посетитель не перешёл с лендинга
Оффер в воронке, в поле Когда выбрать оффер — После клика на лендинге · выбор фиксируется перед переходомПри первом переходе с лендинга по ссылке без идентификатора оффера
  • Каждый вход по ссылке кампании — новый клик и новый выбор, в том числе повторное открытие той же ссылки.
  • Возврат посетителя после JS-челленджа новым выбором не считается: он получает те же лендинг и оффер.
  • Повторные переходы с лендинга в пределах одного клика ведут на тот же оффер — см. Закрепление оффера и срок ссылки.
Совет.

Чтобы в историю попадали только офферы, на которые посетитель перешёл с лендинга, выберите в поле Когда выбрать оффер значение После клика на лендинге · выбор фиксируется перед переходом.

Доли и доля 0

Доли элементов одного видаНепосещённые по долямПоследовательно
Больше 0Шанс элемента среди ещё не выданных пропорционален его долеНа порядок и частоту доля не влияет: за круг каждый элемент выдаётся один раз
0, а у других элементов больше 0Элемент не выбираетсяЭлемент в очереди пропускается
0 у всех элементовУчаствуют все, шансы равныеУчаствуют все, по порядку

Оффер с долей 0 по-прежнему открывается по ссылке {offer:ID}. Когда он получает клики как резервный, описано в следующем разделе.

Офферы на паузе и с лимитами

  • Оффер, у которого в поле Статус стоит не «активен», в выборе не участвует. То же относится к офферу и лендингу в корзине.
  • Оффер с набранным лимитом продаж в день в выборе не участвует, пока лимит набран. Выбор идёт по режиму среди остальных офферов с долей больше 0. Резервный оффер при таком выборе как замена не используется — в отличие от выбора по долям.
  • Если лимит продаж набран у всех офферов с долей больше 0, замена выбирается как при выборе по долям — см. Порядок замены. Когда замены нет, посетитель получает ответ 404.
  • Если оффер выбран до показа лендинга и его лимит продаж набрался, пока посетитель был на лендинге, замена при переходе тоже выбирается как при выборе по долям.
  • Лимит кликов оффера проверяется после выбора. Если лимит набран, клик идёт на резервный оффер этого оффера из того же потока. Без резервного оффера выбор повторяется по режиму среди остальных офферов потока — для них ведётся отдельная история. Оффер с набранным лимитом при этом уже записан в историю как выданный, поэтому без резервного оффера посетитель может получить один и тот же оффер два визита подряд.

Когда оффер выбывает из выбора или возвращается в него, для получившегося набора офферов ведётся отдельная история — см. Когда история начинается заново.

Когда история начинается заново

История относится к набору, из которого идёт выбор: режим, срок памяти, участвующие элементы одного вида, их доли и порядок. Когда набор меняется, для него ведётся отдельная история, и посетитель может снова получить элемент, который уже получал.

Набор меняется, когда:

  • изменено поле Режим выбора или Запоминать посетителя, часов;
  • в поток добавлен или из потока удалён элемент этого вида. Исключение — элемент с долей 0, пока у других элементов доля больше 0: он в выборе не участвует, и набор остаётся прежним;
  • у элемента изменена доля, в том числе на 0 или с 0;
  • изменён порядок строк этого вида;
  • оффер поставлен на паузу или снова получил статус «активен»;
  • оффер или лендинг отправлен в корзину либо лендинг восстановлен из неё;
  • у оффера набран или снова свободен лимит продаж в день;
  • у оффера набран лимит кликов, а резервного оффера в потоке нет: для выбора среди остальных офферов ведётся отдельная история.

Прежняя история хранится до конца своего срока. Если набор снова становится прежним, она опять применяется.

Пока набор прежний, история начинается заново в двух случаях: истёк срок памяти или в режиме Непосещённые по долям посетитель получил все элементы.

Привязка, ссылка на оффер и лимиты

Что действуетКак сочетается с режимом
Привязка посетителя, в поле Запоминать — ПотокЗакреплён только поток. Лендинг и оффер выбираются по режиму
Привязка, в поле Запоминать — Поток и лендингВернувшийся посетитель получает закреплённый лендинг. Оффер выбирается по режиму
Привязка, в поле Запоминать — Вся связкаВернувшийся посетитель получает закреплённые лендинг и оффер. Режим применяется к нему, только когда закреплённый оффер приходится заменить, — см. список под таблицей
Ссылка {offer:ID} на лендингеПосетитель переходит на указанный оффер — см. Мультиоффер. Режим не применяется
Лимит продаж в деньОфферы с набранным лимитом исключаются до выбора по режиму
Лимит кликов оффераПроверяется после выбора по режиму
  • Первый визит посетителя проходит выбор по режиму. Привязка закрепляет то, что он получил.
  • Закреплённый элемент и оффер из ссылки {offer:ID} в историю не записываются.
  • Если закреплённого лендинга уже нет в ротации, замена выбирается по долям, а не по режиму. Так же заменяется закреплённый оффер, который выбирается при входе: в потоке с действием Оффер и в воронке с вариантом До показа лендинга · доли фиксируются на входе.
  • В воронке с вариантом После клика на лендинге · выбор фиксируется перед переходом замена закреплённому офферу, которого уже нет в ротации, выбирается при переходе по режиму и записывается в историю.
  • Закреплённый оффер с набранным лимитом кликов заменяется его резервным оффером из этого потока, а без резервного — оффером, выбранным по режиму среди остальных.
  • Срок привязки и срок памяти задаются отдельно: первый — в кампании, второй — в потоке.
  • Как учитываются повторные входы по ссылке кампании, возврат после JS-челленджа и повторные переходы с лендинга — в разделе Что считается выданным.

Копии, шаблоны и общие воронки

Режим, срок памяти и порядок элементов переносятся вместе с потоком.

ДействиеЧто происходит с настройками
Кнопка Копия в карточке потокаКопия потока получает те же режим, срок и порядок
Кнопка Копировать в списке кампанийПотоки копии кампании получают те же режим, срок и порядок
Шаблон потока и файл JSONРежим, срок и порядок сохраняются в шаблоне и в файле. В черновике из шаблона вкладка Ротация уже заполнена ими
Версия общей воронкиРежим, срок и порядок сохраняются в версии вместе с лендингами, офферами и долями. При применении версии они заменяют настройки потока
  • История посетителей не переносится: у копии потока и у потока из шаблона она начинается с нуля.
  • В сравнении «Сейчас» и «После применения версии …» перед применением версии общей воронки режим не показан. После применения проверьте вкладку Ротация потока.

Что показывает «Проверить поток»

Кнопка Проверить поток открывает окно «Проверка выбора потока». Оно показывает, какой поток получит посетитель с заданными параметрами. Какой лендинг или оффер будет выбран внутри потока, проверка не показывает — в любом режиме. Историю посетителя она не читает и не меняет.

Слово «ротация» в строке над таблицей результата, например «Кампания: active · ротация: weight.», относится к выбору между обычными потоками, а не к полю Режим выбора. Подробнее — на странице Проверка выбора потока.

Ограничения

  • Режим один на поток. Задать разные режимы лендингам и офферам одного потока нельзя.
  • Запоминать посетителя, часов — целое число от 1 до 720.
  • Поток, в котором больше 200 лендингов или больше 200 офферов, из окна Настройки потока не сохраняется — в любом режиме, включая По долям. В режимах Непосещённые по долям и Последовательно этот предел действует и при работе через API.
  • В режиме Непосещённые по долям доля больше 100000 учитывается как 100000.
  • История хранит выбор трекера, а не просмотр страницы, и ведётся по IP-адресу и User-Agent.
  • Пока трекер не может прочитать или записать историю, поток в режимах Непосещённые по долям и Последовательно отвечает посетителю 503. На выбор по долям он сам не переключается.

Настройка через API и в файле JSON

В объекте потока и в файле шаблона режим хранится в action_payload, в объекте target_rotation.

ПолеТипОписание
modeстрокаweighted — По долям, unvisited — Непосещённые по долям, sequential — Последовательно. По умолчанию weighted
hoursцелоеСрок памяти в часах, от 1 до 720. По умолчанию 24. Проверяется в любом режиме
offer_orderмассив строкИдентификаторы офферов потока в порядке обхода. До 200, без повторов
lander_orderмассив строкИдентификаторы лендингов потока в порядке обхода. До 200, без повторов
  • Элементы потока, которых нет в списке порядка, идут после перечисленных, по возрастанию идентификатора.
  • Другие ключи в target_rotation не принимаются.
  • При изменении потока action_payload заменяется целиком. Если передать его без target_rotation, поток возвращается к режиму По долям.

Ошибки приходят с кодом 422 и code = validation, причина — в message:

СообщениеПричина
«неизвестный режим ротации»В mode стоит не weighted, unvisited или sequential
«срок ротации: 1–720 часов»В hours число меньше 1 или больше 720
«не более 200 целей ротации»В offer_order или lander_order больше 200 идентификаторов
«повтор или неверная цель ротации»В списке порядка повтор, пустая строка или идентификатор длиннее 64 символов
«порядок ротации содержит цель вне потока»Режим не weighted, а в списке порядка есть оффер или лендинг, которого нет в offers или landers потока
«не более 200 целей smart rotation»Режим не weighted, а в потоке больше 200 офферов или больше 200 лендингов
Текст начинается с json:В target_rotation лишний ключ или значение не того типа, например дробное число в hours

Проверка

  1. Сохраните поток и подождите около 15 секунд.
  2. Откройте ссылку кампании несколько раз подряд в одном и том же браузере.
  3. В карточке потока нажмите на счётчик клики · уники — откроется статистика этого потока.
  4. Перейдите на вкладку Лог кликов. Клики идут от новых к старым.
  5. Найдите свои клики по колонке IP и сравните значения в колонке Оффер.
  6. Нажмите на строку клика: лендинг указан в строке Лендинг блока ID / Данные.

В режиме Непосещённые по долям лендинг и оффер не повторяются, пока не выданы все элементы вида и не изменился набор — см. Когда история начинается заново. В режиме Последовательно они идут в порядке строк вкладки Ротация.

Если оффер выбирается после клика на лендинге, колонка Оффер заполняется после перехода с лендинга. Если в кампании включена привязка со значением Поток и лендинг, при повторных визитах выдаётся закреплённый лендинг, а со значением Вся связка — закреплённые лендинг и оффер.

Если не получилось

Если после нажатия Сохранить поток окно не закрылось, поток не сохранён. Текст ошибки показан вверху страницы кампании, под окном.

«срок ротации: 1–720 часов»

Поле Запоминать посетителя, часов пустое либо в нём число меньше 1 или больше 720. Впишите целое число от 1 до 720 и сохраните поток. Значение проверяется и в режиме По долям, когда поле скрыто: выберите Непосещённые по долям, исправьте число и верните По долям.

Пока открыта вкладка Ротация, число меньше 1, больше 720 или дробное не даёт отправить форму: браузер показывает подсказку у поля.

Дробное число при открытой другой вкладке или в режиме По долям даёт другую ошибку: её текст начинается с json: cannot unmarshal number. Исправьте число так же.

«не более 200 целей ротации»

В потоке больше 200 лендингов или больше 200 офферов. Проверка действует в любом режиме. Удалите лишние строки на вкладке Ротация или распределите элементы по нескольким потокам.

Посетитель снова получил тот же лендинг или оффер

Возможные причины:

  • в режиме Непосещённые по долям начался новый круг: все элементы уже были выданы;
  • истёк срок из поля Запоминать посетителя, часов;
  • изменились режим, срок, набор элементов, их доли или порядок — см. Когда история начинается заново;
  • у посетителя сменился IP-адрес или User-Agent, либо он попал в другой поток кампании;
  • лендинг или оффер закреплён привязкой посетителя;
  • посетитель перешёл по ссылке {offer:ID};
  • у оффера набран лимит кликов, а резервного оффера в потоке нет: замена выбирается среди остальных офферов по отдельной истории.

Элемент не выдаётся

Возможные причины:

  • у элемента доля 0, а у других элементов того же вида доля больше 0;
  • у оффера в поле Статус стоит не «активен», набран лимит продаж в день или лимит кликов;
  • в режиме Последовательно посетители приходят по одному разу, и каждый получает первый элемент;
  • посетитель каждый раз получает лендинг или оффер, закреплённый привязкой.

Поток отвечает 503

Трекер не смог прочитать или записать историю посетителя либо счётчик лимита оффера. Клик записывается в статистику без лендинга и оффера и в другой поток не уходит. Исключение — поток, у которого заданы свои лимиты кликов: пока трекер не может прочитать и их счётчик, клик уходит в другой подходящий поток, а если такого нет, посетитель получает 503 и клик в статистику не записывается. Откройте Состояние системы и проверьте карточку redis. Ответы 503 при переходе с лендинга описаны на странице Переход с лендинга на оффер и мультиоффер.

Обновлено Нужна помощь? ↗