Оформление
Достижение вызываемой вручную цели
Тип Ручной вызов цели используется, когда о подтверждённом событии сообщает ваш код. Про остальные типы — в статье про создание цели.
Сообщить о такой цели можно двумя способами. Это одна и та же цель с одним идентификатором — вы выбираете не вид цели, а место, откуда приходит событие:
| Откуда приходит событие | Чем сообщаете | Что передаёте |
|---|---|---|
| Сайт, на котором стоит бандл | reachGoal из JS API — эта страница | id цели; при желании выручку и прибыль |
| Сервер, CRM, мобильное приложение | POST goals/reach | id цели; время события, доступные идентификаторы клиента и визита; при желании суммы |
Готовый вызов и готовый запрос с подставленным id цели показываются в редакторе самой цели.
Вызов на сайте
js
/* Clicked on add to cart */
ninja('reachGoal', '5d77fb20-4526-4b67-bd1c-2373e787fcd2')Первый аргумент — идентификатор цели из кабинета. Больше ничего обязательного нет.
Сессию и клиента передавать не нужно
reachGoal выполняется внутри уже запущенного бандла, а бандл держит текущую сессию и идентификатор клиента. Оба значения подставляются в конверсию сами — поэтому в JS-вызове нет полей sessionId и customerId: это не «необязательные» поля, а лишние.
Вызов связывается с текущим визитом. Рекламная привязка зависит от того, какие сведения об источнике есть у этого визита.
Если конверсию подтверждают позже
Когда заявку оставляют на сайте, а засчитывать её нужно только после проверки в CRM, возьмите на странице те же идентификаторы и сохраните их рядом с заявкой:
js
const customerId = await ninja('getCustomerIdAsync')
const sessionId = await ninja('getSessionIdAsync')Когда событие подтвердится, отправьте конверсию запросом с этими значениями — Передача конверсий (runtime). Так конверсия, пришедшая из CRM через несколько дней, вернётся к тому же человеку и к тому же визиту, что и вызов на сайте.
Выручка и прибыль
Третьим аргументом передаются деньги события:
js
/* Clicked on add to cart */
ninja('reachGoal', '5d77fb20-4526-4b67-bd1c-2373e787fcd2', {
revenue: 10,
netProfit: 1.35
})revenue— выручка события;netProfit— чистая прибыль события.
В JavaScript это числа; в REST API суммы передаются строками. Для отсутствующих или нулевых сумм действуют настройки цели: выручка, способы расчёта прибыли и приоритет значений.
Когда вызывать
- Вызывайте один раз после подтверждения события. Повторный вызов сообщает о новом достижении цели.
- Для заявки, которая подтверждается позже в CRM, сохраняйте идентификаторы при её создании и используйте серверную отправку после подтверждения.
- Проверьте событие в конверсиях цели: время, суммы и выбранный источник. Сохранённая цель без событий ещё не подтверждает работу установки.