# 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,… - Pagina: - Taal: nl - Bijgewerkt op: 2026-08-27 - Andere talen: [fr](https://www.datafirefly.com/documentation/dfexportgoogleshopping/index.md), [en](https://www.datafirefly.com/en/documentation/dfexportgoogleshopping/index.md), [es](https://www.datafirefly.com/es/documentation/dfexportgoogleshopping/index.md), [de](https://www.datafirefly.com/de/documentation/dfexportgoogleshopping/index.md), [it](https://www.datafirefly.com/it/documentation/dfexportgoogleshopping/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfexportgoogleshopping/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfexportgoogleshopping/index.md) - Index: ## 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. Eén feed per land/taalcombinatie is de juiste granulariteit: een NL-feed voor Nederland, een FR-feed voor Frankrijk, een DE-feed voor Duitsland, elk met zijn eigen valuta. ## 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. Alle AI-functies zijn optioneel. Zonder API-sleutel blijft de module een volwaardige Google Shopping-exporteur. ## 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.