Google Merchant Center

Met deze koppeling stuurt Nexym de producten van een Google-kanaal in Feed Manager rechtstreeks naar Merchant Center, via de Merchant API. Google hoeft dan geen feed op te halen. De koppeling is alleen het transport: de veldmapping, de regels en de uitsluitingen blijven in het kanaal. De koppeling is er alleen als Feed Manager aan staat. Zet je Feed Manager uit, dan wordt de koppeling inactief en verstuurt ze niets meer.

Wat je nodig hebt

• Een Merchant Center-account en het account-ID (het nummer bovenin Merchant Center).
• Een serviceaccount in Google Cloud met de Merchant API aangezet, en de JSON-sleutel van dat serviceaccount.

1Serviceaccount aanmaken

1. Maak in de Google Cloud Console een project, of kies een bestaand project, en zet onder APIs & Services de Merchant API aan.
2. Maak onder IAM & Admin → Service accounts een serviceaccount aan.
3. Kies bij het serviceaccount Keys → Add key → JSON en bewaar het bestand.
4. Ga in Merchant Center naar Instellingen → Personen en toegang en voeg het e-mailadres van het serviceaccount toe als gebruiker. Standaardtoegang is genoeg om producten te sturen. Wil je een testaccount laten aanmaken (zie hieronder), geef het dan Beheerderstoegang.

2Koppeling toevoegen

+ Koppeling toevoegen → Google Merchant Center. Op het tabblad Instellingen:

Veld	Voorbeeld
Merchant Center-account-ID	123456789
Serviceaccountsleutel (JSON)	met Bestand kiezen… lees je het sleutelbestand in
Feedlabel	NL
Contenttaal	nl
Doelland	NL
ID gegevensbron	leeg laten: Nexym zoekt of maakt er een bij de eerste run

Druk op Koppeling testen. Lukt dat niet, controleer dan of het serviceaccount als gebruiker in Merchant Center staat. De sleutel wordt versleuteld opgeslagen en daarna nooit meer getoond.

3Het kanaal laten leveren

Open in Feed Manager het Google-kanaal en kies onder Instellingen → Levering voor Merchant API (via koppeling …). Eén koppeling levert één kanaal. Zie Feed Manager via de Merchant API.

Zet daarna op Wat synchroniseren de producten (uitgaand) aan, en start de eerste sync op Volledige sync.

Testen met een Merchant Center-testaccount

Een testaccount is een Merchant Center-account waarvan niets ooit wordt gepubliceerd. Producten worden wel verwerkt en gecontroleerd, dus je ziet precies wat Google ervan vindt. Zo probeer je de koppeling uit voordat je echte account ook maar één product krijgt.

Goed om te weten:

• Je maakt maximaal 5 testaccounts per Google-account. Een testaccount kan nooit een echt account worden (en andersom).
• Een testaccount heeft dezelfde quota als een echt account.
• Auto Feeds, koppelingen met Google Ads en het claimen van je homepage werken niet in een testaccount.

1 · Google Cloud-project en Merchant API

1. Open de Google Cloud Console en kies of maak een project.
2. Ga naar API’s en services → Bibliotheek, zoek Merchant API en klik op Inschakelen.
3. Registreer het project eenmalig bij je echte Merchant Center-account. Dat doet iemand met beheerderstoegang tot dat account, met de methode developerRegistration.registerGcp (bijvoorbeeld met Try it op die pagina). Vul bij developerEmail je eigen e-mailadres in, niet dat van het serviceaccount. Wacht daarna ongeveer 5 minuten.

2 · Serviceaccount en sleutel

1. Maak onder IAM en beheer → Serviceaccounts een serviceaccount aan.
2. Kies bij het serviceaccount Sleutels → Sleutel toevoegen → JSON en bewaar het bestand.
3. Voeg in Merchant Center (je echte account) onder Instellingen → Personen en toegang het e-mailadres van het serviceaccount toe, met Beheerderstoegang. Die is nodig om een testaccount aan te maken.

3 · Testaccount aanmaken

1. Voeg de koppeling toe (zie 2 · Koppeling toevoegen hierboven). Vul bij Merchant Center-account-ID het ID van je echte account in en lees de JSON-sleutel in.
2. Klik naast het account-ID op Testaccount aanmaken. Nexym maakt het testaccount “Nexym test – projectnaam” aan, in de tijdzone en taal van je project, onder je echte account. Het nieuwe ID komt in het veld, Dit is een testaccount gaat aan en je echte account-ID wordt bewaard als Parent Merchant Center-ID.
3. Vanaf nu staat bij de koppeling, in het kanaal in Feed Manager en in Runs & logs het label TEST — wordt nooit gepubliceerd.

Lukt het niet, dan zegt Nexym wat er mis is:

Melding	Wat je doet
Geen beheerderstoegang	Geef het serviceaccount Beheerderstoegang in je echte account en controleer het account-ID
Maximum van 5 bereikt	Gebruik een bestaand testaccount: vul het ID in en zet Dit is een testaccount aan
Merchant API staat niet aan	Zet de Merchant API aan in het Cloud-project (stap 1.2) en wacht een paar minuten
Project niet geregistreerd	Registreer het Cloud-project bij je echte account (stap 1.3) en wacht 5 minuten

4 · Testpush

1. Kies in Feed Manager bij het Google-kanaal de levering Merchant API (via koppeling …).
2. Open bij de koppeling het tabblad Test en klik op Verbinding testen. Je ziet per stap een ✓ of ✗: sleutel, toegangstoken, toegang tot het account, gegevensbron en quotum. Nexym leest daarbij ook bij Google na of het een testaccount is.
3. Klik onder Testpush op Testproducten versturen. Standaard gaan de eerste 5 geschikte producten van het kanaal, of de referenties die je zelf invult. Ze gaan via de gewone export: dezelfde mapping, regels en gegevensbron. Andere producten veranderen niet.
4. Je ziet per product wat er is verstuurd, wat Merchant Center antwoordde en de naam die Google het product gaf. Na ongeveer een minuut leest Nexym de verwerkte status terug: goedgekeurd, waarschuwingen of afgekeurd, met de reden.

Doe je een Testpush op een echt account, dan vraagt Nexym eerst om te bevestigen dat de producten echt naar Merchant Center gaan.

5 · Volledige sync, en daarna live

1. Gaat de Testpush goed, start dan op het tabblad Volledige sync een volledige sync naar het testaccount en bekijk de stap Kwaliteit van het kanaal.
2. Klaar om live te gaan? Vul op Instellingen het ID van je echte account weer in, zet Dit is een testaccount uit, maak ID gegevensbron leeg en sla op. Klik op Verbinding testen en start daarna een Volledige sync: die stuurt alles naar het echte account.

Wat er gebeurt

• Alleen gewijzigde producten gaan mee. Een product dat Merchant Center al precies zo heeft, wordt niet opnieuw verstuurd. Ook uitverkocht raken telt als wijziging.
• Een product dat uit het kanaal valt, wordt uit Merchant Center verwijderd. Dat gebeurt als het product offline gaat of als een regel van het kanaal het uitsluit.
• Een gewijzigde mapping of regel geldt voor producten zodra die wijzigen. Wil je alles nu opnieuw sturen, gebruik dan Volledige sync → opnieuw versturen.
• Het tabblad Veldmapping van de koppeling toont de mapping van het kanaal (alleen lezen). Je ziet daar welke verplichte velden gevuld zijn, hoeveel producten nu falen, en vind je de knop Bewerken in Feed Manager.
• Elke twee uur leest Nexym wat Merchant Center over de producten meldt (afkeuringen en waarschuwingen). Je ziet dat in de stap Kwaliteit van het kanaal en in Runs & logs.

Limieten

Merchant Center heeft per account een quotum per minuut. Nexym verstuurt rustig, wacht bij een melding “te veel verzoeken” (HTTP 429) wat Google vraagt, en gaat daarna verder. Een grote catalogus kan de eerste keer dus even duren.