Откройте нужный инструмент по ссылке ниже, затем выполняйте шаги инструкции.
Простыми словами
Pixel отправляет события из браузера, а Events API — из сервера бизнеса. Они помогают связать рекламу с действиями, но две копии одного заказа нужно согласовать, чтобы не посчитать его дважды.
Термины простыми словами · 12
- Pixel
- Браузерный источник событий сайта, например просмотра товара.
- Events API
- Серверный канал передачи событий TikTok.
- event_id
- Общий идентификатор двух копий одного действия для проверки дедупликации.
- Дедупликация
- Объединение двух технических копий одного события, чтобы покупка не считалась дважды.
- Test Events
- Тестовый просмотр поступления событий; не прогноз будущих продаж.
- GTM
- Google Tag Manager — сервис управления кодами аналитики и рекламы на сайте. Он задаёт, какой код и при каком действии запустить.
- dataLayer
- Список сообщений, который сайт передаёт Google Tag Manager. Например, сообщение об успешно принятой форме; разработчик задаёт его название и поля.
- URL
- Полный адрес страницы или файла, например https://example.com/catalog. При проверке ссылки важны также путь и параметры после знака вопроса.
- SKU
- Внутренний код товара или его варианта в каталоге продавца. Красная и синяя сумки могут иметь разные SKU; это не обязательно международный штрихкод.
- CMS
- Система редактирования сайта. Через неё команда, например, меняет текст услуги и публикует новую статью.
- production
- Рабочая версия сайта, которой пользуются реальные посетители. В примерах её также называют «боевой» версией.
- Атрибуция
- Правило, по которому действие или выручку связывают с источниками посещения. Разные правила могут распределить одну продажу по-разному.
Один источник данных получает проверенные события; Pixel и Events API согласованы по событию и event_id, параметры заказа динамические, токен хранится на сервере.
Что подготовить перед началом
- Доступ к Ads Manager, права редактирования источника и доступ к сайту, CMS или GTM; для API — к серверу.
- Карта событий: действие, условие подтверждения, источник, параметры, идентификатор и тест.
- Проверены обработка данных и согласие на сайте; предусмотрены разрешённая загрузка тегов и минимально необходимые данные.
- Известны текущие установки Pixel; есть тестовая форма или заказ и возможность проверить серверный результат.
01Спроектировать события до установки
Нажатие «Отправить» может завершиться ошибкой; открытие оплаты не доказывает покупку. Для новых установок используйте Lead и Purchase вместо SubmitForm и CompletePayment. Действующие старые интеграции продолжают работать.
- Опишите нужные события: ViewContent, AddToCart, Lead для принятой заявки и Purchase для подтверждённой покупки.
- Для каждого события запишите точное условие. Для Lead — успешный ответ сервера и запись заявки; для Purchase — выбранный бизнесом подтверждённый статус оплаты.
- Назначьте ответственного источника события. Если браузер и сервер передают одну покупку, заранее предусмотрите единый event_id.
- Клик WhatsApp не доказывает отправку сообщения. Свободное открытие страницы «Спасибо» не гарантирует новый лид.
- Не складывайте этапы в число клиентов: ViewContent, AddToCart и Purchase одного покупателя описывают один путь. Для бизнеса услуг настройте нужную цепочку лидов вместо выдуманной корзины.
Lead отправляется после ответа формы success и создания обращения №4831. Повторный клик при ошибке в номере телефона не отправляет Lead.
| Этап | Событие | Условие |
|---|---|---|
| Важная страница или карточка | ViewContent | Человек действительно просмотрел содержимое |
| Товар добавлен в корзину | AddToCart | Корзина приняла выбранный товар |
| Начато оформление | InitiateCheckout | Начался checkout; это ещё не оплата |
| Принята заявка | Lead для новой установки | Заявка подтверждена приложением и записана |
| Покупка | Purchase | Наступил согласованный подтверждённый момент покупки |
Понятно, что именно считается результатом; тест успешного и неуспешного сценария можно воспроизвести.
02Подключить один источник Web и базовый Pixel
При первом подключении возможна кнопка Get Started. После Web вводятся сайт и способ Partner Integration / Manual Setup. Перед установкой выясните, что уже делает CMS или партнёр.
- Введите URL и выберите Partner Integration для поддерживаемого партнёра, например GTM или Shopify; выполните мастер.
- В Manual Setup выберите способ, имя Pixel до 128 символов и сохраните идентификатор, например example.kz production.
- Установите выданный базовый код в одном месте. В GTM проверьте существующие TikTok-теги и условия согласия до публикации контейнера.
- С Pixel Helper проверьте нужный Pixel Code и двойную установку; учтите блокировщик и согласие тестового браузера.
Если CMS уже отправляет Pixel, дополнительная установка в GTM может дублировать браузерные события. Сравните идентификаторы и теги.

Pixel определяется один раз; код совпадает с источником Ads Manager.
03Настроить события через Event Builder либо код
Event Builder предлагает Button Clicks или URL Visits. Это сигналы, а не доказательства результата. Для формы без страницы подтверждения согласуйте с разработчиком событие успешного ответа приложения.
- Для Button Clicks выберите элемент и событие; проверьте, что клик соответствует измеряемому действию.
- Для URL Visits задайте устойчивое правило адреса. Страница подтверждения должна появляться после успеха; отдельно протестируйте прямое открытие и обновление.
- Для SPA проверьте переход без перезагрузки. При необходимости передавайте событие приложения или dataLayer после подтверждения.
- Если инструмент не работает, проверьте права, базовый Pixel и Content Security Policy.
- Сохраните настройки и выполните один успешный, один ошибочный и один повторный сценарий.
Lead по клику кнопки сработает при ошибке валидации. Для формы на той же странице используйте успешный ответ.
Успех даёт одно событие, ошибка — ни одного; повтор подтверждения не создаёт новый результат.
04Передавать динамические параметры покупки
value — сумма заказа числом; price — цена позиции; currency — поддерживаемый код, например KZT. Для каталога нужны совпадающие товарные идентификаторы. Реальные суммы подставляются динамически.
- Возьмите value из подтверждённого заказа; не передавайте строку «25 000 ₸». Последовательно учитывайте доставку и скидки.
- Для contents сформируйте массив товарных объектов с фактическими количествами и ценами. При использовании каталога сверяйте SKU или item_group_id.
- Для content_type используйте product или product_group согласно типу идентификатора; content_ids должен содержать идентификатор или массив, соответствующий каталогу.
- Отправьте два тестовых заказа с разными товарами и суммами, затем сравните параметры с системой заказов. Не включайте персональные данные в названия товара, URL или event_id.
Две позиции по 12 500 ₸ дают value: 25000, currency: 'KZT', quantity: 2. Изменение цены должно менять событие автоматически, а не требовать ручной правки тега.
Числа совпадают с заказом, товары — с каталогом; второй тест подтверждает динамику.
05Подключить Events API и общий идентификатор
Events API отправляет событие с сервера. Если ту же покупку передаёт Pixel, обе копии должны описывать одно действие с согласованным event_id. Создавать разные случайные ID на каждой стороне нельзя.
- Пусть приложение создаёт стабильный идентификатор конкретного бизнес-действия и передаёт его обоим каналам.
- Сопоставьте имя события, время, сумму и валюту браузерной и серверной копий.
- Проверьте событие в тестовых инструментах и поведение при повторном ответе сервера. Секрет API храните на сервере.
Для заказа ORD-104 две доставки используют согласованный ID. Повтор доставки — не новая покупка.
// Пример формы вызова, не готовая установка Pixel.
// order берётся из подтверждённого ответа сервера.
const eventId = `purchase:${order.id}`;
ttq.track('Purchase', {
value: Number(order.total),
currency: 'KZT'
}, { event_id: eventId });
// Серверная копия Purchase в тот же Pixel использует eventId.
// Access Token хранится только на сервере.Замените демонстрационные идентификаторы на значения своего проекта.
Одна покупка проходит тест обоих каналов без независимых идентификаторов и повторного бизнес-результата.
06Протестировать каналы, диагностику и счёт
В опубликованном Test Events вводится адрес, затем сайт открывается через QR в TikTok. Новый интерфейс может отличаться. Проверьте события и сверьте результаты с системой заявок или заказов.
- В Test Events откройте сайт по предложенному адресу или устройству, выполните действие, раскройте Event Activity.
- Проверьте время, событие, value, currency и event_id. Для API используйте тестовый режим текущего мастера.
- В Diagnostics → Active issues → Learn more изучите проблемы и примеры; исправьте параметры и идентификаторы, повторите затронутый тест.
- Проверьте покупку браузер+сервер, повторную серверную доставку, обновление подтверждения и второй независимый заказ.
- TikTok сопоставляет событие и event_id в окне 48 часов. Транспортная копия может оставаться в тестовом журнале: проверьте дедупликацию и итоговое измерение.
- В контрольном журнале сохраните только обезличенные сведения: сценарий, время, ID действия, канал доставки и результат. Скриншот должен показывать ваш реальный тест без контактов клиента; тестовый интерфейс не выдавайте за отчёт о продажах.
Два разных заказа дают два бизнес-результата; браузерная и серверная копии первого не должны увеличивать его до двух покупок. Рекламная атрибуция при этом может отличаться от общего числа заказов.
| Проверка | Что должно получиться |
|---|---|
| Клик без принятой формы или отказ оплаты | Нет Lead / Purchase подтверждённого результата |
| Одна принятая заявка или покупка | Один бизнес-результат после обработки |
| Browser и Server одного действия | Одинаковые событие, event_id и Pixel Code; проверьте дедупликацию |
| Повторная API-доставка того же действия | Сохраняет event_id; не создаёт новую бизнес-запись |
| Другой независимый заказ | Другой event_id и ещё один результат |
| Параметры покупки | Сумма, валюта и товары соответствуют реестру |
| Данные посетителя | Нет PII в произвольных названиях, URL и параметрах |
Проверены обе доставки, параметры и повторные сценарии; нет необъяснимого удвоения, выбранное событие можно использовать для оптимизации.
Одна покупка, два канала
Учебный пример: цифры и названия показывают способ работы, а не результаты клиента.
Заказ ORD-104 подтверждён
Браузерная копия события
Серверная копия с тем же event_id
Параметры и отсутствие дубля
Идентификатор условный. Не отправляйте произвольные контактные данные в параметры.
Авторская учебная схема SOAgency- Определите момент покупки: система подтвердила заказ или оплату по вашему правилу.
- В тесте создайте один заказ и согласованный event_id.
- Проверьте передачу суммы, валюты и идентификатора из браузера и сервера.
- В Test Events и диагностике убедитесь, что событие не создаётся повторно при обновлении страницы.
Есть воспроизводимый тест одной покупки с понятными параметрами. Наличие Pixel не означает готовую серверную интеграцию.
Выполните и проверьте
Отмечайте шаг после проверки результата. Отметки действуют до перезагрузки страницы; они не подтверждают, что настройка выполнена правильно.
Чек-лист по шагам · 6
Как настроить TikTok Pixel и Events API
- Опишите нужные события: ViewContent, AddToCart, Lead для принятой заявки и Purchase для подтверждённой покупки.
- Для каждого события запишите точное условие. Для Lead — успешный ответ сервера и запись заявки; для Purchase — выбранный бизнесом подтверждённый статус оплаты.
- Назначьте ответственного источника события. Если браузер и сервер передают одну покупку, заранее предусмотрите единый event_id.
- Клик WhatsApp не доказывает отправку сообщения. Свободное открытие страницы «Спасибо» не гарантирует новый лид.
- Не складывайте этапы в число клиентов: ViewContent, AddToCart и Purchase одного покупателя описывают один путь. Для бизнеса услуг настройте нужную цепочку лидов вместо выдуманной корзины.
Проверка: Понятно, что именно считается результатом; тест успешного и неуспешного сценария можно воспроизвести.
- Введите URL и выберите Partner Integration для поддерживаемого партнёра, например GTM или Shopify; выполните мастер.
- В Manual Setup выберите способ, имя Pixel до 128 символов и сохраните идентификатор, например example.kz production.
- Установите выданный базовый код в одном месте. В GTM проверьте существующие TikTok-теги и условия согласия до публикации контейнера.
- С Pixel Helper проверьте нужный Pixel Code и двойную установку; учтите блокировщик и согласие тестового браузера.
Проверка: Pixel определяется один раз; код совпадает с источником Ads Manager.
- Для Button Clicks выберите элемент и событие; проверьте, что клик соответствует измеряемому действию.
- Для URL Visits задайте устойчивое правило адреса. Страница подтверждения должна появляться после успеха; отдельно протестируйте прямое открытие и обновление.
- Для SPA проверьте переход без перезагрузки. При необходимости передавайте событие приложения или dataLayer после подтверждения.
- Если инструмент не работает, проверьте права, базовый Pixel и Content Security Policy.
- Сохраните настройки и выполните один успешный, один ошибочный и один повторный сценарий.
Проверка: Успех даёт одно событие, ошибка — ни одного; повтор подтверждения не создаёт новый результат.
- Возьмите value из подтверждённого заказа; не передавайте строку «25 000 ₸». Последовательно учитывайте доставку и скидки.
- Для contents сформируйте массив товарных объектов с фактическими количествами и ценами. При использовании каталога сверяйте SKU или item_group_id.
- Для content_type используйте product или product_group согласно типу идентификатора; content_ids должен содержать идентификатор или массив, соответствующий каталогу.
- Отправьте два тестовых заказа с разными товарами и суммами, затем сравните параметры с системой заказов. Не включайте персональные данные в названия товара, URL или event_id.
Проверка: Числа совпадают с заказом, товары — с каталогом; второй тест подтверждает динамику.
- Пусть приложение создаёт стабильный идентификатор конкретного бизнес-действия и передаёт его обоим каналам.
- Сопоставьте имя события, время, сумму и валюту браузерной и серверной копий.
- Проверьте событие в тестовых инструментах и поведение при повторном ответе сервера. Секрет API храните на сервере.
Проверка: Одна покупка проходит тест обоих каналов без независимых идентификаторов и повторного бизнес-результата.
- В Test Events откройте сайт по предложенному адресу или устройству, выполните действие, раскройте Event Activity.
- Проверьте время, событие, value, currency и event_id. Для API используйте тестовый режим текущего мастера.
- В Diagnostics → Active issues → Learn more изучите проблемы и примеры; исправьте параметры и идентификаторы, повторите затронутый тест.
- Проверьте покупку браузер+сервер, повторную серверную доставку, обновление подтверждения и второй независимый заказ.
- TikTok сопоставляет событие и event_id в окне 48 часов. Транспортная копия может оставаться в тестовом журнале: проверьте дедупликацию и итоговое измерение.
- В контрольном журнале сохраните только обезличенные сведения: сценарий, время, ID действия, канал доставки и результат. Скриншот должен показывать ваш реальный тест без контактов клиента; тестовый интерфейс не выдавайте за отчёт о продажах.
Проверка: Проверены обе доставки, параметры и повторные сценарии; нет необъяснимого удвоения, выбранное событие можно использовать для оптимизации.
TSV открывается в таблицах с разделителем «табуляция». В файле сохранены шаги, действия и критерии проверки этой статьи.
Частые ошибки
- Pixel установлен и в CMS, и в GTM.
- Серверный токен находится в коде страницы.
- Одно действие считается дважды.
Вопросы и ответы
Почему в старой интеграции CompletePayment или SubmitForm?
В 2025 TikTok переименовал их в Purchase и Lead. Старые интеграции продолжают работать; для новой установки используйте актуальные названия и проверьте отображение в отчётах.
Как избежать дублей событий TikTok Pixel и Events API?
Для копий одного действия нужны тот же источник, согласованное название события и одинаковый event_id. Новый случайный ID в каждом канале мешает распознать одну покупку.
Можно ли считать клик по WhatsApp лидом?
Он подтверждает переход, но не отправленное сообщение и не подходящую заявку. Измеряйте его отдельно, а реальное обращение подтверждайте доступным источником.
Когда отправлять Lead, если форма отправляется без перезагрузки страницы?
После подтверждённого приёма обращения приложением или сервером, по заранее согласованному контракту. Нажатие кнопки и ошибка отправки должны оставаться отдельными состояниями. Проверьте событие в тестовом инструменте и отсутствие повторной отправки при двойном клике.
Официальные источники
- Установка и проверка Pixel · TikTok ↗
- Подключение источника данных · TikTok ↗
- Event Builder · TikTok ↗
- Параметры событий · TikTok ↗
- Актуальные названия событий · TikTok ↗
- Дедупликация · TikTok ↗
- Test Events · TikTok ↗
- Диагностика веб-событий · TikTok ↗
- Официальный пример Pixel / Events API с event_id · TikTok ↗
- Стандартные события и параметры · TikTok ↗
Проверено 6 октября 2026 по публичному TikTok Business Help Center. Авторизованный рекламный кабинет визуально не проверялся: названия полей ниже взяты из справки, а доступные цели, рынки, способы оплаты и этапы нового Smart+ нужно сверять в своём аккаунте. Публикация статьи не подтверждает доступность рекламы на Казахстан. Иллюстрации взяты из открытой официальной статьи февраля 2025 и показывают исходный пример. Код в инструкции объясняет согласование идентификатора и требует подключения базового Pixel и реализации серверной отправки; это не полный API-клиент.
Связанные инструкции
События GA4 через GTM и dataLayer: пример заявки
dataLayer передаёт понятные события страницы в GTM. Для заявки важно отправить событие после успешного принятия данных, чтобы ошибка формы не увеличивала число лидов.
Читать инструкцию ↗Аналитика / UTMЗаявки в CRM, Google Sheets и Telegram: сайт и лид-формы без потерь
Свяжите сайт и рекламные лид-формы с рабочей очередью заявок. Разбираем Tilda → Google Sheets, Google Ads → CRM и формы Meta → CRM или таблицу через реальный коннектор; проверяем поля, доставку и повторы.
Читать инструкцию ↗TikTokЦели TikTok Ads и Smart+: как выбрать
Как выбрать продажи, лиды или охват в TikTok Ads и настроить Smart+. Разберём событие оптимизации, доступные ограничения, бюджет и материалы; автоматизация не заменяет проверку результата.
Читать инструкцию ↗