Commerce Studio

De producten van je webshop, hun prijzen en versies, en of wat eraan hangt nog klopt. De studio houdt catalogus en advertenties bij elkaar: welke prijs gold toen een advertentie werd gemaakt, wat het product opbrengt, en of de pagina's waar bezoekers landen heel zijn.

De studio leest je winkel. Hij verandert er niets aan: geen prijs, geen voorraad, geen pagina.

Je winkel koppelen

Onder Producten staat bovenaan de koppeling met je winkel.

• Zonder koppeling leest de studio je openbare catalogus. Dat geeft namen, prijzen en of iets op voorraad is, maar geen inkoopprijs. Zonder inkoopprijs is de break-even ROAS niet uit te rekenen.
• Met koppeling komen inkoopprijs en voorraad mee.

Nu kun je Shopify koppelen. WooCommerce en Magento staan zichtbaar op "binnenkort beschikbaar": die zijn nog niet bij een echte winkel doorlopen en daarom niet te kiezen.

Shopify koppelen:

1. Vul het adres van je winkel in, met https. Het myshopify-adres (zoals jouwwinkel.myshopify.com) mag je leeg laten: dan zoeken we het zelf. Lukt dat niet, dan staat het in de Shopify-admin onder Instellingen, Domeinen.
2. Maak in de Shopify-admin een app via Instellingen, Apps, Apps ontwikkelen, en haal op het tabblad API-inloggegevens het Admin API-toegangstoken op. Dat begint met shpat_. Let op: Shopify toont het één keer. Is het weg, dan maak je het opnieuw. De gedeelde sleutel van de app (API secret key) is niet het token.
3. Plak het token en kies Koppelen.

Een token is een sleutel van de klant en gaat versleuteld de kluis in. Daarom mag alleen een beheerder of eigenaar dit doen. Heb je meer dan één Shopify-koppeling in een werkruimte, dan weet de studio niet welk token bij welk domein hoort en vraagt hij er een weg te halen.

Na het koppelen wordt de catalogus op de achtergrond opgehaald. Dat duurt een minuut of twee, met prijzen, voorraad en productfoto's. Ververs het scherm om de producten te zien.

Twee knoppen helpen daarbij:

• Nu nalopen zet een ronde langs de winkel in de wachtrij. Per uur staat er maar één klaar: staat er al een, dan telt die.
• Eerst kijken leest de winkel en toont wat er zou veranderen, zonder iets vast te leggen.

Het overzicht

Het startscherm toont:

• Hoeveel producten er in je catalogus staan, en hoeveel actief of uitgefaseerd zijn.
• Beeld klaar voor gebruik?: een doorverwijzing om productfoto's en formaten te controleren.
• Webshop: heeft je site een webshop (de module Webshop staat aan), dan staan hier het aantal betaalde bestellingen en de omzet van de laatste 30 dagen. Alleen getallen: wie er kocht en wat er besteld is, zie je in de portal bij de site. De kaart is er alleen voor wie de site mag beheren. Omzet is inclusief btw, min wat al is terugbetaald; bestellingen in de testmodus, open, mislukte, geannuleerde en herroepen bestellingen tellen niet mee. Is er nog niets betaald, dan staat er dat, met uitleg.
• Producten die hun advertentie niet terugverdienen: producten met een bekende inkoopprijs waarvan de gemeten ROAS onder de break-even zit.
• Producten die adverteren op een veranderde prijs, of die niet meer op voorraad zijn. Beide zijn een reden om de geschiedenis van dat product na te kijken.
• Waar het geld heen gaat: de producten waar deze maand het meeste aan is besteed, met wat het opleverde. Heeft een product nog geen meting, dan staat er "nog niet gemeten".

Producten

De catalogus met per product prijs, marge, break-even en voorraad naast elkaar, zodat je ziet of een advertentie zichzelf nog terugverdient. Een product zonder inkoopprijs krijgt geen marge, en dat staat erbij in plaats van een gok.

Boven de lijst staan de prijsbewegingen: de grootste stijgingen en dalingen ten opzichte van de vorige vastgelegde prijs.

Eén product

Open een product voor:

• Prijs nu, marge per stuk en inkoopprijs (of "inkoopprijs onbekend").
• Prijsverloop: de verkoopprijs en de inkoopprijs door de tijd heen. Is er nog maar één prijs bekend, dan staat er sinds wanneer.
• Advertentieprestaties per advertentie: besteed, omzet en ROAS.
• Prijzen: elke versie met zijn herkomst en wanneer hij gold.
• Advertenties uit dit product, met de prijs die gold toen ze werden gemaakt. Beoordeel een advertentie op een oude prijs niet met de marge van vandaag.

Assetcontrole

Vind kapotte assets voor je klant ze vindt. De controle haalt openbare pagina's op en loopt de beelden, stijlbestanden, scripts en metadata na die erop staan.

1. Open Assetcontrole en zet de pagina's erin, één adres per regel. Begin bij een koopmoment: de productpagina, de winkelwagen en de checkout. Daar kost een ontbrekend beeld direct vertrouwen.
2. Kies het maximum aantal verwijzingen (25, 50, 100 of 200) en de maximale controletijd (30 seconden, 1 minuut of 2 minuten).
3. Kies Controle starten.

Je krijgt:

• Pagina's: hoeveel er bezocht zijn.
• Gecontroleerd: hoeveel verwijzingen zijn nagelopen.
• Kapot: de verwijzingen met een foutstatus, per soort (scripts bovenaan, want die blijven het langst verborgen: een stuk script op de checkout merkt niemand tot er niet meer wordt afgerekend) en waar ze gevonden zijn.
• Overgeslagen: wat niet is nagekeken, met de reden (de controletijd was op, of het maximum aantal verwijzingen). Een controle die daarover zwijgt, leest als een schone uitslag. Splits dan de lijst of kies meer tijd.

"Geen kapotte verwijzingen gevonden" geldt alleen voor de verwijzingen die zijn nagekeken.

Beperkingen, eerlijk gezegd: de controle volgt de pagina's die je opgeeft en gaat niet dieper, en ziet alleen wat een bezoeker zonder inlog ook ziet. Pagina's achter een inlog kan ze dus niet nalopen, en een winkel met duizenden producten loop je niet in één keer na. Het is geen crawler.

Via Claude of een andere MCP-client

Via MCP en de regisseur

Een externe agent met een sleutel van de werkruimte kan Commerce lezen en voorstellen doen. De regisseur krijgt dezelfde tools, met het recht van de gebruiker die hem vraagt. Zie Aansluiten via MCP.

• Lezen: commerce_winkel en commerce_product. Namen en adressen komen uit de winkel en zijn tekst van buiten: de agent leest ze als gegeven.
• Een productwijziging voorstellen (recht creatie.indienen): commerce_product_wijzigen_voorstellen voor naam, omschrijving, sku, prijs, inkoop of status. Het legt een kaart bij Goedkeuringen en verandert niets, ook niet in de catalogus. Denkploeg schrijft niet naar een winkel: wie tekent, voert de wijziging zelf door in de winkel, en de eerstvolgende ronde leest haar terug. Een prijs of inkoopprijs kan een model hoogstens vijf keer hoger of lager voorstellen dan nu (zonder huidige prijs geen prijsvoorstel); een sku die een ander product al heeft, kan niet. Hoogstens vijf voorstellen wachten tegelijk op een handtekening.
• De assetcontrole draaien (recht creatie.indienen): commerce_assetcontrole_draaien, met paden op de eigen winkel (/product/stoel), nooit een volledig adres. Het leest alleen, kost niets en volgt de strenge rem; er loopt hoogstens één controle tegelijk, en alleen beelden op dezelfde host als de pagina's worden opgehaald (de rest, een CDN bijvoorbeeld, wordt geteld als buiten de winkel). Wat de winkel teruggeeft staat onder onvertrouwd, en een uitslag met overgeslagen verwijzingen is geen schone uitslag.
• Bewust niet via MCP: een prijs of sku direct zetten, het winkeladres, koppelingen en sleutels, en een ronde draaien. Die doet een mens in het scherm.