DataFirefly Google Shopping: volledige gids

Overzicht

DataFirefly Google Shopping is een module voor PrestaShop 8 en 9 die Merchant Center-feeds genereert conform de Google Shopping-specificatie 2025 en ze automatisch uitrolt naar 6 kanalen (Google, Bing, Meta Catalog, Kelkoo, Idealo, LeGuide). Hij bevat 5 AI-assistenten (Anthropic Claude, OpenAI GPT-4o of Mistral AI naar keuze), een kwaliteitsscore van 0 tot 100, een AJAX-bulkeditor, een beeldaudit via AI-vision en premiumtools (A/B-test van titels, seizoensforecaster, export naar Google Ads Editor).

De module maakt 12 tabellen met het voorvoegsel dfgs_ aan en 9 backoffice-tabbladen onder het menu “Google Shopping”. Geen core-overrides, geen gewijzigde PrestaShop-bestanden.

Installatie

1. Ga in de PrestaShop-backoffice naar Modules → Modulebeheer → Een module installeren.
2. Upload het bestand dfexportgoogleshopping.zip.
3. Klik op Installeren. De module maakt zijn tabellen, zijn beheertabbladen en zijn standaard configuratiewaarden aan.

Vereisten: PrestaShop 8.0 tot 9.x, PHP 8.1+, MySQL 5.7+ of MariaDB 10.3+, cURL-extensie ingeschakeld. Multistore en meertaligheid worden native ondersteund.

Uw eerste feed aanmaken

1. Ga naar Google Shopping → Feeds en klik op Een feed toevoegen.
2. Vul de naam in, het feedtype (Producten, Local Inventory Ads of Promoties), de winkel, de taal, de valuta en het doelland.
3. Kies het doelkanaal: Google Shopping (standaard), Bing, Meta Catalog, Kelkoo, Idealo of LeGuide. Het XML-formaat wordt automatisch aan het kanaal aangepast (namespaces, hernoemde attributen, lengtelimieten).
4. Configureer de inclusiefilters: categorieën, fabrikanten, uitsluiting van producten die niet op voorraad zijn.
5. Sla op en klik daarna op Genereren. De publieke URL van de feed (beveiligd met een token) verschijnt in de lijst, en die geeft u op in Merchant Center.

Mapping van de Google-categorieën

Koppel in Google Shopping → Categoriemapping elke categorie van uw winkel aan een categorie uit de Google-taxonomie (ongeveer 6.000 vermeldingen, 30 dagen gecachet). Twee methoden:

• Handmatig: zoeken met autoaanvulling in de taxonomie.
• Automatische AI-mapping: de knop “Automatisch mappen” stuurt uw niet-gemapte categorieën naar de AI-assistent, die de beste overeenkomst voorstelt. Voorstellen met hoge zekerheid worden toegepast, de andere wachten op validatie.

De mapping plant zich voort naar de niet-gemapte subcategorieën. Het attribuut google_product_category en het product_type worden automatisch in de feed ingevuld.

Productoverrides

Via het tabblad Productoverrides kunt u per product (en per taal/winkel) de feedwaarden forceren: titel, merk, GTIN, MPN, staat, kleur, maat, materiaal, custom labels 0-4, Google-categorie, uitsluiting uit de feed, enzovoort. De overrides krijgen altijd voorrang op de uit de catalogus gehaalde waarden.

Bulkbewerking

Het tabblad Bulkbewerking toont een AJAX-raster van 50 producten per pagina met zoeken op naam, referentie of ID. Werking:

• Inline bewerken: klik in een cel, voer de waarde in, druk op Enter, het opslaan gebeurt onmiddellijk (groene achtergrond = geslaagd).
• Bulkactie: vink meerdere producten aan, kies een veld en een waarde, klik op Toepassen. De knop “Overrides verwijderen” haalt de overrides van de geselecteerde producten weg.

CSV-import/export en voorbeeldweergave

Het tabblad Import / Export / Preview bundelt drie tools:

• CSV-export van de overrides of de categoriemappings (UTF-8 met BOM, puntkomma als scheidingsteken, compatibel met Excel).
• CSV-import met duidelijke semantiek: lege cel = geen wijziging, asterisk (*) = veld leegmaken.
• XML-voorbeeld: voer een product-ID en een feed in en krijg de exacte XML van dat product, met de gedetecteerde validatieproblemen. Ideaal om een geweigerd product te debuggen.

AI-assistenten

Configureer eerst de provider in Google Shopping → Instellingen: Anthropic (Claude), OpenAI (ChatGPT/GPT-4o) of Mistral AI, met uw API-sleutel en het model. Aanbevolen modellen: claude-haiku-4-5-20251001 of gpt-4o-mini (snel, goedkoop); claude-sonnet-4-6 of gpt-4o voor maximale kwaliteit.

Het tabblad AI-assistenten stuurt de 5 assistenten aan:

• Categoriemapping: koppelt uw categorieën aan de Google-taxonomie.
• Titels herschrijven: optimaliseert de titels volgens de gedetecteerde verticale markt (apparel, electronics, books, home, beauty, food) en de door Google aanbevolen patronen.
• Attributen extraheren: leidt color, size, material, pattern, age_group en gender af uit de beschrijvingen (zekerheid ≥ 0,80).
• GTIN zoeken: vindt de GTIN op basis van merk + MPN + naam, met modulo 10-validatie (zekerheid ≥ 0,85).
• Weigeringen corrigeren: analyseert elke Merchant Center-weigering en stelt een gestructureerde correctie voor (of past die automatisch toe bij een zekerheid ≥ 0,85).

Elke aanroep wordt gelogd in de tabel dfgs_ai_log (provider, model, in- en uitgaande tokens, duur): u volgt uw AI-budget tot op de cent.

Kwaliteitsscore 0-100

Bij elke generatie van een productfeed neemt de module een steekproef van 500 items en berekent 9 gewogen subscores: GTIN-dekking (15 ptn), beelddekking (10), beeldkwaliteit (10), titelkwaliteit (15), beschrijvingskwaliteit (10), categoriemapping (15), highlights-dekking (10), afwezigheid van openstaande kritieke weigeringen (10), aanwezigheid van de verzendkosten (5). Het totaal geeft een cijfer van A+ tot F op het dashboard, met bovenaan de 5 aanbevelingen met de grootste impact.

Slack- en e-mailwaarschuwingen

Vul in Instellingen een inkomende Slack-webhook en/of een e-mailadres in. Drie triggers: nieuwe kritieke weigeringen gedetecteerd tijdens een generatie, daling van de kwaliteitsscore met ≥ 10 punten ten opzichte van de vorige generatie, mislukte generatie. Antispam: maximaal 1 waarschuwing per type per 6 uur.

Premiumfuncties

Het tabblad Premium bundelt 5 tools:

• Search Console-analyse: upload de CSV-export van de zoekopdrachten (Search Console → Zoekresultaten → Exporteren). De module kruist elke zoekopdracht met uw producttitels en berekent een opportuniteitsscore (vertoningen × in de titel ontbrekende zoekwoorden × positievermenigvuldiger). De 20 beste kansen worden getoond met het voorgestelde product.
• A/B-test van titels: twee varianten wisselen elkaar af in cycli van 7 dagen in de feed. De winnaar wordt uitgeroepen zodra elke variant ≥ 500 vertoningen haalt met een CTR-verschil van ≥ 5%; hij wordt dan automatisch als override toegepast.
• Seizoensforecaster: analyseert 24 maanden bestelgeschiedenis en tagt de producten in custom_label_4: upcoming_season (seizoensindex > 1,5 voor de komende 2 maanden), bestseller (top 10% van de omzet over 30 dagen), declining_trend (daling ≥ 20% over 6 maanden).
• Beeldkwaliteitsaudit: in batches van 25 detecteert de AI-vision (Claude Vision of GPT-4o, Mistral wordt niet ondersteund) watermerken, promotieteksten, achtergrondtype en meerdere producten. Cijfer 0-10 per afbeelding, cache 30 dagen.
• Export naar Google Ads Editor: direct importeerbare CSV, met advertentiegroepen gerangschikt op custom labels en biedvermenigvuldigers per tag (bestseller ×1,5, upcoming_season ×1,3, on_sale ×1,2, declining_trend ×0,5).

Automatisering via cron

Elke feed heeft een generatie-URL die door een token is beveiligd en in de feedlijst wordt getoond. Voorbeeld van een crontab om elke 6 uur opnieuw te genereren:

0 */6 * * * curl -s "https://uwwinkel.com/module/dfexportgoogleshopping/cron?token=UW_TOKEN&id_feed=1" > /dev/null

De generatie werkt in streaming: catalogi met meer dan 100.000 producten gaan erdoor zonder het geheugen te verzadigen.

Probleemoplossing

• De feed is leeg: controleer de filters van de feed (categorieën, voorraad) en of de producten actief en zichtbaar zijn in de aan de feed gekoppelde winkel.
• Producten uitgesloten bij de generatie: raadpleeg het tabblad Diagnose, elke uitsluiting wordt gemotiveerd (ongeldige GTIN, ontbrekende afbeelding, prijs nul, enzovoort). Gebruik het XML-voorbeeld voor het detail van een specifiek product.
• Fout bij een AI-aanroep: controleer de API-sleutel en het model in Instellingen. Het logboek dfgs_ai_log registreert de mislukkingen met hun oorzaak.
• De beeldaudit mislukt met Mistral: dat is verwacht, vision vereist Anthropic of OpenAI.
• Na een PrestaShop-update verschijnt een tabblad niet meer: reset de module (Modules → dfexportgoogleshopping → Resetten) om de beheertabbladen opnieuw aan te maken zonder uw gegevens te verliezen.

De-installatie

De de-installatie verwijdert de 12 dfgs_-tabellen, de beheertabbladen en de DFGS_-configuratiewaarden. Exporteer vooraf uw overrides en mappings naar CSV als u ze wilt bewaren.