Katalog Meta nerozpoznává produkty z PrestaShopu? Zkontrolujte ID, varianty a Pixel

Pokud události z PrestaShopu neodpovídají produktům v katalogu Meta, porovnejte plný identifikátor nabídky s hodnotou odesílanou v content_ids. Rozhodující jsou prefix, oddělovač a číslo kombinace. Pro integraci identifikátory 812, ps_812-41 a ps_812_41 znamenají různé řetězce, i když si je člověk může spojit se stejnou kartou produktu.

Tento návod pomáhá ověřit spolupráci produktového feedu a Pixelu. Příklady jsou demonstrační, bez údajů zákazníků. Nejde o snímek z reklamního účtu ani o potvrzení výsledků kampaně.

Katalog, Pixel a Conversions API plní různé úkoly

Katalog obsahuje nabídky: identifikátory, názvy, fotografie, ceny a dostupnost. Feed je jedním ze způsobů, jak tato data dodat. Pixel odesílá události z prohlížeče, např. zobrazení produktu nebo přidání do košíku. Conversions API umožňuje odesílat události ze serverové strany.

Správně načtený katalog nedokazuje, že se události odkazují na správné nabídky. Přítomnost události nákupu zase nedokazuje, že každý produkt z tohoto nákupu má shodu v katalogu. Nejprve určete, kterou část propojení diagnostikujete.

Zkontrolujte také, zda sledujete správný katalog a správný zdroj událostí. Při více obchodech, starém Pixelu nebo testovacím feedu můžete porovnávat technicky správná data pocházející z různých konfigurací.

Příklad: jeden produkt, dvě kombinace

Předpokládejme produkt s ID 812 a kombinace 41 a 42. Feed exportuje varianty jako samostatné nabídky s prefixem ps_ a pomlčkou. Pro první kombinaci je tedy identifikátor ps_812-41.

Nejjednodušší kontrola spočívá ve zkopírování hodnoty ze zpracované nabídky a události do dvou řádků. Porovnejte je znak po znaku. Neodstraňujte „zbytečný“ prefix, dokud neurčíte, na co odkazují ostatní integrace.

Co bylo ověřeno v modulech PrestaDev?

V kódu Facebook Pixel Pro 1.4.5 je k dispozici volba způsobu sestavení ID a volitelného prefixu. Jedna z cest vytváří ID produktu spojené s ID kombinace pomlčkou, jiná používá podtržítko. Existují také režimy založené na jiných polích. Jde o konfiguraci, kterou je třeba porovnat se skutečným exportem, a ne vybírat pouze podle názvu.

Ověřený kód feedu Meta 2.9.2 při exportu kombinací zapisuje g:id ve formátu prefix + ID produktu + pomlčka + ID kombinace. Pro toto nastavení nebude varianta ps_812_41 odesílaná Pixelem totožná s ps_812-41 ve feedu. V této cestě feed zapisuje společné g:item_group_id jako ID produktu bez prefixu.

Jde o potvrzení způsobu sestavení dat v uvedených verzích kódu, nikoli o důkaz shody na konkrétním účtu Meta. Po změně nastavení je stále nutné zkontrolovat vygenerovaný soubor, import katalogu a skutečnou událost.

content_ids a content_type musí být konzistentní

content_ids obsahuje identifikátory související s událostí. content_type určuje způsob vztahu k produktům nebo jejich skupinám. Není vhodné měnit product na product_group jen proto, aby zmizela hláška: mění to význam identifikátorů, na které se událost odkazuje.

V probíraném příkladu vybíráme konkrétní nabídku varianty a content_type: "product". Zjednodušená sada dat pro zobrazení varianty vypadá takto:

{
  "content_ids": ["ps_812-41"],
  "content_type": "product",
  "value": 129.00,
  "currency": "PLN"
}

Jde o část dat ukázkové události, nikoli o kompletní implementační kód ani požadavek do API. Typy polí content_ids, content_type, value a currency lze ověřit v oficiálním SDK Meta — CustomData. Při diagnostice konkrétního účtu zkontrolujte také aktuální hlášky ve Správci událostí.

Po změně varianty proveďte nový test

Správné ID při prvním otevření stránky nestačí. Šablona může měnit variantu bez znovunačtení dokumentu. Integrace událostí by měla použít data odpovídající aktuální akci, místo aby zůstala u výchozí kombinace.

1. Vyberte produkt s alespoň dvěma kombinacemi přítomnými ve feedu.
2. Zapište si jejich plné identifikátory ze souboru a z katalogu po importu.
3. Otevřete produkt v kontrolované testovací relaci se správným nastavením souhlasů.
4. Zkontrolujte data události týkající se první varianty.
5. Změňte kombinaci a přidejte vybranou variantu do košíku.
6. Porovnejte ID, množství, hodnotu a měnu události s aktuálním košíkem.
7. Zkontrolujte, zda stejnou akci navíc neodesílá druhá instalace Pixelu, např. přes jiný modul nebo správce tagů.

Neinterpretujte chybějící událost jako chybu katalogu, dokud nezkontrolujete souhlasy, blokování skriptů a konfiguraci zdroje událostí. Odesílání dat přes server také vyžaduje správnou konfiguraci ochrany soukromí; CAPI by nemělo být považováno za způsob obcházení rozhodnutí uživatele.

Hodnota a měna jsou samostatná kontrola

Shodné ID nepotvrzuje správnou částku. U produktové události zkontrolujte cenu vybrané kombinace a u nákupu dohodnutou definici hodnoty celé objednávky. Neporovnávejte jeden kus se součtem košíku ani částku bez DPH s částkou včetně DPH bez určení, jak implementace funguje.

Měna musí odpovídat odeslané hodnotě. U víceměnového obchodu proveďte samostatný test po její změně. Pokud data pocházejí z objednávky, porovnávejte je s uloženou objednávkou, nikoli s aktuální katalogovou cenou zjištěnou později.

Shoda produktu a deduplikace nákupu

Deduplikace rozpoznává dvě kopie stejné události odeslané z prohlížeče a serveru. Neslouží ke spojování variant produktu. V oficiálním SDK Meta je popsáno, že u odpovídajících si událostí má prohlížečové eventID souhlasit se serverovým event_id a v procesu se používá také název události. Zdroj: Meta — popis Event a setEventId.

Stálé event_id rovné ID produktu by bylo nevhodným nápadem pro různé nákupy tohoto produktu. Naopak shodné identifikátory události neopraví chybné content_ids. Kontrolujte tyto dvě věci odděleně. Pokud analyzujete také GA4, využijte existující návod k měření nákupů.

Čím začít zlepšení integrace?

Vyberte jeden produkt a uchovejte tři údaje: ID v obchodě, ID importované do katalogu a ID z události. Určete formát, změňte správné nastavení, obnovte potřebný zdroj a test opakujte. Neměňte současně prefix, oddělovač, způsob exportu variant a několik instalací Pixelu — ztíží to určení, která úprava problém vyřešila.

Zkontrolujte shodu formátu ID v obou integracích: Facebook Pixel Pro a XML feed produktů pro Meta. Jejich konfigurace by měla vycházet ze stejného modelu katalogu. Správná shoda je prvkem kvality dat, nikoli zárukou ziskovosti reklam.

Věcná kontrola: 13. září 2026. Byl zkontrolován kód Facebook Pixel Pro 1.4.5, feedu Meta 2.9.2 a veřejné definice v oficiálním SDK Meta. Nebylo provedeno publikování ani testovací nákup na reklamním účtu klienta.