Użyj natywnej aplikacji do wzbogacania danych klientów
Aplikacja GenderAPI dla Shopify może przetwarzać istniejących i nowych klientów, dodawać prognozę płci i wyprowadzać brakujące imię z adresu e-mail. Zacznij we właściwym sklepie Shopify i wybierz ustawienia odpowiadające polom klientów, które chcesz aktualizować.
Jest to natywna aplikacja Shopify z własnymi ustawieniami przetwarzania i planu. Implementacja przejrzana 27 września 2026 r. nie wywołuje publicznego endpointu prognoz V2. Nie zakładaj, że saldo Twojego klucza API, opcje AI z V2 ani pola odpowiedzi V2 mają zastosowanie do tej aplikacji.
Przygotuj sklep i zdecyduj, co ma się zmienić
- Otwórz Gender API - Determine gender w Shopify App Store. Przed instalacją sprawdź wydawcę Ozan Soft, sklep docelowy, bieżące uprawnienia i plan.
- Sprawdź saldo aplikacji i jej ustawienia przetwarzania klientów. Zdecyduj, czy przetworzyć istniejących klientów, włączyć automatyczne przetwarzanie nowych klientów, czy jedno i drugie.
- Sprawdź małą grupę rekordów klientów obejmującą podane imiona, brakujące imiona i niejednoznaczne dane wejściowe. Podczas przeglądania wyników miej na widoku istniejące imiona i tagi.
- Włącz uzupełnianie brakujących imion tylko wtedy, gdy chcesz zapisywać w polu imienia klienta kandydata wyprowadzonego z adresu e-mail. Prognozowanie płci i zmiana imienia to dwie odrębne decyzje.
- Sprawdź wygenerowane tagi i metapole klienta, zanim użyjesz ich w segmencie. Upewnij się, że pozostałe informacje o kliencie pozostają nienaruszone.
Poznaj pola klientów używane przez aplikację
Poniższe mapowania opisują przejrzany kod źródłowy aplikacji. Sprawdź je w zainstalowanej aplikacji i na kontrolowanej próbce, zanim podłączysz dalszy przepływ pracy.
| Pole klienta lub ustawienie | Kierunek | Działanie |
|---|---|---|
| Imię | Wejście | Preferowane dane wejściowe, jeśli imię jest podane. |
| Wejście | Służy do wyprowadzenia kandydata na imię, gdy imienia brakuje; adres bez użytecznego imienia może pozostać nierozstrzygnięty. | |
| Kraj z adresu | Opcjonalny kontekst | Przetwarzanie może wykorzystać kraj z dostępnego adresu klienta jako kontekst wyszukiwania według imienia. |
| Tagi klienta | Wyjście | Przejrzana implementacja używa male, female lub gender_null i zachowuje niepowiązane tagi. |
| custom.gender | Wyjście | Metapole klienta zawierające wywnioskowaną etykietę jako jednowierszową wartość tekstową. |
| Aktualizacja imienia | Opcjonalne wyjście | Po włączeniu kandydat wyprowadzony z adresu e-mail może uzupełnić brakujące imię; implementacja dodaje first_name_found_from_email. |
| Automatyczne wzbogacanie | Ustawienie aplikacji | Steruje przetwarzaniem zdarzeń dotyczących nowych klientów; dostępność zależy od planu i ustawień aplikacji. |
Sprawdź tagi, wyniki nieznane i istniejące klasyfikacje
Otwórz przetworzonego klienta w Shopify i porównaj jego tagi, custom.gender i imię z oryginalnym rekordem. W segmencie używaj faktycznie zapisanego pola i etykiety, zamiast zakładać, że dostępna jest ścieżka JSON z API.
Przejrzany proces pomija klientów, którzy mają już tag male, female lub gender_null. Niezmieniony rekord może więc oznaczać istniejącą klasyfikację, a nie nowe wyszukiwanie. Zanim uruchomisz kolejne przetwarzanie, zdecyduj, jak przeglądać wcześniejsze klasyfikacje.
Traktuj gender_null jako wynik nierozstrzygnięty. Natywne mapowania nie zapewniają wskaźnika pewności V2, pola źródła ani rekordu usage dla każdego zapytania. Nie wymyślaj tych wartości w eksporcie do arkusza kalkulacyjnego i nie zamieniaj wyniku nieznanego w klasyfikację binarną.
| Wynik | Zalecany następny krok |
|---|---|
| Oczekiwany tag i metapole | Sprawdź identyfikator klienta źródłowego i dopuść tylko zaplanowany segment lub dalszą aktualizację. |
| gender_null | Pozostaw przypadek jako nierozstrzygnięty i wyklucz go z reguł wymagających wyniku identified. |
| Istniejący tag płci | Sprawdź, czy aplikacja pominęła klienta, zanim zdecydujesz o ponownym przetworzeniu. |
| Brakująca lub niespójna aktualizacja | Sprawdź stan przetwarzania w aplikacji, zanim ponownie uruchomisz całą grupę. |
Sprawdź plan aplikacji i dostęp do danych
Limity przetwarzania klientów sprawdzaj na bieżącym ekranie planu i salda aplikacji Shopify. Przejrzana aplikacja prowadzi saldo kredytów przypisane do każdego sklepu i obsługuje zakupy przez Shopify; nie konfiguruje się jej publicznym kluczem API GenderAPI. Aktualne ceny sprawdzaj na stronie aplikacji, zamiast stosować cennik kredytów V2.
Aplikacja potrzebuje dostępu do danych klientów i może edytować rekordy klientów. Jej przetwarzanie obejmuje kolejkę po stronie aplikacji, dlatego informacji o przechowywaniu zapytań e-mail nie należy odczytywać jako obietnicy, że w tym przepływie pracy nigdy nie są przechowywane żadne dane klientów. Sprawdź uprawnienia aplikacji i opublikowaną politykę w odniesieniu do swojego sklepu.
Wywnioskowana etykieta jest probabilistycznym sygnałem w danych. Przechowuj ją oddzielnie od informacji podanych przez samą osobę i nie używaj jej jako jedynej podstawy decyzji o uprawnieniach, dostępie, cenach ani innych istotnych decyzji.
Użyj V2, gdy potrzebujesz ustrukturyzowanej odpowiedzi
W przypadku niestandardowej integracji GenderAPI V2 przyjmuje imiona, adresy e-mail i nazwy użytkowników oraz zwraca jawne pola wyniku, pewności, źródła i zużycia. Skonfiguruj to połączenie osobno: zapoznanie się z przewodnikiem V2 nie zmienia zainstalowanej aplikacji ani jej kolumn wyjściowych.
Przykłady w Pythonie i Node.js obejmują pojedyncze zapytania, partie, wyniki unknown i błędy operacyjne. Zacznij od przewodnika po uwierzytelnianiu i wybierz tryb AI przed wysłaniem płatnego zapytania.
Najczęstsze pytania
Czy aplikację Shopify konfiguruję moim kluczem API V2?
Przejrzana natywna aplikacja opiera się na instalacji w Shopify, własnych ustawieniach planu i saldzie przypisanym do sklepu. Niestandardowy przepływ pracy HTTP z V2 jest odrębną integracją i nie zastępuje ustawień natywnej aplikacji.
Gdzie znajdę wywnioskowaną etykietę klienta?
Przejrzana aplikacja zapisuje tagi klienta i metapole klienta custom.gender. Sprawdź zainstalowaną aplikację i przykładowego klienta, zanim utworzysz segmenty na podstawie tych wartości.
Co oznacza gender_null?
Ta wartość oznacza nierozstrzygniętą etykietę w przejrzanej natywnej aplikacji. Pozostaw takiego klienta w grupie wyników nieznanych, zamiast zamieniać wartość na male lub female.
Czy mogę pozostawić imiona klientów bez zmian?
Sprawdź ustawienie uzupełniania brakujących imion niezależnie od przetwarzania płci. Włącz je tylko wtedy, gdy chcesz, aby aplikacja uzupełniała brakujące imię kandydatem wyprowadzonym z adresu e-mail.
Dokumentacja źródłowa
Ostatnia weryfikacja tego poradnika: . Instalację sprawdź w dokumentacji platformy, a przy osobnej integracji V2 skorzystaj z podlinkowanej dokumentacji API.