Настройка пикселя TikTok и Events API: пошагово для интернет-магазина

Что такое Events API TikTok и чем он отличается от пикселя?

Events API — это соединение «сервер — сервер», по которому события конверсий уходят в TikTok из вашей CMS или бэкенда, а не из браузера посетителя. Пиксель — это JavaScript-код на страницах сайта, он работает в браузере. Это не конкуренты, а два дополняющих друг друга канала.

Слабое место пикселя — зависимость от браузера. Блокировщики рекламы, ограничения cookie, медленно загружающаяся страница «Спасибо за заказ» или вкладка, закрытая сразу после оплаты, — и событие покупки до TikTok не доходит. Запись о заказе на сервере от всего этого не зависит. Поэтому TikTok в своей справке предлагает не заменять пиксель, а добавить Events API как второй канал и настроить дедупликацию.

Если вы уже подключали API конверсий у Meta, логика будет знакома — отличия мы разбирали в инструкции по настройке Conversions API.

Какой способ подключения выбрать?

Если магазин работает на Shopify, WooCommerce или другой платформе с официальным приложением TikTok, начните с него; при собственной разработке нужна прямая интеграция по API или серверная разметка через менеджер тегов. TikTok делит эти пути на партнёрские интеграции и ручную настройку.

Tilda: где вставить код пикселя

В Tilda код пикселя добавляется через «Настройки сайта → Еще → HTML-код для вставки внутрь Head», после чего страницы нужно переопубликовать. Для одной страницы путь такой: «Настройки этой страницы → Дополнительно → HTML-код для вставки внутрь Head». Учтите, что так вы подключаете только пиксель. Серверные события с Tilda напрямую не отправить — их придётся передавать из CRM, платёжного сервиса или через серверный менеджер тегов.

Shopify: уровень обмена данными

В официальном приложении TikTok для Shopify есть несколько уровней обмена данными, и базовый использует только пиксель. Выберите уровень, в описании которого указан Events API. Не добавляйте рядом второй код пикселя вручную: одно и то же событие придёт из двух источников с разными event_id, и дедупликация не сработает.

Как настроить пиксель TikTok и Events API по шагам?

Всё начинается с создания пикселя в «Менеджере событий»: затем браузерные события подключаются кодом пикселя, а серверные — через токен доступа. При работе через приложение платформы достаточно шагов 1, 2 и 5, при прямой интеграции — все пять.

1. Создайте пиксель В рекламном кабинете TikTok откройте «Инструменты» → «Менеджер событий» → «Подключить источник данных» → «Веб-сайт», укажите URL и дайте пикселю понятное имя, например по домену.
2. Выберите способ подключения «Партнерские интеграции» (Shopify, Google Tag Manager и др.) или «Ручная настройка» с вариантом «пиксель + Events API».
3. Сгенерируйте токен доступа В настройках пикселя, в разделе Events API, создайте токен (Generate Access Token). Не кладите его в код страницы или публичный репозиторий — храните на сервере в переменной окружения.
4. Отправляйте серверные события В каждом событии передавайте имя события, event_time в формате Unix, event_id, URL страницы и ключи сопоставления: ttclid, _ttp, хешированные email и телефон, IP, user agent.
5. Проверьте и запустите Во вкладке «Тестовые события» убедитесь, что приходят и браузерные, и серверные события, а затем в «Обзоре» проверьте, что способ подключения — «Сервер и браузер».

Какие стандартные события передавать?

Минимальный набор для интернет-магазина — ViewContent, AddToCart, InitiateCheckout и Purchase, с параметрами суммы и валюты. В списке стандартных событий TikTok, обновлённом в апреле 2026 года, покупка обозначается событием Purchase.

В старых настройках и во многих русскоязычных инструкциях встречаются события CompletePayment и PlaceAnOrder. С 1 мая 2025 года TikTok переименовал CompletePayment в Purchase (а SubmitForm — в Lead); старые названия автоматически конвертируются на стороне TikTok и в отчётах отображаются уже под новыми именами, так что действующий код продолжает работать. ClickButton и PlaceAnOrder полностью поддерживаются до 2027 года, после чего их отключат. В новых настройках используйте Purchase, а переход с PlaceAnOrder запланируйте заранее.

Для рекламы по каталогу значение content_ids должно совпадать с ID товара в каталоге символ в символ — иначе событие сопоставится с рекламой, но не с товаром. В value один раз решите, включаете ли вы доставку и налоги, и держите это правило во всех каналах: от него зависит расчёт ROAS. Валюту передавайте ISO-кодом (KZT, USD, EUR) и заранее сверьтесь со списком валют, которые поддерживает TikTok; если вашей там нет, пересчитывайте суммы в валюту рекламного аккаунта.

Как работает дедупликация по event_id?

Когда пиксель и Events API присылают одну покупку с одинаковым именем события и одинаковым event_id, TikTok засчитывает одну конверсию и сохраняет то событие, которое пришло первым. Если event_id нет или он различается, один заказ попадёт в отчёт дважды.

По правилам из справки TikTok, одинаковые события с одним event_id, пришедшие только от пикселя или только от Events API, дедуплицируются в течение 48 часов с момента первого события. Если же совпадают события пикселя и Events API, TikTok объединяет их, когда повторное событие приходит позже чем через 5 минут после первого и в пределах 48 часов. На практике это значит, что даже отложенная отправка серверного события в тот же день не мешает сопоставлению.

Пример: заказ № 10482

Покупатель из Алматы оформил заказ на 45 000 тенге. Событие пикселя на странице «Спасибо» и событие, которое сервер отправил при создании заказа, должны совпадать:

• Пиксель: event = Purchase, event_id = order_10482, value = 45000, currency = KZT
• Events API: event = Purchase, event_id = order_10482, value = 45000, currency = KZT

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

Как повысить качество сопоставления событий (EMQ)?

Оценка EMQ в «Менеджере событий» показывает, насколько полно вы передаёте ключи сопоставления: чем больше событий содержат больше ключей, тем выше оценка. Это аналог показателя качества сопоставления у Meta, и считается он отдельно для каждого типа события.

Ключи сопоставления для Events API: идентификатор клика ttclid, собственная cookie _ttp, email и телефон (расширенное сопоставление), внешний идентификатор external_id — например, номер клиента в вашей базе, — а также IP-адрес и user agent. Пиксель передаёт IP и user agent сам, в Events API их нужно добавлять вручную.

• Email: уберите пробелы, приведите к нижнему регистру, затем хешируйте SHA-256.
• Телефон: полный международный формат с кодом страны, без пробелов, скобок и дефисов. Казахстан: 8 701 123 45 67 → +77011234567; Узбекистан: 90 123 45 67 → +998901234567. Затем хешируйте.
• external_id: номер клиента, тоже в виде хеша; на сайтах с личным кабинетом он заметно помогает сопоставлению.
• ttclid и значение cookie _ttp передавайте как есть, их не хешируют.
• В серверное событие добавляйте реальный IP и user agent посетителя, а не адрес своего сервера.
• Рассмотрите автоматическое расширенное сопоставление в пикселе: он хеширует email и телефон из полей формы прямо в браузере.

В чувствительных нишах, например медицине или финансах, надёжнее ручное сопоставление, где вы контролируете каждое передаваемое поле. Проверьте с юристом, что политика конфиденциальности описывает передачу данных рекламным системам и что пиксель не срабатывает до согласия на cookie, если этого требует закон вашей страны или рынка сбыта (например, GDPR при продажах в ЕС).

Как проверить настройку и какие ошибки встречаются чаще всего?

Для проверки используйте вместе вкладку «Тестовые события», расширение TikTok Pixel Helper и вкладку «Диагностика». «Тестовые события» показывают поступающие данные в реальном времени и позволяют отдельно смотреть браузерные и серверные события.

1. Откройте «Тестовые события» и добавьте тестовый код (test_event_code) в серверные запросы.
2. Пройдите реальный путь покупателя: карточка товара, корзина, оформление, тестовый заказ.
3. Убедитесь, что каждое событие пришло и из браузера, и с сервера, а event_id совпадают.
4. После запуска следите во вкладке «Обзор» за способом подключения («Только браузер», «Только сервер» или «Сервер и браузер»), оценкой EMQ и временем последнего получения.
5. По каждой проблеме во вкладке «Диагностика» ссылка «Подробнее» показывает её влияние, шаги исправления и примеры затронутых событий.

Даже при правильной настройке число покупок в TikTok не совпадёт один в один с заказами в CMS: разницу объясняют окно атрибуции и конверсии после просмотра. Чтобы сравнивать каналы в одной таблице, экран анализа конверсий Marpany показывает данные TikTok, Meta и Google рядом с заказами магазина.

Что сделать в первую неделю после настройки?

Задача первой недели — убедиться, что данные идут корректно, и привязать оптимизацию кампаний к правильному событию; ставки и бюджеты меняйте уже после этого.

• День 1: в «Тестовых событиях» ключевые события приходят из обоих каналов, event_id совпадают.
• Дни 2–3: сравните число Purchase в TikTok с количеством заказов за те же дни и проверьте, нет ли двойного учёта.
• Дни 3–5: для событий с низкой оценкой EMQ добавьте недостающие ключи.
• День 7: проверьте, что кампании на конверсии на сайте оптимизируются под Purchase.
• Постоянно: после обновления шаблона, страницы оформления или приложения повторяйте проверку в «Тестовых событиях».

Чтобы пересмотреть структуру кампаний, таргетинг и креативы, начните с нашего руководства по рекламе в TikTok.