Virtueel passen met AI voor WooCommerce: documentatie
Virtueel passen met AI installeren en instellen op uw WooCommerce-productpagina's, met de Google Vertex AI API.
Wat de plugin doet
DF Google Try-On voegt een knop voor virtueel passen toe aan uw WooCommerce-productpagina’s. De klant uploadt een foto of gebruikt haar webcam, en de kunstmatige intelligentie genereert een beeld waarop zij het kledingstuk draagt. Het voorbeeld verschijnt in een modaal venster, zonder de productpagina te verlaten.
Belangrijk: deze plugin gebruikt de ontwikkelaars-API Vertex AI Virtual Try-On van Google Cloud. Dat is niet het consumentgerichte passen dat u in Google Search en Google Shopping ziet, want dat is niet in een externe site te integreren. Elke gegenereerde afbeelding wordt door Google in rekening gebracht.
Vereisten
- WordPress 6.2 of hoger, WooCommerce 7.0 of hoger
- PHP 7.4 of hoger, met de OpenSSL-extensie ingeschakeld
- Een Google Cloud-project met actieve facturering
- De Vertex AI API ingeschakeld op dat project
- Een serviceaccount met de rol Vertex AI User
Stap 1: Google Cloud voorbereiden
De Vertex AI API inschakelen
Selecteer in de Google Cloud Console uw project, ga naar de API-bibliotheek en schakel Vertex AI API in. Controleer of de facturering op het project actief is: zonder facturering mislukken alle aanroepen.
Het serviceaccount aanmaken
- Open het onderdeel IAM en beheer, en daarna Serviceaccounts.
- Maak een serviceaccount aan (de naam doet er niet toe, bijvoorbeeld woocommerce-tryon).
- Ken het de rol Vertex AI User toe. Geef geen bredere rol dan nodig.
- Maak op het tabblad Sleutels een sleutel van het type JSON aan en download het bestand.
Dit JSON-bestand bevat een privésleutel. Behandel het als een wachtwoord: zet het niet in versiebeheer, deel het niet en beperk de toegang tot uw WordPress-beheer.
Een regio kiezen
Het model moet beschikbaar zijn in de regio die u opgeeft. De standaardwaarde us-central1 is de veiligste keuze. Wilt u een Europese regio, controleer dan eerst in de documentatie van Google of het Virtual Try-On-model daar beschikbaar is, want de regionale dekking verandert.
Stap 2: de plugin installeren
- Ga in WordPress naar Plugins, Nieuwe plugin, Plugin uploaden.
- Selecteer het meegeleverde ZIP-bestand, installeer het en activeer het.
- Er verschijnt een nieuw menu: WooCommerce, Google Try-On.
Stap 3: instellen
Alle instellingen staan in WooCommerce, Google Try-On.
Verbinding met Google
- GCP-project-ID: de identificatie van het project, niet de weergavenaam.
- Regio: bijvoorbeeld us-central1.
- JSON van het serviceaccount: plak de volledige inhoud van het gedownloade bestand. De plugin valideert de JSON bij het opslaan en weigert een verkeerd opgemaakte sleutel.
Bij het opslaan wordt de cache van het toegangstoken automatisch geleegd, zodat een gewijzigde sleutel meteen wordt toegepast.
Weergave
- Passen inschakelen: de hoofdschakelaar. Zolang die uit staat, is er in de winkel niets te zien.
- Knoptekst: de tekst die op de productpagina verschijnt.
- Toegestane categorieën: beperkt de widget tot bepaalde categorieën. Laat leeg om alle producten toe te staan.
Beveiliging en kosten
- Veiligheidsfilter: het filterniveau dat Google op de afbeeldingen toepast. Bij een publieke winkel is de strengste instelling aan te raden.
- Watermerk: voegt het SynthID-watermerk van Google toe aan de gegenereerde afbeeldingen. Aanbevolen, om aan te geven dat het om een synthetisch beeld gaat.
- Maandelijkse limiet: het maximale aantal geslaagde passessies per kalendermaand. Zet 0 om niet te begrenzen, maar houd er rekening mee dat elke generatie in rekening wordt gebracht.
- Toestemmingstekst: de boodschap naast het verplichte selectievakje.
De teller van de lopende maand staat boven aan de instellingenpagina.
Stap 4: de weergave per product regelen
Op de productpagina biedt het tabblad Algemeen van de productgegevens een instelling Virtueel passen met drie waarden:
- Auto: volgt de globaal ingestelde categorieën.
- Altijd tonen: forceert de weergave, ook buiten de toegestane categorieën.
- Nooit tonen: verbergt de widget, ongeacht de algemene instelling.
Het kledingstuk dat naar de AI gaat, is de hoofdafbeelding van het product, aan de serverzijde opgehaald. Een scherpe foto van alleen het kledingstuk, netjes uitgeknipt en op een lichte achtergrond, geeft veel betere resultaten dan een gedragen foto of een drukke enscenering.
Hoe het technisch werkt
Een passessie verloopt als volgt:
- De klant opent het modale venster en levert een foto aan, via een upload of een webcamopname. De afbeelding wordt in de browser verkleind op de langste zijde, vóór elke verzending.
- Ze vinkt het verplichte toestemmingsvakje aan: zonder dat wijst de server het verzoek af.
- De server controleert het beveiligingstoken, het product, de limiet per IP-adres en de maandelijkse limiet.
- De plugin ondertekent een JWT-token in RS256 met de privésleutel van het serviceaccount, wisselt dat in voor een OAuth2-toegangstoken en houdt dat in cache tot vlak vóór het verloopt.
- De foto en de productafbeelding gaan naar het Vertex AI-model, dat de gegenereerde afbeelding teruggeeft.
- De afbeelding gaat terug naar de browser en verschijnt in het modale venster.
De afbeelding van het kledingstuk wordt nooit door de browser aangeleverd: ze wordt altijd aan de serverzijde van de productpagina gelezen. Zo kan een bezoeker de dienst niet misbruiken om een willekeurige afbeelding te laten passen.
Persoonsgegevens en AVG
De foto van de klant is een persoonsgegeven. De plugin is daarop ontworpen:
- De foto wordt nooit op uw server opgeslagen, niet in de mediabibliotheek en niet in de database. Ze blijft alleen in het geheugen zolang de aanroep duurt.
- De gegenereerde afbeelding gaat rechtstreeks terug naar de browser en wordt evenmin bewaard.
- Er moet een uitdrukkelijk toestemmingsvakje worden aangevinkt vóór enige verwerking, met een tekst die u zelf opstelt.
- De foto wordt doorgegeven aan Google, dat als verwerker optreedt. Vermeld die doorgifte in uw privacyverklaring, met het doel en de ontvanger.
De plugin bewaart geen enkele afbeelding, maar het is aan u om deze verwerking te documenteren in uw register en uw privacyverklaring, en om de gebruiksvoorwaarden van Google Cloud voor uw project na te gaan.
De kosten beheersen
Elke geslaagde passessie komt neer op één door Google gefactureerde beeldgeneratie. Er zijn drie beveiligingen ingebouwd:
- De maandelijkse limiet, die nieuwe generaties blokkeert zodra ze is bereikt.
- Een limiet per IP-adres, die reeksen aanroepen na elkaar voorkomt.
- Het uitsluitend gebruiken van de productafbeelding aan de serverzijde, wat elk oneigenlijk gebruik van de dienst uitsluit.
De teller wordt bij elke nieuwe kalendermaand automatisch op nul gezet. Volg daarnaast het budget in de Google Cloud Console, waar u factureringswaarschuwingen kunt instellen.
Problemen oplossen
De knop verschijnt niet
Controleer op volgorde: staat de hoofdschakelaar aan, zijn het project-ID en de JSON ingevuld, hoort het product bij een toegestane categorie of staat het op Altijd tonen, en heeft het product wel een hoofdafbeelding.
Foutmelding bij de authenticatie
De JSON-sleutel is ongeldig of onvolledig, of het serviceaccount heeft de rol Vertex AI User niet. Plak het volledige bestand opnieuw en controleer de rol in de Google Cloud Console. Controleer ook of de OpenSSL-extensie op uw hosting beschikbaar is.
Er wordt geen afbeelding gegenereerd
Het model kan een foto weigeren die te donker of onscherp is, op het gezicht is bijgesneden, of meerdere personen bevat. Vraag om een scherpe, goed belichte foto, bij voorkeur ten voeten uit en van voren. Een zeer streng veiligheidsfilter kan bepaalde afbeeldingen ook blokkeren.
Foutmelding over de regio of een onvindbaar model
Het model is niet beschikbaar in de opgegeven regio. Ga terug naar us-central1 en controleer de regionale beschikbaarheid van het model in de documentatie van Google.
De dienst meldt dat de capaciteit vol is
De maandelijkse limiet is bereikt. Verhoog die in de instellingen, of wacht op de volgende maand. De teller van de lopende maand staat boven aan de instellingenpagina.
Veelgestelde vragen
Moet ik Composer installeren?
Nee. De plugin gebruikt een ingebouwde autoloader en ondertekent de Google-authenticatie in pure PHP, via OpenSSL.
Is de plugin compatibel met HPOS?
Ja, de compatibiliteit met de high performance order storage is verklaard.
Werkt het op mobiel?
Ja. De opname gebruikt de camera aan de voorzijde wanneer de browser dat toestaat, en een foto uploaden blijft altijd mogelijk.
Kun je ook iets anders dan kleding passen?
Het model is getraind op gedragen kleding. De resultaten bij accessoires, schoenen of voorwerpen zijn veel minder betrouwbaar. Beperk de widget tot uw kledingcategorieën.
Wat gebeurt er als ik de plugin verwijder?
Bij het verwijderen worden de instellingen, het token in cache en de maandtellers gewist. De instelling per product blijft behouden, zodat er bij een herinstallatie niets verloren gaat.