Feedgeneratie (per Store View)

Elke store view heeft zijn eigen OpenAI Commerce-feed. Je kunt de feedgeneratie per store view in- of uitschakelen en optioneel de bestandsnaam aanpassen. De feed wordt gegenereerd in JSON-formaat volgens de OpenAI Commerce-specificatie.

In deze sectie beheer je de ChatGPT/OpenAI Commerce productfeed afzonderlijk voor elke Magento 2 store view. Gebruik dit gedeelte om feeds aan of uit te zetten, de uitvoerbestandsnaam te kiezen en een feed handmatig te genereren voor een specifieke store view.

Inschakelen

• Ja/Nee: Schakel de feedgeneratie in of uit voor de geselecteerde Store View.
• Wanneer uitgeschakeld, wordt er geen feedbestand aangemaakt voor deze store view en zijn handmatige runs geblokkeerd.

Bestandsnaam

• Stel de JSON-bestandsnaam in voor deze store view, bijvoorbeeld openai-commerce-feed.json of openai-commerce-feed-en.json.
• Gebruik een unieke bestandsnaam per store view om te voorkomen dat bestanden worden overschreven wanneer meerdere weergaven naar dezelfde map publiceren.

Feedtabel

De tabel toont alle store views en hun huidige feedbestand.

• StoreView: De Magento store view waartoe de feed behoort.
• Feedbestand:
  • Bestandslink: Opent de huidige JSON-feed in een nieuw tabblad voor snelle controle.
  • Kopieer bestandslocatie: Kopieert de absolute URL om te delen met je integraties.
• Actie + Uitvoeren:
  • Kies een actie in de dropdown (bijv. Genereren) en klik vervolgens op Uitvoeren om deze actie alleen voor die store view uit te voeren.
  • Gebruik dit wanneer je productgegevens, prijzen of attributen hebt aangepast en direct een vernieuwde feed wilt genereren.

Typische Gebruiksscenario’s

• Meertalige winkels: Schakel een aparte feed in per taal (bijv. Engels, Nederlands) zodat ChatGPT taalspecifieke content kan gebruiken.
• Staging versus productie: Schakel feeds uit op staging store views om te voorkomen dat testdata door externe systemen wordt geïndexeerd.
• Bestandsnaamstrategie: Voeg de storecode toe aan de bestandsnaam, bijvoorbeeld openai-commerce-feed-nl.json, voor duidelijkheid.

Best Practices

• Controleer de JSON-uitvoer na de eerste run om te bevestigen dat deze voldoet aan de OpenAI Commerce-specificatie.
• Houd feed-URL’s stabiel; het wijzigen van bestandsnamen kan updates vereisen in gekoppelde integraties.
• Na het in- of uitschakelen of hernoemen van een feed, leeg de Magento-cache als je omgeving agressieve caching gebruikt.

Probleemoplossing

• Feed wordt niet bijgewerkt: Klik op Actie → Genereren en vervolgens op Uitvoeren. Als de feed nog steeds oude data toont, leeg dan de volledige paginacache/CDN en probeer opnieuw.
• 404 op feed-URL: Controleer of de store view is ingeschakeld en of de bestandsnaam overeenkomt met wat in de tabel wordt weergegeven. Controleer ook de bestandsrechten van de doelmap.
• Ongeldige JSON: Open het bestand via de link en valideer het met een JSON-linter. Controleer op aangepaste attributen die onverwachte datatypes kunnen opleveren.
• Verkeerde taal/prijzen: Zorg dat je de feed hebt uitgevoerd voor de juiste Store View en dat de store view-specifieke instellingen (valuta, taal, btw-weergave) correct zijn ingesteld.

Verkoperconfiguratie

In de sectie Verkoperconfiguratie stel je de basisgegevens van de verkoper in die worden opgenomen in de ChatGPT/OpenAI Commerce Product Feed. Hiermee wordt jouw webshop correct geïdentificeerd en worden belangrijke beleidslinks toegevoegd voor transparantie en naleving.

Verkopersnaam

• Voer de naam van je bedrijf of webshop in zoals deze aan gebruikers wordt getoond (bijv. Magmodules BV).
• Dit veld is verplicht en verschijnt in de productfeed als verkopersnaam.

Privacybeleid

• Selecteer de CMS-pagina met het privacybeleid van jouw webshop.
• Deze link helpt ChatGPT en andere AI-systemen om jouw privacy- en gegevensbeschermingsbeleid te begrijpen.

Algemene Voorwaarden

• Selecteer de CMS-pagina met jouw algemene voorwaarden of klantenservicebeleid.
• Dit bepaalt onder welke voorwaarden aankopen worden gedaan en hoe klanten contact met je opnemen.

Retourbeleid

• Optioneel kun je een CMS-pagina selecteren met jouw retourbeleid.
• Zo wordt duidelijk gecommuniceerd hoe retouren en terugbetalingen worden afgehandeld.

Retourtermijn (dagen)

• Voer het aantal dagen in waarbinnen klanten producten mogen retourneren (bijv. 30).
• Deze waarde wordt opgenomen in de feed zodat AI-systemen jouw retourperiode begrijpen.

Best Practices

• Zorg dat alle geselecteerde CMS-pagina’s openbaar en toegankelijk zijn.
• Gebruik consistente beleidslinks in alle store views om foutieve verwijzingen te voorkomen.
• Controleer regelmatig of je privacy- en retourbeleid up-to-date zijn en voldoen aan de AVG- en consumentenwetgeving.

Probleemoplossing

• Verkopersnaam ontbreekt: Vul een geldige naam in; dit veld is verplicht.
• Beleidslink werkt niet: Controleer of de geselecteerde CMS-pagina actief is en zichtbaar op de frontend.
• Onjuiste retourtermijn: Zorg dat de waarde in “Retourtermijn” overeenkomt met je daadwerkelijke beleid.

Configuratie van Productattributen

In de sectie Productnaam & Beschrijving bepaal je welke Magento-attributen worden gebruikt voor de ChatGPT/OpenAI Commerce Product Feed. Deze instellingen bepalen hoe producten worden weergegeven wanneer ChatGPT of andere AI-systemen jouw feed gebruiken voor productontdekking en aanbevelingen.

Productidentificatie

• ID (SKU): De unieke productidentifier. Het aanbevolen veld is SKU. Dit zorgt ervoor dat elk product uniek en traceerbaar is.
• Titel: Selecteer het Magento-attribuut dat wordt gebruikt als producttitel (standaard: Productnaam).
• Beschrijving: Kies het attribuut dat de productbeschrijving bevat. Deze tekst helpt AI-systemen de kenmerken en voordelen van je product te begrijpen.

Afbeeldingen & Video’s

• Bron: Kies of je alle afbeeldingen wilt opnemen of slechts een subset (bijv. basisafbeelding).
• Hoofdafbeelding: Bepaalt welke afbeelding als primaire afbeelding in de feed wordt gebruikt (standaard: Eerste afbeelding).
• Verborgen afbeeldingen opnemen: Stel in op Ja om ook galerijafbeeldingen op te nemen die niet zichtbaar zijn op de frontend.

Identificatoren

• GTIN: Selecteer het attribuut dat het Global Trade Item Number bevat (bijv. SKU of EAN).
• Merk: Meestal gekoppeld aan Manufacturer of een specifiek merkattribuut.
• MPN: Het onderdeelnummer van de fabrikant. Vaak gelijk aan de SKU als dit niet apart is ingesteld.

Productconditie

• Bron: Kies tussen Statische waarden of een productattribuut dat de conditie aangeeft.
• Standaardwaarde: Stel de standaardproductconditie in — ondersteunde waarden zijn Nieuw, Gereviseerd en Gebruikt.

Categorie

• Categorie opnemen: Stel in op Ja om de categorienaam van het product in de feed op te nemen. Dit helpt ChatGPT producten beter te groeperen op type.

Best Practices

• Gebruik duidelijke, SEO-vriendelijke productnamen en beschrijvingen.
• Zorg dat elke SKU uniek is om fouten in de feed te voorkomen.
• Gebruik kwalitatieve productafbeeldingen die via HTTPS bereikbaar zijn.
• Gebruik consistente merk- en GTIN-gegevens voor een betere AI-match.

Probleemoplossing

• Product ontbreekt in feed: Controleer of de SKU correct is toegewezen bij ID en of het product actief en zichtbaar is in de catalogus.
• Afbeelding werkt niet: Controleer of de afbeelding in de mediamap staat en of Verborgen afbeeldingen opnemen juist is ingesteld.
• Verkeerde productconditie: Zorg dat de conditie-instelling overeenkomt met een ondersteunde waarde: Nieuw, Gereviseerd of Gebruikt.

Configuratie van Configureerbare, Bundel- en Gegroepeerde Producten

In deze sectie bepaal je hoe configureerbare, bundel- en gegroepeerde producten worden geëxporteerd naar de ChatGPT/OpenAI Commerce Product Feed. Deze instellingen zorgen ervoor dat complexe productstructuren correct en efficiënt worden weergegeven voor AI-gebaseerde productaanbevelingen.

Configureerbare Producten

Voor configureerbare producten raden we aan om alleen de gekoppelde simpele producten op te nemen in de feed. Zo worden prijzen, afbeeldingen en voorraad per variatie correct weergegeven.

• Gebruik Configureerbare/Simple Producten: Kies Only Linked Simple Products (Recommended) om alleen de child-producten te exporteren en niet het hoofdproduct.
• Gebruik Parent-URL voor Simples: Stel in op Ja (aanbevolen). De URL’s van simpele producten worden dan automatisch gelinkt aan de configuratiepagina van het hoofdproduct.
• Gebruik Parent-afbeelding voor Simples: Kies Alleen indien leeg (aanbevolen). Zo wordt de afbeelding van het hoofdproduct gebruikt als de simpele variant geen eigen afbeelding heeft.
• Gebruik Parent-data voor Simples: Selecteer de attributen (bijv. Titel, Beschrijving, Merk) die van het hoofdproduct mogen worden overgenomen. Vermijd unieke velden zoals GTIN of Kleur.
• Gebruik Fallback alleen voor niet-zichtbare Simples: Stel in op Ja. Zo wordt de fallback-logica alleen toegepast op producten die “Niet individueel zichtbaar” zijn.

Bundelproducten

• Gebruik Bundelproducten: Kies Only Bundle Product (Recommended). Alleen het hoofd-bundelproduct wordt geëxporteerd, niet de individuele onderdelen.
• Prijs van hoofdproduct: Selecteer Minimumprijs (aanbevolen) zodat de laagste mogelijke bundelprijs wordt weergegeven in de feed.

Gegroepeerde Producten

• Gebruik Gegroepeerde Producten: Kies Only Grouped Product (Recommended) om alleen het hoofdproduct te exporteren.
• Prijs van hoofdproduct: Selecteer Minimumprijs (aanbevolen) om de laagste prijs binnen de groep te tonen.

Best Practices

• Voor configureerbare producten is het beter om elk simpel product afzonderlijk op te nemen voor maximale nauwkeurigheid.
• Zorg dat titel en beschrijving van het hoofdproduct goed zijn geoptimaliseerd, omdat child-producten deze kunnen overnemen.
• Voorkom dubbele producten door niet zowel het hoofd- als het child-product in dezelfde feed op te nemen.
• Controleer of alle gekoppelde producten zichtbaar en correct gelinkt zijn in Magento voordat je de feed genereert.

Probleemoplossing

• Dubbele producten in feed: Controleer of niet zowel het hoofd- als het child-product is opgenomen.
• Afbeeldingen ontbreken: Schakel Gebruik Parent-afbeelding voor Simples in op “Alleen indien leeg”.
• Onjuiste productlinks: Controleer of Gebruik Parent-URL voor Simples is ingesteld op “Ja” om correcte navigatie te behouden.

Aanvullende Configuratie

De sectie Aanvullende Configuratie biedt extra instellingen voor hoe productdetails, verzendinformatie en analysecodes worden opgenomen in de ChatGPT/OpenAI Commerce Product Feed. Hiermee kun je jouw feed verder optimaliseren voor tracking, productgroepering en AI-interpretatie.

Extra Opties

• Productbeoordelingen opnemen: Stel in op Ja om klantbeoordelingen en sterrenratings in de feed op te nemen. Dit verhoogt de betrouwbaarheid en relevantie van producten in AI-resultaten.
• Item Group ID opnemen: Activeert een gedeelde ID voor gegroepeerde of configureerbare producten. Zo kan ChatGPT varianten beter met elkaar verbinden.

Extra Velden

Je kunt eigen velden toevoegen aan de feed om extra productinformatie of metadata mee te sturen.

• Klik op Add om een nieuw veld toe te voegen.
• Vul een veldnaam in (bijv. “materiaal_type”) en koppel het aan een Magento-attribuut.
• Zorg dat toegevoegde velden voldoen aan de OpenAI Commerce JSON-standaard om fouten te voorkomen.

Verzendinstellingen

Voeg specifieke verzendkosten toe die direct in de productfeed worden opgenomen.

• Land: Selecteer het land waarvoor het tarief geldt.
• Service: Voeg een label of vervoerder toe (bijv. “Standaard verzending”).
• Van/Tot prijs: Stel de prijsklasse in waarvoor het tarief van toepassing is.
• Verzendkosten: Voer het bedrag in dat in de feed wordt weergegeven.
• Klik op Add om meerdere verzendregels aan te maken voor verschillende regio’s of prijscategorieën.

Google Analytics Tracking

Gebruik je Google Analytics of andere trackingtools? Voeg dan een UTM-code toe aan de feed-URL. Hiermee kun je verkeer en conversies meten die afkomstig zijn van AI-gegenereerde productvermeldingen.

• UTM-code: Voorbeeld: utm_source=openai&utm_medium=feed&utm_campaign=product
• Zorg dat de UTM-tags aansluiten bij je bestaande analysecampagnes voor correcte rapportage.

Gewicht

Neem het productgewicht op in de feed om AI-systemen te helpen bij logistieke berekeningen.

• Gewicht opnemen: Stel in op Ja om het gewicht van het product mee te exporteren.
• Handig voor AI-integraties met verzendtarieven of fulfilmentprocessen.

Best Practices

• Voeg alleen productbeoordelingen toe als deze betrouwbaar en consequent zijn.
• Controleer of extra velden correct zijn gekoppeld aan bestaande attributen in Magento.
• Stem verzendkosten af op je daadwerkelijke checkout-tarieven.
• Gebruik UTM-codes om verkeer vanuit ChatGPT en OpenAI te kunnen analyseren.

Probleemoplossing

• Feedvalidatie mislukt: Controleer of aangepaste velden geldige JSON-namen gebruiken.
• Verzendgegevens ontbreken: Controleer of ten minste één verzendregel is ingesteld en actief is.
• Analytics werkt niet: Controleer of de UTM-parameters juist zijn opgemaakt en Analytics actief is.

Filteropties

Met de Filteropties kun je bepalen welke producten worden opgenomen in de ChatGPT/OpenAI Commerce Product Feed. Deze filters zorgen ervoor dat alleen relevante, actieve en zichtbare producten worden geëxporteerd, wat de kwaliteit en prestaties van de feed verbetert.

Filter op Zichtbaarheid

• Inschakelen: Stel in op Ja om alleen producten met een specifieke zichtbaarheid op te nemen (bijv. “Catalogus”, “Zoeken” of beide).
• Standaard worden alle zichtbare producten opgenomen. Door deze filter in te schakelen, kun je preciezer bepalen welke producten in de feed verschijnen.

Filter op Status

• Uitgeschakelde producten toevoegen: Standaard worden alleen ingeschakelde producten geëxporteerd. Stel in op Ja om ook uitgeschakelde producten mee te nemen (niet aanbevolen).
• Deze instelling zorgt ervoor dat alleen actieve, verkoopbare producten in de feed worden opgenomen.

Filter op Categorie

• Inschakelen: Stel in op Ja om de feed te beperken tot specifieke productcategorieën.
• Handig als je aparte feeds wilt genereren per categorie, bijvoorbeeld alleen “Elektronica” of “Accessoires”.

Uit Voorraad Uitsluiten

• Inschakelen: Stel in op Ja om producten die niet op voorraad zijn automatisch uit te sluiten.
• Voorkomt dat niet-beschikbare producten worden weergegeven in ChatGPT-aanbevelingen of AI-lijsten.

Geavanceerde Filters

• Inschakelen: Activeer deze optie om gebruik te maken van geavanceerde filterlogica.
• Hiermee kun je complexe regels maken op basis van attributen, voorwaarden en logica (bijv. alleen producten boven een bepaalde prijs opnemen).
• Aanbevolen voor ontwikkelaars die meer controle willen over de inhoud van de feed.

Best Practices

• Laat “Uit Voorraad Uitsluiten” aan staan om ervoor te zorgen dat je feed alleen verkoopbare producten bevat.
• Voeg uitgeschakelde of verborgen producten alleen toe voor testdoeleinden.
• Gebruik categorie-filters als je meerdere feeds wilt maken voor verschillende markten of campagnes.
• Test geavanceerde filters zorgvuldig voordat je live gaat om dataverlies te voorkomen.

Probleemoplossing

• Producten ontbreken in feed: Controleer of zichtbaarheid-, categorie- of voorraadfilters te streng zijn ingesteld.
• Verborgen producten verschijnen toch: Controleer of Filter op Zichtbaarheid is ingeschakeld en juist is ingesteld.
• Geavanceerde filter werkt niet: Leeg de Magento-cache en genereer de feed opnieuw na aanpassingen.

Cron Configuratie

Met de Cron-instellingen kun je de generatie van de ChatGPT/OpenAI Commerce Product Feed automatiseren. Zo blijft je feed altijd up-to-date met de nieuwste productgegevens, prijzen en voorraad – zonder handmatig werk.

Wat is een Cronjob?

Een Cronjob is een geplande achtergrondtaak die automatisch op vaste tijden wordt uitgevoerd. In Magento worden cronjobs gebruikt voor belangrijke processen zoals indexatie, e-mails en feedgeneratie.

De ChatGPT Product Feed plugin gebruikt een cronjob om de productfeed automatisch te vernieuwen volgens het ingestelde schema. Zo ontvangen ChatGPT en andere AI-systemen altijd actuele productinformatie uit je webshop.

Inschakelen

• Ja: Schakelt automatische feedgeneratie in volgens het onderstaande schema.
• Nee: Schakelt de automatische generatie uit. Je kunt de feed nog wel handmatig uitvoeren via het admin-paneel.

Frequentie

• Bepaalt hoe vaak de feed automatisch wordt gegenereerd.
• Mogelijke opties:
  • Elk uur – Aanbevolen voor winkels met snel wisselende voorraad of prijzen.
  • Dagelijks om 0:00 – De standaardinstelling, geschikt voor de meeste webshops.
  • Wekelijks – Geschikt voor catalogi die zelden wijzigen.

Belangrijke Opmerkingen

• Zorg dat de standaard Magento Cron correct is ingesteld en actief draait op je server.
• Werkt de cronjob niet? Neem contact op met je hostingprovider of ontwikkelaar om je cronconfiguratie te controleren.
• Je kunt handmatig testen of cron goed werkt met:

  php bin/magento cron:run

Best Practices

• Plan de feed op rustige uren (bijv. middernacht) om de serverbelasting te minimaliseren.
• Gebruik logbestanden of monitoringtools om te controleren of cron succesvol draait.
• Bij grote feeds is dagelijks plannen met caching het meest efficiënt.

Probleemoplossing

• Feed wordt niet automatisch vernieuwd: Controleer of Magento’s cron actief is en er geen fouten staan in var/log/cron.log.
• Dubbele feeds: Controleer of er niet meerdere cron-taken voor dezelfde feed zijn ingesteld.
• Feedgeneratie mislukt: Voer php bin/magento cron:run handmatig uit en controleer de schrijfrechten van de feedmap.

Uitleg van het Feedgeneratie-overzicht in de OpenAI Plugin

De pagina Feedgeneratie-overzicht in de Magento 2 OpenAI Plugin geeft een duidelijk overzicht van alle gegenereerde feeds per storeview. Hiermee kun je eenvoudig bijhouden wanneer feeds zijn aangemaakt, hoeveel producten ze bevatten en of dit handmatig of automatisch is gebeurd.

Waarom dit overzicht belangrijk is

• Snel controleren of feeds succesvol zijn gegenereerd per storeview.
• Inzien hoeveel producten in elke feed zijn opgenomen.
• Zien of feeds handmatig of via de command line (cron) zijn aangemaakt.
• Monitoren van de generatie-tijd en datum van elke feedrun.

Uitleg van de kolommen

• ID: Uniek nummer voor elke feed.
• Storeview: Toont voor welke Magento storeview de feed is aangemaakt.
• Resultaat: Laat zien hoeveel producten zijn opgenomen, hoe lang de generatie duurde en op welk moment dit gebeurde.
• Gegenereerd door: Geeft aan of de feed handmatig via de admin of automatisch via de command line is aangemaakt.
• Aangemaakt op: Datum en tijdstip van generatie.
• Actie: Optie om details te bekijken of de feed te downloaden (JSON-output).

Gebruik van de knop ‘Generate Feeds’

Gebruik de knop Generate Feeds rechtsboven om handmatig feeds te genereren voor alle ingeschakelde storeviews. Dit is handig voor tests of na updates aan productdata.

Best practices

• Gebruik handmatige generatie om configuraties of feedformaten te testen.
• Plan cron-generatie in voor dagelijkse of uurlijkse updates.
• Controleer regelmatig de generatietijden en resultaten voor datakwaliteit.

Probleemoplossing

Feed verschijnt niet?

Controleer of feedgeneratie is ingeschakeld onder Stores > Configuration > Magmodules > OpenAI Feed.

Producten ontbreken?

Controleer productzichtbaarheid en attributen. Uitgeschakelde of onvolledige producten worden overgeslagen.