Gebruik de native app om klantgegevens te verrijken
De GenderAPI-app voor Shopify kan bestaande en nieuwe klanten verwerken, een voorspelling van het geslacht toevoegen en een ontbrekende naam afleiden uit het e-mailadres. Begin in de juiste Shopify-winkel en kies de instellingen die passen bij de klantvelden die u wilt bijwerken.
Dit is een native Shopify-app met eigen instellingen voor verwerking en abonnement. De implementatie die op 27 september 2026 is gecontroleerd, roept het openbare V2-voorspellingsendpoint niet aan. Ga er niet van uit dat het saldo van uw API-sleutel, de AI-opties van V2 of de V2-responsvelden voor deze app gelden.
Bereid de winkel voor en bepaal wat u wilt wijzigen
- Open Gender API - Determine gender in de Shopify App Store. Controleer de uitgever Ozan Soft, de doelwinkel, de huidige rechten en het abonnement voordat u installeert.
- Controleer het saldo van de app en de instellingen voor het verwerken van klanten. Bepaal of u bestaande klanten wilt verwerken, automatische verwerking van nieuwe klanten wilt inschakelen of beide.
- Controleer een kleine groep klantrecords met ingevulde namen, ontbrekende namen en dubbelzinnige invoer. Houd de bestaande namen en tags zichtbaar terwijl u de resultaten controleert.
- Schakel het aanvullen van ontbrekende namen alleen in als u wilt dat een uit het e-mailadres afgeleide kandidaat in het naamveld van de klant wordt geschreven. De voorspelling van het geslacht en de wijziging van de naam zijn twee afzonderlijke beslissingen.
- Controleer de aangemaakte tags en het klantmetafield voordat u ze in een segment gebruikt. Controleer of de overige klantgegevens ongewijzigd blijven.
Begrijp de klantvelden die de app gebruikt
De onderstaande koppelingen beschrijven de gecontroleerde broncode van de app. Controleer ze in de geïnstalleerde app en op een gecontroleerde steekproef voordat u een downstream workflow koppelt.
| Klantveld of instelling | Richting | Gedrag |
|---|---|---|
| Voornaam | Invoer | Voorkeursinvoer wanneer een voornaam aanwezig is. |
| Invoer | Wordt gebruikt om een kandidaat-naam af te leiden wanneer de voornaam ontbreekt; een adres zonder bruikbare naam kan onopgelost blijven. | |
| Land van het adres | Optionele context | De verwerking kan het land van een beschikbaar klantadres gebruiken als context voor het opzoeken van de naam. |
| Klanttags | Uitvoer | De gecontroleerde implementatie gebruikt male, female of gender_null en behoudt niet-gerelateerde tags. |
| custom.gender | Uitvoer | Een klantmetafield dat het afgeleide label bevat als tekstwaarde van één regel. |
| Bijwerken van de naam | Optionele uitvoer | Wanneer de functie is ingeschakeld, kan een uit het e-mailadres afgeleide kandidaat een ontbrekende voornaam invullen; de implementatie voegt first_name_found_from_email toe. |
| Automatische verrijking | App-instelling | Regelt de verwerking van gebeurtenissen voor nieuwe klanten; de beschikbaarheid hangt af van het abonnement en de instellingen van de app. |
Controleer tags, onbekende resultaten en bestaande classificaties
Open een verwerkte klant in Shopify en vergelijk de tags, custom.gender en de naam met het oorspronkelijke record. Gebruik in het segment het veld en label dat daadwerkelijk is opgeslagen, in plaats van aan te nemen dat er een JSON-pad van de API beschikbaar is.
De gecontroleerde flow slaat klanten over die al de tag male, female of gender_null hebben. Een ongewijzigd record kan dus wijzen op een bestaande classificatie in plaats van een nieuwe zoekopdracht. Bepaal hoe u eerdere classificaties controleert voordat u een nieuwe uitvoering start.
Behandel gender_null als een onopgelost resultaat. De native koppelingen bieden geen V2-betrouwbaarheidsscore, geen bronveld en geen usage-record per verzoek. Verzin deze waarden niet in een spreadsheetexport en zet een onbekend resultaat niet om in een binaire classificatie.
| Resultaat | Aanbevolen volgende stap |
|---|---|
| Verwachte tag en metafield | Controleer het ID van de bronklant en sta alleen het beoogde segment of de beoogde downstream-update toe. |
| gender_null | Laat het geval onopgelost en sluit het uit van regels die een identified-resultaat vereisen. |
| Bestaande geslachtstag | Controleer of de app de klant heeft overgeslagen voordat u over een nieuwe verwerking beslist. |
| Ontbrekende of inconsistente update | Controleer de verwerkingsstatus in de app voordat u de hele groep opnieuw uitvoert. |
Controleer het abonnement van de app en de toegang tot gegevens
Controleer de limieten voor klantverwerking op het huidige scherm voor abonnement en saldo van de Shopify-app. De gecontroleerde app heeft een creditsaldo per winkel en verwerkt aankopen via Shopify; deze wordt niet geconfigureerd met een openbare GenderAPI-API-sleutel. Controleer de actuele prijzen op de pagina van de app in plaats van de V2-tarieven voor credits toe te passen.
De app heeft toegang tot klantgegevens nodig en kan klantrecords wijzigen. De verwerking gebruikt een wachtrij aan de kant van de app. De informatie over het bewaren van e-mailverzoeken moet daarom niet worden gelezen als een belofte dat in deze workflow nooit klantgegevens worden opgeslagen. Controleer de rechten van de app en het gepubliceerde beleid voor uw winkel.
Een afgeleid label is een probabilistisch signaal in de gegevens. Houd het gescheiden van informatie die de persoon zelf heeft verstrekt en gebruik het niet als enige basis voor beslissingen over geschiktheid, toegang, prijzen of andere beslissingen met ingrijpende gevolgen.
Gebruik V2 wanneer u een gestructureerde response nodig hebt
Voor een eigen integratie accepteert GenderAPI V2 namen, e-mailadressen en gebruikersnamen en retourneert het expliciete velden voor resultaat, betrouwbaarheidsscore, bron en verbruik. Configureer die verbinding afzonderlijk: het lezen van de V2-gids wijzigt de geïnstalleerde app en de uitvoerkolommen ervan niet.
De voorbeelden in Python en Node.js behandelen losse verzoeken, batches, unknown-resultaten en operationele fouten. Begin met de gids voor authenticatie en kies de AI-modus voordat u een verzoek verstuurt waarvoor een afschrijving geldt.
Veelgestelde vragen
Configureer ik de app voor Shopify met mijn V2-API-sleutel?
De gecontroleerde native app is gebaseerd op de installatie in Shopify, eigen abonnementsinstellingen en een saldo per winkel. Een eigen HTTP-workflow met V2 is een afzonderlijke integratie en vervangt de instellingen van de native app niet.
Waar vind ik het afgeleide label van een klant?
De gecontroleerde app schrijft klanttags en het klantmetafield custom.gender. Controleer de geïnstalleerde app en een voorbeeldklant voordat u segmenten op basis van deze waarden maakt.
Wat betekent gender_null?
De waarde geeft een onopgelost label aan in de gecontroleerde native app. Houd die klant in de groep met onbekende resultaten in plaats van de waarde om te zetten naar male of female.
Kan ik de namen van klanten ongewijzigd laten?
Controleer de instelling voor het aanvullen van ontbrekende namen afzonderlijk van de verwerking van het geslacht. Schakel deze alleen in als u wilt dat de app een ontbrekende voornaam invult met een uit het e-mailadres afgeleide kandidaat.
Referentiedocumentatie
De handleiding is voor het laatst gecontroleerd op . Controleer de installatie in de documentatie van het platform en gebruik de gekoppelde API-documentatie voor een afzonderlijke V2-integratie.