# Wzbogacanie danych klientów Shopify za pomocą aplikacji GenderAPI

> Skonfiguruj aplikację Shopify i sprawdź tagi, custom.gender oraz opcjonalne uzupełnianie imion. Sprawdź plan i saldo należące do samej aplikacji.

Canonical HTML: https://www.genderapi.io/pl/blog/jak-okreslic-plec-w-shop-ify-za-pomoca-gender-api

Last reviewed: 2026-09-28

## 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.

- [Oficjalna strona w Shopify App Store](https://apps.shopify.com/gender-api)

## 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. |
| E-mail | 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.

- [Aktualne plany i uprawnienia w Shopify](https://apps.shopify.com/gender-api)
- [Polityka przetwarzania danych GenderAPI](https://www.genderapi.io/pl/privacy-policy)

## 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.

- [Uwierzytelnianie V2](https://www.genderapi.io/pl/docs/v2/authentication)
- [Pola odpowiedzi V2](https://www.genderapi.io/pl/docs/v2/responses)
- [Przykład integracji w Pythonie](https://www.genderapi.io/pl/integrations/python)
- [Przykład integracji w Node.js](https://www.genderapi.io/pl/integrations/javascript)

## 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

- [Oficjalna karta w katalogu: Shopify](https://apps.shopify.com/gender-api)
- [Polityka prywatności i przetwarzanie danych](https://www.genderapi.io/pl/privacy-policy)
- [Dokumentacja osobnego API V2](https://www.genderapi.io/pl/api-documentation)