Генерация фида товаров для Facebook/Instagram Catalog

Генерация фида товаров для Facebook/Instagram Catalog

Meta требует фид в формате CSV, TSV или XML (RSS/Atom). Каталог используется в динамической рекламе (Dynamic Ads), Instagram Shopping и Shops — три разных плейсмента с частично пересекающимися требованиями к полям. Одна ошибка в формате поля price или availability приводит к отклонению всей партии товаров при загрузке.

Обязательные поля каталога

Дополнительные поля для одежды и обуви

Для категории Apparel & Accessories Meta требует:

• google_product_category — числовой ID из таксономии Google (Meta использует именно её)
• size — размер (XL, 44, 42/34)
• color — цвет на языке целевой аудитории
• gender — male / female / unisex
• age_group — adult / kids / newborn
• material — материал (опционально, но повышает relevance score)

Генератор CSV-фида

CSV проще в генерации и отладке, чем XML. Meta принимает оба формата одинаково.

class MetaCatalogFeedGenerator
{
    private const HEADERS = [
        'id', 'title', 'description', 'availability', 'condition',
        'price', 'link', 'image_link', 'additional_image_link',
        'brand', 'google_product_category', 'color', 'size',
        'gender', 'age_group', 'sale_price', 'sale_price_effective_date',
    ];

    public function generate(string $outputPath): void
    {
        $file = fopen($outputPath, 'w');
        // BOM не добавляем — Meta не требует, может сломать парсер
        fputcsv($file, self::HEADERS, "\t"); // TSV надёжнее CSV из-за запятых в описании

        Product::with(['images', 'category', 'brand', 'variants'])
            ->where('is_active', true)
            ->chunk(200, function ($products) use ($file) {
                foreach ($products as $product) {
                    foreach ($this->expandVariants($product) as $row) {
                        fputcsv($file, $row, "\t");
                    }
                }
            });

        fclose($file);
    }

    private function expandVariants(Product $product): array
    {
        if ($product->variants->isEmpty()) {
            return [$this->buildRow($product, null)];
        }

        return $product->variants->map(
            fn($variant) => $this->buildRow($product, $variant)
        )->toArray();
    }

    private function buildRow(Product $product, ?ProductVariant $variant): array
    {
        $id    = $variant ? $product->sku . '-' . $variant->sku : $product->sku;
        $price = $variant?->price ?? $product->price;
        $stock = $variant?->stock ?? $product->stock;

        $additionalImages = $product->images->skip(1)
            ->pluck('cdn_url')
            ->take(9) // Meta допускает до 10 изображений
            ->implode(',');

        $salePrice = '';
        $salePriceDate = '';
        if ($product->sale_price && $product->sale_ends_at > now()) {
            $salePrice = number_format($product->sale_price, 2, '.', '') . ' RUB';
            $salePriceDate = $product->sale_starts_at->toIso8601String()
                . '/' . $product->sale_ends_at->toIso8601String();
        }

        return [
            $id,
            mb_substr($product->name . ($variant ? ' ' . $variant->name : ''), 0, 150),
            strip_tags($product->description),
            $stock > 0 ? 'in stock' : 'out of stock',
            'new',
            number_format($price, 2, '.', '') . ' RUB',
            route('products.show', $product->slug) . ($variant ? '?variant=' . $variant->id : ''),
            $product->mainImage()?->cdn_url ?? '',
            $additionalImages,
            $product->brand?->name ?? '',
            $product->google_category_id ?? '',
            $variant?->color ?? $product->color ?? '',
            $variant?->size ?? '',
            $product->gender ?? '',
            $product->age_group ?? 'adult',
            $salePrice,
            $salePriceDate,
        ];
    }
}

Настройка в Business Manager

После генерации фида:

1. Commerce Manager → Catalog → Data Sources → Add Data Feed
2. Указать URL фида или загрузить файл вручную
3. Выбрать расписание обновления: ежечасно, ежедневно или вручную
4. Назначить каталог рекламным аккаунтам

Meta предоставляет диагностику ошибок в разделе Catalog → Issues — каждая позиция с проблемой помечается с описанием причины.

Pixel + Catalog для динамического ретаргетинга

Для Dynamic Ads недостаточно только фида — нужно настроить Meta Pixel с событиями:

// Страница товара
fbq('track', 'ViewContent', {
  content_ids: ['SKU-44231'],
  content_type: 'product',
  value: 4990.00,
  currency: 'RUB',
});

// Добавление в корзину
fbq('track', 'AddToCart', {
  content_ids: ['SKU-44231'],
  content_type: 'product',
  value: 4990.00,
  currency: 'RUB',
});

content_ids должны точно совпадать с полем id в каталоге — иначе матчинг не работает.

Сроки

Генератор фида + настройка источника данных в Business Manager — 3–4 рабочих дня. Интеграция с Pixel и тестирование динамического ретаргетинга — ещё 1–2 рабочих дня.