Använd den inbyggda appen för att berika kunddata
GenderAPI-appen för Shopify kan bearbeta befintliga och nya kunder, lägga till en prediktion av kön och härleda ett saknat förnamn från e-postadressen. Börja i rätt Shopify-butik och välj de inställningar som passar de kundfält du vill uppdatera.
Det här är en inbyggd Shopify-app med egna inställningar för bearbetning och plan. Implementeringen som granskades den 27 september 2026 anropar inte den offentliga V2-slutpunkten för prediktioner. Utgå inte från att saldot för din API-nyckel, V2:s AI-alternativ eller V2:s svarsfält gäller för den här appen.
Förbered butiken och bestäm vad som ska ändras
- Öppna Gender API - Determine gender i Shopify App Store. Kontrollera utgivaren Ozan Soft, målbutiken, aktuella behörigheter och planen innan du installerar.
- Granska appens saldo och dess inställningar för kundbearbetning. Bestäm om befintliga kunder ska bearbetas, om automatisk bearbetning av nya kunder ska aktiveras, eller båda.
- Kontrollera en liten grupp kundposter med angivna förnamn, saknade förnamn och tvetydiga indata. Håll befintliga förnamn och taggar synliga medan du granskar resultaten.
- Aktivera kompletteringen av saknade förnamn bara om du vill att en kandidat som härletts från e-postadressen skrivs till kundens förnamnsfält. Prediktionen av kön och ändringen av förnamnet är två separata beslut.
- Granska de skapade taggarna och kundens metafält innan du använder dem i ett segment. Kontrollera att övrig kundinformation förblir oförändrad.
Förstå kundfälten som appen använder
Följande mappningar beskriver appens granskade källkod. Kontrollera dem i den installerade appen och på ett kontrollerat urval innan du ansluter ett efterföljande arbetsflöde.
| Kundfält eller inställning | Riktning | Beteende |
|---|---|---|
| Förnamn | Indata | Föredragen indata när ett förnamn finns. |
| E-post | Indata | Används för att härleda en namnkandidat när förnamnet saknas; en adress utan användbart namn kan förbli olöst. |
| Land från adressen | Valfri kontext | Bearbetningen kan använda landet från en tillgänglig kundadress som kontext för namnuppslaget. |
| Kundtaggar | Utdata | Den granskade implementeringen använder male, female eller gender_null och behåller orelaterade taggar. |
| custom.gender | Utdata | Ett metafält på kunden som innehåller den härledda etiketten som ett textvärde på en rad. |
| Uppdatering av förnamn | Valfri utdata | När funktionen är aktiverad kan en kandidat som härletts från e-postadressen fylla i ett saknat förnamn; implementeringen lägger till first_name_found_from_email. |
| Automatisk berikning | Appinställning | Styr bearbetningen av händelser för nya kunder; tillgängligheten beror på appens plan och inställningar. |
Kontrollera taggar, okända resultat och befintliga klassificeringar
Öppna en bearbetad kund i Shopify och jämför dess taggar, custom.gender och förnamn med den ursprungliga posten. Använd i segmentet det fält och den etikett som faktiskt sparats, i stället för att anta att en JSON-sökväg från API:et är tillgänglig.
Det granskade flödet hoppar över kunder som redan har taggen male, female eller gender_null. En oförändrad post kan därför innebära en befintlig klassificering snarare än ett nytt uppslag. Bestäm hur tidigare klassificeringar ska granskas innan du startar en ny körning.
Behandla gender_null som ett olöst resultat. De inbyggda mappningarna ger varken ett konfidensvärde från V2, ett källfält eller en usage-post per förfrågan. Hitta inte på sådana värden i en kalkylbladsexport och gör inte om ett okänt resultat till en binär klassificering.
| Resultat | Rekommenderat nästa steg |
|---|---|
| Förväntad tagg och förväntat metafält | Kontrollera källkundens id och godkänn bara det avsedda segmentet eller den avsedda efterföljande uppdateringen. |
| gender_null | Låt fallet vara olöst och uteslut det från regler som kräver ett identified-resultat. |
| Befintlig könstagg | Kontrollera om appen hoppade över kunden innan du beslutar om en ny bearbetning. |
| Saknad eller inkonsekvent uppdatering | Kontrollera bearbetningsstatus i appen innan du kör hela gruppen igen. |
Granska appens plan och dataåtkomst
Kontrollera gränserna för kundbearbetning på den aktuella skärmen för plan och saldo i Shopify-appen. Den granskade appen har ett kreditsaldo per butik och hanterar köp via Shopify; den konfigureras inte med en offentlig GenderAPI-API-nyckel. Kontrollera aktuella priser på appens sida i stället för att tillämpa V2:s kreditpriser.
Appen behöver åtkomst till kunddata och kan redigera kundposter. Bearbetningen omfattar en kö på appens sida. Uppgifter om lagring av e-postförfrågningar ska därför inte läsas som ett löfte om att inga kunddata någonsin lagras i det här arbetsflödet. Granska appens behörigheter och den publicerade policyn för din butik.
En härledd etikett är en probabilistisk signal i data. Håll den åtskild från uppgifter som personen själv har lämnat och använd den inte som enda grund för beslut om behörighet, åtkomst, priser eller andra beslut med betydande följder.
Använd V2 när du behöver ett strukturerat svar
För en egen integration tar GenderAPI V2 emot namn, e-postadresser och användarnamn och returnerar uttryckliga fält för resultat, konfidens, källa och förbrukning. Konfigurera den anslutningen separat: att läsa V2-guiden ändrar varken den installerade appen eller dess utdatakolumner.
Exemplen i Python och Node.js täcker enskilda förfrågningar, batchar, unknown-resultat och driftfel. Börja med guiden om autentisering och välj AI-läge innan du skickar en debiterbar förfrågan.
Vanliga frågor
Konfigurerar jag Shopify-appen med min V2-API-nyckel?
Den granskade inbyggda appen bygger på installationen i Shopify, egna planinställningar och ett saldo per butik. Ett eget HTTP-arbetsflöde med V2 är en separat integration och ersätter inte den inbyggda appens inställningar.
Var hittar jag en kunds härledda etikett?
Den granskade appen skriver kundtaggar och kundens metafält custom.gender. Kontrollera den installerade appen och en exempelkund innan du bygger segment utifrån de värdena.
Vad betyder gender_null?
Värdet markerar en olöst etikett i den granskade inbyggda appen. Behåll en sådan kund i gruppen med okända resultat i stället för att omvandla värdet till male eller female.
Kan jag lämna kundernas förnamn oförändrade?
Granska inställningen för komplettering av saknade förnamn separat från könsbearbetningen. Aktivera den bara om du vill att appen fyller i ett saknat förnamn med en kandidat som härletts från e-postadressen.
Referensdokumentation
Guiden granskades senast . Kontrollera installationen i plattformens dokumentation och använd den länkade API-dokumentationen för en separat V2-integration.