TikTok

Как настроить TikTok Pixel и Events API

Установите TikTok Pixel и настройте Events API для действий сайта. Разберём карту событий, параметры покупки и общий event_id, затем проверим успех, ошибку и дедупликацию браузера и сервера.

Содержание статьи
Откройте инструменты перед началом

Откройте нужный инструмент по ссылке ниже, затем выполняйте шаги инструкции.

Открыть TikTok Ads Manager ↗

Простыми словами

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Спроектировать события до установки

В интерфейсеРабочая таблица событий → TikTok Help Center → Updated Standard Events

Нажатие «Отправить» может завершиться ошибкой; открытие оплаты не доказывает покупку. Для новых установок используйте Lead и Purchase вместо SubmitForm и CompletePayment. Действующие старые интеграции продолжают работать.

  1. Опишите нужные события: ViewContent, AddToCart, Lead для принятой заявки и Purchase для подтверждённой покупки.
  2. Для каждого события запишите точное условие. Для Lead — успешный ответ сервера и запись заявки; для Purchase — выбранный бизнесом подтверждённый статус оплаты.
  3. Назначьте ответственного источника события. Если браузер и сервер передают одну покупку, заранее предусмотрите единый event_id.
  4. Клик WhatsApp не доказывает отправку сообщения. Свободное открытие страницы «Спасибо» не гарантирует новый лид.
  5. Не складывайте этапы в число клиентов: ViewContent, AddToCart и Purchase одного покупателя описывают один путь. Для бизнеса услуг настройте нужную цепочку лидов вместо выдуманной корзины.
Пример заполнения

Lead отправляется после ответа формы success и создания обращения №4831. Повторный клик при ошибке в номере телефона не отправляет Lead.

Воронка TikTok: интерес, действие и подтверждённый результат
ЭтапСобытиеУсловие
Важная страница или карточкаViewContentЧеловек действительно просмотрел содержимое
Товар добавлен в корзинуAddToCartКорзина приняла выбранный товар
Начато оформлениеInitiateCheckoutНачался checkout; это ещё не оплата
Принята заявкаLead для новой установкиЗаявка подтверждена приложением и записана
ПокупкаPurchaseНаступил согласованный подтверждённый момент покупки
Проверка

Понятно, что именно считается результатом; тест успешного и неуспешного сценария можно воспроизвести.

02Подключить один источник Web и базовый Pixel

В интерфейсеAds Manager → Tools → Events Manager → Connect Data Source → Web

При первом подключении возможна кнопка Get Started. После Web вводятся сайт и способ Partner Integration / Manual Setup. Перед установкой выясните, что уже делает CMS или партнёр.

  1. Введите URL и выберите Partner Integration для поддерживаемого партнёра, например GTM или Shopify; выполните мастер.
  2. В Manual Setup выберите способ, имя Pixel до 128 символов и сохраните идентификатор, например example.kz production.
  3. Установите выданный базовый код в одном месте. В GTM проверьте существующие TikTok-теги и условия согласия до публикации контейнера.
  4. С Pixel Helper проверьте нужный Pixel Code и двойную установку; учтите блокировщик и согласие тестового браузера.
Пример заполнения

Если CMS уже отправляет Pixel, дополнительная установка в GTM может дублировать браузерные события. Сравните идентификаторы и теги.

Официальная иллюстрация окна Create pixel: Manual setup и Partner setup. Статья TikTok об интеграции Adobe, февраль 2025; актуальное окно аккаунта может отличаться.
Официальная иллюстрация окна Create pixel: Manual setup и Partner setup. Статья TikTok об интеграции Adobe, февраль 2025; актуальное окно аккаунта может отличаться. Рассмотреть крупнее ↗ · Официальный источник ↗
Проверка

Pixel определяется один раз; код совпадает с источником Ads Manager.

03Настроить события через Event Builder либо код

В интерфейсеPixel → Select Setup Method → Event Builder → business URL → Launch Event Builder → Add Event

Event Builder предлагает Button Clicks или URL Visits. Это сигналы, а не доказательства результата. Для формы без страницы подтверждения согласуйте с разработчиком событие успешного ответа приложения.

  1. Для Button Clicks выберите элемент и событие; проверьте, что клик соответствует измеряемому действию.
  2. Для URL Visits задайте устойчивое правило адреса. Страница подтверждения должна появляться после успеха; отдельно протестируйте прямое открытие и обновление.
  3. Для SPA проверьте переход без перезагрузки. При необходимости передавайте событие приложения или dataLayer после подтверждения.
  4. Если инструмент не работает, проверьте права, базовый Pixel и Content Security Policy.
  5. Сохраните настройки и выполните один успешный, один ошибочный и один повторный сценарий.
Пример заполнения

Lead по клику кнопки сработает при ошибке валидации. Для формы на той же странице используйте успешный ответ.

Проверка

Успех даёт одно событие, ошибка — ни одного; повтор подтверждения не создаёт новый результат.

04Передавать динамические параметры покупки

В интерфейсеСобытие Purchase → parameters: value / currency / contents / content_ids

value — сумма заказа числом; price — цена позиции; currency — поддерживаемый код, например KZT. Для каталога нужны совпадающие товарные идентификаторы. Реальные суммы подставляются динамически.

  1. Возьмите value из подтверждённого заказа; не передавайте строку «25 000 ₸». Последовательно учитывайте доставку и скидки.
  2. Для contents сформируйте массив товарных объектов с фактическими количествами и ценами. При использовании каталога сверяйте SKU или item_group_id.
  3. Для content_type используйте product или product_group согласно типу идентификатора; content_ids должен содержать идентификатор или массив, соответствующий каталогу.
  4. Отправьте два тестовых заказа с разными товарами и суммами, затем сравните параметры с системой заказов. Не включайте персональные данные в названия товара, URL или event_id.
Пример заполнения

Две позиции по 12 500 ₸ дают value: 25000, currency: 'KZT', quantity: 2. Изменение цены должно менять событие автоматически, а не требовать ручной правки тега.

Проверка

Числа совпадают с заказом, товары — с каталогом; второй тест подтверждает динамику.

05Подключить Events API и общий идентификатор

В интерфейсеEvents Manager → выбранный Pixel → Settings → Events API / Access Token Generation

Events API отправляет событие с сервера. Если ту же покупку передаёт Pixel, обе копии должны описывать одно действие с согласованным event_id. Создавать разные случайные ID на каждой стороне нельзя.

  1. Пусть приложение создаёт стабильный идентификатор конкретного бизнес-действия и передаёт его обоим каналам.
  2. Сопоставьте имя события, время, сумму и валюту браузерной и серверной копий.
  3. Проверьте событие в тестовых инструментах и поведение при повторном ответе сервера. Секрет 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 хранится только на сервере.
Замените демонстрационные идентификаторы на значения своего проекта.
Официальный фрагмент TikTok: Events API → Access Token Generation → Generate Access Token. Из статьи февраля 2025; токен следует хранить на сервере.
Официальный фрагмент TikTok: Events API → Access Token Generation → Generate Access Token. Из статьи февраля 2025; токен следует хранить на сервере. Рассмотреть крупнее ↗ · Официальный источник ↗
Проверка

Одна покупка проходит тест обоих каналов без независимых идентификаторов и повторного бизнес-результата.

06Протестировать каналы, диагностику и счёт

В интерфейсеEvents Manager → Pixel / dataset → Test Events; затем Diagnostics → Active issues → Learn more

В опубликованном Test Events вводится адрес, затем сайт открывается через QR в TikTok. Новый интерфейс может отличаться. Проверьте события и сверьте результаты с системой заявок или заказов.

  1. В Test Events откройте сайт по предложенному адресу или устройству, выполните действие, раскройте Event Activity.
  2. Проверьте время, событие, value, currency и event_id. Для API используйте тестовый режим текущего мастера.
  3. В Diagnostics → Active issues → Learn more изучите проблемы и примеры; исправьте параметры и идентификаторы, повторите затронутый тест.
  4. Проверьте покупку браузер+сервер, повторную серверную доставку, обновление подтверждения и второй независимый заказ.
  5. TikTok сопоставляет событие и event_id в окне 48 часов. Транспортная копия может оставаться в тестовом журнале: проверьте дедупликацию и итоговое измерение.
  6. В контрольном журнале сохраните только обезличенные сведения: сценарий, время, ID действия, канал доставки и результат. Скриншот должен показывать ваш реальный тест без контактов клиента; тестовый интерфейс не выдавайте за отчёт о продажах.
Пример заполнения

Два разных заказа дают два бизнес-результата; браузерная и серверная копии первого не должны увеличивать его до двух покупок. Рекламная атрибуция при этом может отличаться от общего числа заказов.

Как принять настройку Pixel и Events API
ПроверкаЧто должно получиться
Клик без принятой формы или отказ оплатыНет Lead / Purchase подтверждённого результата
Одна принятая заявка или покупкаОдин бизнес-результат после обработки
Browser и Server одного действияОдинаковые событие, event_id и Pixel Code; проверьте дедупликацию
Повторная API-доставка того же действияСохраняет event_id; не создаёт новую бизнес-запись
Другой независимый заказДругой event_id и ещё один результат
Параметры покупкиСумма, валюта и товары соответствуют реестру
Данные посетителяНет PII в произвольных названиях, URL и параметрах
Проверка

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

УЧЕБНЫЙ РАЗБОР

Одна покупка, два канала

Учебный пример: цифры и названия показывают способ работы, а не результаты клиента.

НА ПРИМЕРЕПередача покупки
Магазин

Заказ ORD-104 подтверждён

Pixel

Браузерная копия события

Events API

Серверная копия с тем же event_id

Проверка

Параметры и отсутствие дубля

Идентификатор условный. Не отправляйте произвольные контактные данные в параметры.

Авторская учебная схема SOAgency
  1. Определите момент покупки: система подтвердила заказ или оплату по вашему правилу.
  2. В тесте создайте один заказ и согласованный event_id.
  3. Проверьте передачу суммы, валюты и идентификатора из браузера и сервера.
  4. В 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

TSV открывается в таблицах с разделителем «табуляция». В файле сохранены шаги, действия и критерии проверки этой статьи.

Удалось решить задачу?

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

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

  • Pixel установлен и в CMS, и в GTM.
  • Серверный токен находится в коде страницы.
  • Одно действие считается дважды.

Вопросы и ответы

Почему в старой интеграции CompletePayment или SubmitForm?

В 2025 TikTok переименовал их в Purchase и Lead. Старые интеграции продолжают работать; для новой установки используйте актуальные названия и проверьте отображение в отчётах.

Как избежать дублей событий TikTok Pixel и Events API?

Для копий одного действия нужны тот же источник, согласованное название события и одинаковый event_id. Новый случайный ID в каждом канале мешает распознать одну покупку.

Можно ли считать клик по WhatsApp лидом?

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

Когда отправлять Lead, если форма отправляется без перезагрузки страницы?

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

Официальные источники

Проверено 6 октября 2026 по публичному TikTok Business Help Center. Авторизованный рекламный кабинет визуально не проверялся: названия полей ниже взяты из справки, а доступные цели, рынки, способы оплаты и этапы нового Smart+ нужно сверять в своём аккаунте. Публикация статьи не подтверждает доступность рекламы на Казахстан. Иллюстрации взяты из открытой официальной статьи февраля 2025 и показывают исходный пример. Код в инструкции объясняет согласование идентификатора и требует подключения базового Pixel и реализации серверной отправки; это не полный API-клиент.

Связанные инструкции

Написать в WhatsApp

Как используются ваши данные

Имя, телефон и описание задачи нужны, чтобы ответить на вашу заявку. Они не используются для рассылок.

Заявка передаётся владельцу so-agency через Telegram. Вместе с ней передаём страницу, с которой вы обратились, и метки источника, канала и рекламной кампании, если они есть в ссылке. При выборе WhatsApp откроется чат с подготовленным текстом; отправку сообщения подтверждаете вы.

Используем Google Tag Manager для управления аналитикой. Она помогает понять, какие страницы и услуги полезны: учитываем обращения к контактам, переходы в проекты, глубину просмотра статей, действия с инструментами и учебной демонстрацией, а также начало заполнения, отправку, ошибки и успешную доставку заявки.

В параметры этих событий не передаём имя, телефон, текст обращения, исходные списки, ссылку для QR-кода или загруженные изображения. Сервисы аналитики могут получать технические сведения об устройстве и посещённых страницах, примерном регионе и cookies в зависимости от настроек подключённых тегов.

Данные инструментов обрабатываются в вашем браузере. Шаблон названий кампаний сохраняется на устройстве только по кнопке «Сохранить шаблон на этом устройстве». При передаче списка в другой инструмент он временно сохраняется в пределах текущей вкладки.

Сайт не публикует заявки и не просит пароли от рекламных кабинетов. По вопросам данных: +7 708 900 77 26.

Напишите в WhatsApp

Откройте камеру телефона и наведите её на QR-код. Откроется чат с so-agency.

QR-код: чат WhatsApp so-agency+7 708 900 77 26
Открыть WhatsApp на компьютере ↗

Сообщение отправите вы — чат открывается без автоматической рассылки.