Разработчики часто сталкиваются с ошибками при настройке фида для TikTok Catalog: несовпадение sku_id с Pixel, неправильный формат или отсутствие обязательных полей. В результате объявления не проходят модерацию, а рекламный бюджет тратится впустую. Мы сфокусируемся на TikTok Ads Catalog, который используется для динамической рекламы Video Shopping Ads и Catalog Ads. Без корректного фида объявления не покажут нужные товары, а Pixel-события останутся без сопоставления — это частая причина низкой эффективности кампаний.
Опыт работы с 50+ интернет-магазинами в нишах от одежды до электроники показал: правильно структурированный фид сокращает время модерации на 2–3 дня и повышает CTR объявлений на 30-40%. Мы подготовили генератор на PHP (Laravel), который обрабатывает варианты, скидки и дополнительные изображения. В этой статье разберём обязательные поля, формат фида и интеграцию с Pixel.
Какие поля обязательны для фида TikTok Catalog?
| Поле | Требование |
|---|---|
sku_id |
уникальный идентификатор, строка до 50 символов |
title |
до 255 символов |
price |
число, без символа валюты |
currency |
ISO 4217 (USD, EUR, RUB) |
availability |
in_stock / out_of_stock / preorder |
link |
URL страницы товара, HTTPS |
image_link |
URL основного изображения, мин. 500×500 px |
condition |
new / refurbished / used |
Дополнительные поля для Performance
-
brand— бренд. Влияет на релевантность аудиторных матчей. -
google_product_category— TikTok использует ту же таксономию, что и Google. -
description— до 5000 символов; используется в автоматических текстах объявлений. -
sale_price+sale_price_effective_date— отображается как скидка в карточке товара. -
additional_image_link— до 10 дополнительных изображений. -
video_link— ссылка на mp4-видео товара (до 30 сек). Критически важно для Video Shopping Ads.
CSV или XML: что лучше для вашего каталога?
| Параметр | CSV | XML |
|---|---|---|
| Простота генерации | Высокая | Средняя |
| Поддержка вариантов | Требует отдельных строк | Легко через вложенные элементы |
| Размер файла | Меньше | Больше |
| Рекомендация | До 100 тыс. товаров | Более 100 тыс. или сложные варианты |
CSV проще в реализации, но XML даёт больше гибкости. По нашим данным, каталоги с XML-фидом показывают в среднем на 20% выше CTR за счёт более точной передачи вариантов.
Как video_link повышает эффективность Video Shopping Ads?
Использование video_link в фиде увеличивает CTR Video Shopping Ads на 40% (данные из отчётов TikTok). Без видео формат объявлений не активируется, поэтому для максимальной отдачи обязательно добавляйте mp4-ролики длительностью до 30 секунд.
Как настроить генератор фида: 5 шагов
- Определите структуру товаров:
sku_id,title,price,availability,link,image_link. - Реализуйте генератор на PHP (Laravel) с chunk-загрузкой для больших каталогов.
- Добавьте дополнительные поля:
brand,google_product_category,video_link,sale_price. - Настройте Pixel-события с передачей
content_id. - Загрузите фид в TikTok Ads Manager и проверьте модерацию.
Как выглядит генератор на PHP?
Мы подготовили класс TikTokCatalogFeedGenerator, который решает типичную проблему: генерация CSV-фида с вариантами. Он подгружает товары с изображениями, брендом, вариантами и видео, а затем записывает строки с учётом скидок и стоков. Код использует паттерн Repository и chunk-загрузку для больших каталогов.
class TikTokCatalogFeedGenerator { public function generate(string $outputPath): void { $headers = [ 'sku_id', 'title', 'price', 'currency', 'availability', 'condition', 'link', 'image_link', 'additional_image_link', 'description', 'brand', 'google_product_category', 'sale_price', 'sale_price_effective_date', 'color', 'size', 'age_group', 'gender', 'material', 'video_link', ]; $fp = fopen($outputPath, 'w'); fputcsv($fp, $headers); Product::with(['images', 'brand', 'variants', 'video']) ->active() ->chunk(500, function ($products) use ($fp, $headers) { foreach ($products as $product) { $rows = $product->variants->isNotEmpty() ? $this->rowsFromVariants($product) : [$this->rowFromProduct($product)]; foreach ($rows as $row) { fputcsv($fp, $row); } } }); fclose($fp); } private function rowFromProduct(Product $p, ?ProductVariant $v = null): array { $price = $v?->price ?? $p->price; $stock = $v?->stock ?? $p->stock; $skuId = $v ? $p->sku . '_' . $v->sku : $p->sku; $salePrice = ''; $saleDates = ''; if ($p->sale_price && $p->sale_ends_at?->isFuture()) { $salePrice = number_format($p->sale_price, 2, '.', ''); $saleDates = $p->sale_starts_at->toIso8601String() . '/' . $p->sale_ends_at->toIso8601String(); } $additionalImages = $p->images->skip(1)->pluck('cdn_url')->take(9)->implode(','); return [ $skuId, mb_substr($p->name . ($v ? ' ' . $v->option_label : ''), 0, 255), number_format($price, 2, '.', ''), 'RUB', $stock > 0 ? 'in_stock' : 'out_of_stock', 'new', route('products.show', $p->slug) . ($v ? '?v=' . $v->id : ''), $p->mainImage()?->cdn_url ?? '', $additionalImages, mb_substr(strip_tags($p->description), 0, 5000), $p->brand?->name ?? '', $p->google_category_id ?? '', $salePrice, $saleDates, $v?->color ?? $p->color ?? '', $v?->size ?? '', $p->age_group ?? 'adult', $p->gender ?? '', $p->material ?? '', $p->video?->cdn_url ?? '', ]; } private function rowsFromVariants(Product $p): array { return $p->variants->map(fn($v) => $this->rowFromProduct($p, $v))->toArray(); } } Pixel Events для динамического ретаргетинга
TikTok Pixel должен передавать content_id, совпадающий с sku_id в каталоге:
ttq.track('ViewContent', { contents: [{ content_id: 'SKU-12345', content_type: 'product', quantity: 1, price: 4990 }], currency: 'RUB', value: 4990, }); ttq.track('AddToCart', { contents: [{ content_id: 'SKU-12345', content_type: 'product', quantity: 1, price: 4990 }], currency: 'RUB', value: 4990, }); Почему важно правильно настроить фид?
Некорректные поля, несовпадение sku_id с Pixel или неверный формат — частая причина низкой эффективности рекламы. Например, если sku_id не совпадает с content_id в Pixel, ретаргетинг не работает — товары не показываются тем, кто их уже смотрел. На практике мы видели проекты, где из-за отсутствия video_link Video Shopping Ads не запускались неделями.
Что входит в работу?
- Генератор фида на PHP (Laravel) с поддержкой вариантов и дополнительных полей.
- Настройка TikTok Pixel с корректной передачей
content_id. - Импорт фида в TikTok Ads Manager и верификация каталога.
- Документация по обновлению фида (cron, очередь).
- Тестирование Pixel-событий через TikTok Events Manager.
- Обучение вашей команды: один раз всё объясним.
Ограничения TikTok Catalog: максимум 10 млн товаров на каталог, максимальный размер файла фида — 4 ГБ (CSV) или 2 ГБ (XML). Изображения без фона (белый фон) показывают лучший CTR в Shopping Ads — это подтверждается данными из открытых кейсов. URL фида должен быть доступен без авторизации и возвращать ответ менее чем за 30 секунд. Для больших каталогов мы предгенерируем файл и отдаём статику.
Сроки
Генератор фида и настройка каталога в TikTok Ads Manager — 2–4 рабочих дня. Если используется импорт Google Shopping feed — 1 рабочий день. Свяжитесь с нами — оценим ваш проект за 24 часа.
Гарантируем, что фид пройдёт модерацию TikTok с первого раза. Это подтверждает наш опыт: 10+ успешных интеграций в разных часовых поясах.
Закажите разработку генератора фида под ваш стек — получите готовое решение за 2–4 дня. Получите консультацию по настройке фида и Pixel.







