Magento 2 Google Shopping Merchant API Sync Uitgelegd

1. Magento genereert een XML-bestand met alle productgegevens
2. De feed wordt geleverd aan Google via scheduled fetch (URL) of SFTP-upload
3. Batch-gebaseerd: De volledige catalogus wordt elke keer verzonden

Ideaal voor: Webshops met stabiele prijzen en voorraad die updaten op een voorspelbaar schema (dagelijks, per uur). Eenvoudige setup, betrouwbaar, en werkt prima voor de meeste merchants.

1. Productwijzigingen in Magento triggeren automatisch een sync
2. Updates worden direct naar Google gestuurd via de Merchant API
3. Event-driven: Alleen gewijzigde producten worden gesynchroniseerd

Ideaal voor: Webshops met frequente prijswijzigingen, dynamische voorraad, of real-time stock vanuit ERP/PIM-systemen. Houdt Google in sync zonder te wachten op de volgende geplande feed.

Deze module is een add-on voor de Feed-module, geen vervanging. Veel webshops profiteren van het gebruik van beide:

• XML Feed: Zorgt dat Google altijd een complete, up-to-date baseline heeft van alle producten
• API Sync: Pusht kritieke wijzigingen (prijs, voorraad) direct naar Google

Deze combinatie geeft je de betrouwbaarheid van geplande feeds plus de snelheid van real-time updates.

1. Product opgeslagen in Magento - Je update een product in admin of via import
2. Gemarkeerd voor sync - De indexer markeert het product als "needs update"
3. Toegevoegd aan queue - Een cron-job pakt gemarkeerde producten op en voegt ze toe aan de queue
4. Gesynchroniseerd naar Google - De queue consumer stuurt de data naar Google Merchant API
5. Zichtbaar in Google Shopping - Wijzigingen verschijnen binnen enkele minuten in Google

Wanneer je een product opslaat in Magento (of voorraad update via import), markeert de extensie het automatisch voor synchronisatie. Dit gebeurt via Magento's indexer-systeem - dezelfde technologie die je categoriepagina's en zoekresultaten bijwerkt.

Wat triggert een sync:

• Product opslaan (admin of API)
• Voorraadwijziging
• Prijsupdate
• Elke attribuutwijziging die de feed beïnvloedt

Wat triggert geen sync:

• Producten niet in je feed (uitgefilterd op categorie, attribuut, etc.)
• Uitgeschakelde producten
• Niet-op-voorraad producten (indien geconfigureerd om uit te sluiten)

De extensie synchroniseert niet direct wanneer je een product opslaat. In plaats daarvan gebruikt het Magento's message queue systeem:

1. Cron-job draait elke paar minuten - Pakt gemarkeerde producten op
2. Producten toegevoegd aan queue - Gegroepeerd in batches voor efficiëntie
3. Queue consumer verwerkt - Stuurt data naar Google

Waarom een queue?

• Voorkomt timeout-problemen tijdens bulk imports
• Handelt rate limits netjes af
• Maakt retries bij fouten mogelijk
• Vertraagt je admin panel niet

Voordat data naar Google wordt gestuurd, vergelijkt de extensie je huidige productdata met wat eerder is gesynchroniseerd:

1. Haalt verse productdata op uit Magento
2. Berekent een "vingerafdruk" (hash) van de data
3. Vergelijkt met de opgeslagen vingerafdruk
4. Synchroniseert alleen als er daadwerkelijk iets is gewijzigd

Waarom dit belangrijk is:

• Bespaart API-quota - geen onnodige calls naar Google
• Snellere verwerking - slaat ongewijzigde producten over
• Accurate tracking - je weet precies wat gesynchroniseerd is

Wanneer een product gesynchroniseerd moet worden:

1. Transformeert Magento-data naar Google's formaat
2. Stuurt een update-verzoek naar de Merchant API
3. Registreert het antwoord (succes of fout)
4. Update de productstatus in het grid

Update alle productattributen: titel, beschrijving, prijs, afbeeldingen, verzending, etc.

Gebruikt wanneer:

• Product wordt voor het eerst toegevoegd
• Elke niet-voorraad attribuutwijziging
• Handmatige sync vanuit admin grid

Update alleen prijs en beschikbaarheid - sneller en met hogere API-limieten.

Gebruikt wanneer:

• Alleen prijs wijzigt
• Alleen voorraad wijzigt
• Geplande voorraad-refresh

Onder normale omstandigheden:

• Indexer markeert product: Direct (bij opslaan)
• Cron pakt op: Binnen 5 minuten
• Queue verwerkt: Binnen 1-2 minuten
• Google reflecteert wijziging: Binnen 5-30 minuten

Totaal: Meestal binnen 15 minuten

• Grote queue-achterstand (bulk imports)
• Google API rate limits
• Cron draait niet
• Queue consumers draaien niet

• Attribuut mapping (welke Magento-attributen mappen naar Google-velden)
• Productfilters (welke producten in/uitsluiten)
• Categorie mapping
• Statische waarden (merk, conditie, etc.)

• Google Cloud credentials (Service Account)
• Merchant ID en Data Source
• Sync intervallen en batch sizes
• Fout-retry instellingen

Wanneer een sync faalt:

1. Logt de fout met details
2. Houdt het product in "Error" status
3. Probeert opnieuw na een configureerbaar interval (standaard: 4 uur)

Vanuit het admin grid kun je:

• Foutdetails bekijken - Klik op de status om de volledige fout te zien
• Enkel product opnieuw proberen - Gebruik de "Sync" actie
• Meerdere producten opnieuw proberen - Selecteer producten en gebruik mass action

Marketing > Google Shopping API > Products

Toont alle producten met hun sync status, laatste sync tijd, en eventuele fouten.

# Controleer algemene sync status
bin/magento googleshopping:api:status --store=1

# Handmatig specifieke producten synchroniseren
bin/magento googleshopping:api:sync --store=1 --product-ids=1,2,3

# Test verbinding
bin/magento googleshopping:api:test-connection --store=1

Debug logging (indien ingeschakeld) schrijft naar:

var/log/googleshopping_api.log

1. Configureer eerst de Feed module (attribuut mapping, filters)
2. Stel API module credentials in
3. Test de verbinding
4. Gebruik "Initialize Products" om de sync-tabel te vullen
5. Monitor de eerste batch op fouten

• Houd cron betrouwbaar draaiend
• Monitor het Products grid op fouten
• Controleer Google Merchant Center op afkeuringen
• Bekijk logs periodiek

Voor webshops met 10.000+ producten:

• Verhoog batch size (tot 1000)
• Zorg dat queue consumers draaien
• Overweeg dedicated cron voor queue verwerking
• Initiële sync kan enkele uren duren

1. Controleer of cron draait: bin/magento cron:run
2. Controleer of product in feed zit: Bekijk Feed module preview
3. Controleer productstatus in grid: Zoek naar fouten
4. Controleer queue: bin/magento queue:consumers:list

1. Verifieer dat product "Synced" status toont
2. Controleer laatste sync tijd in grid
3. Wacht 15-30 minuten tot Google verwerkt
4. Controleer Merchant Center op productafkeuringen

1. Bekijk foutmeldingen in grid
2. Controleer attribuut mapping in Feed module
3. Verifieer dat alle verplichte velden gemapt zijn
4. Test eerst met een enkel product