Použijte nativní aplikaci k obohacení zákaznických dat
Aplikace GenderAPI pro Shopify dokáže zpracovat stávající i nové zákazníky, přidat odhadnutý signál pohlaví a odvodit chybějící křestní jméno z e-mailové adresy. Začněte v požadovaném obchodě Shopify a zvolte nastavení aplikace, která odpovídají zákaznickým polím, jež chcete aktualizovat.
Jde o nativní aplikaci pro Shopify s vlastním nastavením zpracování a tarifu. Implementace zkontrolovaná 27. září 2026 nevolá veřejný endpoint V2 pro odhady. Nepředpokládejte, že se na tuto aplikaci vztahuje zůstatek API klíče, možnosti AI ve V2 nebo pole odpovědi V2.
Připravte obchod a rozhodněte, co se má změnit
- V Shopify App Store otevřete "Gender API - Determine gender". Před instalací ověřte, že jde o záznam od společnosti Ozan Soft, a zkontrolujte cílový obchod, aktuální oprávnění a tarif.
- Projděte si zůstatek aplikace a nastavení zpracování zákazníků. Rozhodněte, zda chcete zpracovat stávající záznamy, zapnout automatické zpracování nových zákazníků, nebo obojí.
- Zkontrolujte malou skupinu zákaznických záznamů s vyplněnými křestními jmény, chybějícími křestními jmény a nejednoznačnými vstupy. Při kontrole výsledků mějte stávající jména a štítky stále na očích.
- Doplňování chybějících křestních jmen zapněte jen tehdy, když chcete, aby se do pole křestního jména zákazníka zapsal kandidát odvozený z e-mailové adresy. Odvození pohlaví a úprava jména jsou dvě samostatná rozhodnutí.
- Než vygenerované štítky a metapole zákazníka použijete v segmentu, zkontrolujte je. Ověřte, že ostatní informace o zákazníkovi zůstaly nedotčené.
Seznamte se se zákaznickými poli, která aplikace používá
Následující mapování popisuje zkontrolovaný zdrojový kód aplikace. Než připojíte navazující workflow, ověřte je v nainstalované aplikaci a na kontrolovaném vzorku.
| Zákaznické pole nebo nastavení | Směr | Chování |
|---|---|---|
| Křestní jméno | Vstup | Preferovaný vstup jména, pokud je vyplněn. |
| E-mailová adresa | Vstup | Slouží k odvození kandidátního jména, když křestní jméno chybí; adresa bez použitelného jména může zůstat nevyřešená. |
| Země v adrese | Volitelný kontext | Zpracování může jako kontext pro vyhledání jména použít zemi z adresy zákazníka, pokud je k dispozici. |
| Štítky zákazníka | Výstup | Prozkoumaná implementace používá male, female nebo gender_null a ostatní štítky ponechává beze změny. |
| custom.gender | Výstup | Metapole zákazníka, které ukládá odvozené označení jako jednořádkovou textovou hodnotu. |
| Aktualizace křestního jména | Volitelný výstup | Pokud je funkce zapnutá, může chybějící křestní jméno doplnit kandidát odvozený z e-mailové adresy; implementace přidá first_name_found_from_email. |
| Automatické obohacování | Nastavení aplikace | Řídí zpracování událostí nových zákazníků; dostupnost závisí na tarifu a nastavení aplikace. |
Zkontrolujte štítky, neznámé výsledky a stávající klasifikace
Otevřete zpracovaného zákazníka v Shopify a porovnejte jeho štítky, custom.gender a křestní jméno s původním záznamem. Pro segment použijte skutečně uložené pole a označení, místo abyste předpokládali, že je k dispozici cesta JSON z API.
Prozkoumaný proces zpracování přeskakuje zákazníky, kteří už mají štítek male, female nebo gender_null. Nezměněný záznam proto může představovat stávající klasifikaci, a ne nové vyhledání. Před spuštěním dalšího běhu rozhodněte, jak se mají dřívější klasifikace kontrolovat.
Hodnotu gender_null ponechte jako nevyřešenou. Nativní mapování neposkytuje hodnotu spolehlivosti z V2, pole zdroje ani záznam usage pro jednotlivé požadavky. Tyto hodnoty si v exportu do tabulky nevymýšlejte a neznámý výsledek neměňte na binární klasifikaci.
| Výsledek | Doporučený další krok |
|---|---|
| Očekávaný štítek a metapole | Zkontrolujte ID zdrojového zákazníka a povolte jen zamýšlený segment nebo zamýšlenou navazující aktualizaci. |
| gender_null | Ponechte jako nevyřešený výsledek a vyřaďte zákazníka z pravidel, která vyžadují výsledek identified. |
| Stávající štítek pohlaví | Než se rozhodnete zákazníka zpracovat znovu, ověřte, zda ho aplikace nepřeskočila. |
| Chybějící nebo neodpovídající aktualizace | Než celou skupinu spustíte znovu, zkontrolujte stav operace v aplikaci. |
Zkontrolujte tarif aplikace a přístup k datům
Limity zpracování zákazníků zjistíte na aktuální obrazovce tarifu a v zůstatku aplikace pro Shopify. Zkontrolovaná aplikace vede samostatný zůstatek kreditů pro každý obchod a používá nákupní procesy Shopify; veřejný API klíč GenderAPI není způsob, jakým se aplikace konfiguruje. Aktuální ceny zjistěte na stránce aplikace, místo abyste používali ceník kreditů V2.
Aplikace potřebuje přístup k zákaznickým datům a může upravovat zákaznické záznamy. Její zpracování zahrnuje frontu na straně aplikace, proto prohlášení o tom, jak dlouho se uchovávají e-mailové adresy odeslané k vyhledání, nečtěte jako slib, že v tomto workflow nebudou nikdy uložena žádná zákaznická data. Projděte si oprávnění aplikace a zveřejněné zásady pro svůj obchod.
Odvozené označení je odhadovaný datový signál s nevyhnutelnou nejistotou. Držte ho odděleně od údajů, které osoba sama uvedla, a nepoužívejte ho samostatně k rozhodování o nároku, přístupu, cenách ani k jiným rozhodnutím se závažnými důsledky.
Použijte V2, když potřebujete strukturovanou odpověď
Pro vlastní integraci přijímá GenderAPI V2 jména, e-mailové adresy a uživatelská jména a vrací výslovná pole pro výsledek, spolehlivost, zdroj a čerpání kreditů. Toto připojení nastavte samostatně: přečtení průvodce V2 nezmění nainstalovanou aplikaci ani sloupce, do kterých zapisuje.
Příklady v Pythonu a Node.js pokrývají jednotlivé požadavky, dávkové požadavky, neznámé výsledky a provozní chyby. Začněte průvodcem autentizací a před odesláním požadavku, který se účtuje, zvolte režim AI.
Časté otázky
Nastavuji aplikaci pro Shopify pomocí svého API klíče pro V2?
Zkontrolovaná nativní aplikace používá instalaci v Shopify, vlastní nastavení tarifu a samostatný zůstatek pro každý obchod. Vlastní HTTP workflow s V2 je samostatná integrace a nastavení nativní aplikace nenahrazuje.
Kde najdu odvozené označení zákazníka?
Zkontrolovaná aplikace zapisuje štítky zákazníka a metapole zákazníka custom.gender. Než z těchto hodnot začnete vytvářet segmenty, zkontrolujte nainstalovanou aplikaci a vzorového zákazníka.
Co znamená gender_null?
Je to nevyřešené označení v prozkoumané nativní aplikaci. Zákazníka ponechte ve skupině neznámých výsledků, místo abyste hodnotu převedli na male nebo female.
Mohu ponechat jména zákazníků beze změny?
Nastavení doplňování chybějících křestních jmen posuzujte odděleně od zpracování pohlaví. Zapněte ho jen tehdy, když chcete, aby aplikace doplnila chybějící křestní jméno kandidátem odvozeným z e-mailové adresy.
Zdroje a dokumentace
Průvodce byl naposledy zkontrolován . Instalaci ověřte v dokumentaci platformy a pro samostatnou integraci V2 použijte níže uvedenou dokumentaci API.