XML Feed en Merchant API Samen Gebruiken in Magento 2

De Offer ID is de unieke identifier die je Magento-producten koppelt aan Google Merchant Center listings. Het is de sleutel waarmee zowel Feed als API hetzelfde product kunnen updaten.

Formaat in Magento: Meestal je product-SKU of entity ID Voorbeeld: ABC-12345 of 24-MB01

Wanneer je productdata naar Google stuurt (via Feed of API), vertelt de Offer ID aan Google: "Dit is product ABC-12345, update de gegevens."

Voorbeeld: Product met SKU "ABC-12345"

1. XML Feed stuurt productdata met offerId: ABC-12345
2. API Module stuurt productdata met offerId: ABC-12345
3. Google ziet dezelfde Offer ID en update hetzelfde product

Beide methoden updaten hetzelfde product in Google omdat ze dezelfde Offer ID gebruiken.

Belangrijk: De Offer ID geconfigureerd in de Feed-module moet overeenkomen met de Offer ID die de API-module gebruikt. Standaard gebruiken beide dezelfde bron (geconfigureerd in Feed-module instellingen), dus dit gebeurt automatisch.

• Type: Scheduled fetch of SFTP-upload
• Bevat: Complete productcatalogus
• Updates: Op je geconfigureerde schema

• Type: Merchant API
• Bevat: Individuele productupdates
• Updates: Real-time wanneer producten wijzigen

Google kan data van meerdere bronnen combineren voor hetzelfde product:

1. Primaire bron levert de basis productdata
2. Aanvullende bronnen kunnen specifieke velden toevoegen of overschrijven

Bij gebruik van Feed + API samen heb je twee opties:

Optie A: Gescheiden Gegevensbronnen (Aanbevolen)

• Feed upload naar Bestand gegevensbron
• API update naar Merchant API gegevensbron
• Google merged beide, met meest recente data als prioriteit

Optie B: API als Primair

• API-module handelt alle productdata af
• Feed dient alleen als backup/verificatie

1. Behoud je bestaande Feed-setup (SFTP of scheduled fetch)

   • Draait dagelijks of per uur
   • Zorgt dat complete catalogus altijd in Google staat

2. Voeg de API-module toe voor real-time updates

   • Pusht wijzigingen direct wanneer producten worden opgeslagen
   • Handelt prijs- en voorraad-updates af tussen feed-runs

1. Feed Module

   • Attribuut mapping geconfigureerd
   • Offer ID veld ingesteld (meestal SKU)
   • SFTP of scheduled fetch actief

2. API Module

   • Zelfde store view als Feed
   • Merchant API gegevensbron aangemaakt
   • Auto Sync ingeschakeld

3. Verifieer Offer ID Match

   • Het "id" veld in Feed-module instellingen
   • Moet overeenkomen met wat API-module stuurt als offerId
   • Controleer een gesynchroniseerd product in beide

De Offer ID wordt geconfigureerd in de Feed-module onder attribuut mapping:

Winkels > Configuratie > Magmodules > Google Shopping - Feed > Attribuut Mapping

Zoek naar de id veld mapping. Veelvoorkomende opties:

• SKU (aanbevolen) - Uniek, leesbaar
• Entity ID - Magento's interne ID (numeriek)
• Custom attribuut - Als je een specifieke identifier hebt

1. Gebruik SKU als je SKU's uniek en stabiel zijn
2. Wijzig nooit de Offer ID van bestaande producten - Google ziet het als een nieuw product
3. Houd het consistent over alle stores/feeds voor hetzelfde product
4. Alleen alfanumerieke tekens - vermijd speciale tekens

Als Feed offerId: SKU123 stuurt en API offerId: 456:

• Google ziet deze als twee verschillende producten
• Je krijgt duplicaten in Merchant Center
• Wijzigingen via API beïnvloeden het Feed-product niet

Wanneer zowel Feed als API data sturen voor hetzelfde product, gebruikt Google de meest recente data voor elk veld.

Voorbeeldscenario:

1. 08:00 - Feed draait, stuurt prijs: €50
2. 10:00 - Je wijzigt prijs naar €45 in Magento
3. 10:01 - API stuurt prijs: €45
4. Google toont nu: €45 (meest recent)

Als Feed en API verschillende prijzen tonen:

1. Controleer timestamp van laatste Feed-run
2. Controleer API sync status voor het product
3. De meest recente update zou in Google moeten staan

Als een product in Feed zit maar niet synchroniseert via API:

1. Controleer of product door Feed-module filters komt
2. Controleer API-module product grid op fouten
3. Verifieer dat product geïnitialiseerd is in API-module

Als je duplicaten ziet in Merchant Center:

1. Controleer Offer ID in Feed export
2. Controleer Offer ID in API sync log
3. Zorg dat beide dezelfde identifier gebruiken

• Controleer gegenereerde XML op correcte Offer IDs
• Monitor SFTP upload logs
• Bekijk Merchant Center verwerkingsrapporten

• Controleer Products grid op sync status
• Verifieer dat Offer ID matcht met Feed
• Monitor foutpercentages

• Producten > Diagnostiek voor problemen
• Controleer "Gegevensbronnen" voor laatste update tijden
• Verifieer dat productaantal overeenkomt met verwachtingen

Ja, als je beide modules gebruikt. Elke module heeft zijn eigen gegevensbron-type nodig in Merchant Center.

Nee. Google Shopping kosten zijn gebaseerd op klikken, niet op hoe vaak je productdata upload.

Technisch ja, maar niet aanbevolen. De Feed dient als vangnet om te zorgen dat alle producten in Google blijven, zelfs als API sync problemen heeft.

De API-module ondersteunt inventory-only sync. Volledige productdata komt van Feed, real-time prijs/voorraad van API.

1. Noteer de SKU van een product in Magento
2. Vind het in Feed XML export - controleer de <g:id> waarde
3. Vind het in API sync log - controleer de offerId
4. Vind het in Merchant Center - controleer de Offer ID
5. Alle drie moeten overeenkomen