# Следы сквозной аналитики

След хранит путь посетителя сайта и источник обращения. Создайте лид через `POST /v1/leads`, затем передайте его id в `entities` при создании следа.

Битрикс24 API: `crm.tracking.trace.add`, `crm.tracking.trace.delete`

Скоуп: `crm`. Требуется ключ READWRITE.

## Операции

- [Создать след](./crm-traces/create.md) — `POST /v1/crm-traces`
- [Удалить след](./crm-traces/delete.md) — `DELETE /v1/crm-traces/:id`

## Сценарий: форма на сайте

Получите след из `b24Tracker.guest.getTrace()`. Создайте лид через [API лидов](./leads.md), затем передайте полученный id:

```json
{"trace":{"url":"https://example.com/form","ref":"https://example.com/news","tags":{"list":{"utm_source":"newsletter","utm_campaign":"autumn"}}},"entities":[{"type":"LEAD","id":123}]}
```

Чтение следов в REST не предусмотрено. Удаление идемпотентно: ответ не подтверждает существование следа или удаление всех привязок.