Цели

Цель — это тип конверсии с понятным ключом. Например, «Покупка» с ключом purchase, «Апсейл» с ключом upsell, «Регистрация» с ключом reg. Одна ПП может присылать несколько целей. Тогда каждая цель считается отдельно.

Откройте «Конверсии» (/dashboard/conversion-goals). Вверху вкладки «Цели» — общий URL постбэка. Каждая карточка цели содержит кнопку копирования URL с параметром goal=<ключ> этой цели. Вкладка «Руководство по интеграции» объясняет, как подключить трекер на сайте.

1. Общий URL постбэка: без параметра goal.
2. Ключ цели.
3. Кнопка копирования URL постбэка этой цели (с goal=<ключ>).

Создание цели

Поле	Что вписать
Название	До 100 символов, для вас
Ключ	От 3 до 50 символов: латиница в нижнем регистре, цифры, - и _. Именно он передаётся в постбеке.
Описание	Необязательно
Область действия	«Глобальная (все ссылки)» или конкретная коллекция. Коллекция ограничивает цель ссылками, которые в ней лежат.

Ключ уникален в воркспейсе. Если поменять ключ у существующей цели, постбеки со старым ключом перестанут её находить.

Ссылка вне коллекции

Если цель ограничена коллекцией, а ссылка в эту коллекцию не входит, постбек вернёт goal_not_found. Добавьте ссылку в коллекцию или сделайте цель глобальной.

Как цель попадает в постбек

Ключ цели передаётся параметром goal:

https://<домен>/postback?subid={subid}&status={status}&payout={payout}&currency={currency}&tid={transaction_id}&goal=upsell

Если параметра goal нет, конверсия попадает в первую активную цель воркспейса (самую старую). Если целей нет вообще, Telegfy создаёт цель conversion.

Укажите goal, если у ПП есть разные события: покупка и апсейл, или регистрация и депозит. Так они разойдутся по разным целям и не склеятся.

Удаление цели

Удаление цели удаляет все её конверсии. Это необратимо. Вместо удаления выключите цель, если она может понадобиться позже. Выключенная цель не принимает конверсии.

Лимиты по тарифам

Тариф	Целей
Free	1
Pro	20
Enterprise	Без лимита

Если целей ещё нет, первый постбек без goal создаст цель conversion. На Free эта цель будет единственной. Лучше создать цель сразу с нужным ключом.

Статусы конверсий

Статус описывает, в каком состоянии конверсия. Он может меняться: лид становится продажей, продажа может стать отклонением.

Статус	Когда ставится	В доход
lead (Лид)	Заявка или ожидание подтверждения	Нет
sale (Продажа)	Подтверждённая оплата	Да
rejected (Отклонена)	Возврат, мошенничество, отмена	Нет
rebill (Ребилл)	Повторный платёж по подписке	Да
upsell (Апсейл)	Дополнительная покупка	Да

Статусы ПП переводятся в наши по словарю. Подробнее — в ПП и офферах.

Трекер на сайте

Если конверсии фиксирует ваш сайт, а не ПП, подключите трекер. Скрипт загружается с вашего домена Telegfy:

<script src="https://<домен>/tracker/v1.js"></script>

Вызов из кода:

la.track('purchase', { revenue: 25.5, currency: 'USD' });

Атрибут data-la-goal="purchase" на элементе тоже отправит конверсию. Трекер получает click id из параметра _la_ct в адресе, из localStorage или из cookie. Трекер не передаёт статус и tid, поэтому каждая отправка создаёт новую конверсию со статусом «Лид». Для дедупликации передавайте tid через API.

Частые ошибки

• Ключ не совпадает. В постбеке goal=Upsell, а цель upsell. Ключ чувствителен к регистру.
• Цель выключена. Постбек вернёт goal_not_found. Включите цель или поменяйте ключ.
• Коллекция. Ссылка не в коллекции цели, см. выше.

Что читать дальше

• Входящие постбеки — параметры постбека и ответы.
• Импорт конверсий — загрузка конверсий в цель.