Use o aplicativo nativo para enriquecer clientes
O aplicativo da GenderAPI para Shopify pode processar clientes existentes e novos, adicionar uma previsão de gênero e inferir um primeiro nome ausente a partir do endereço de e-mail. Comece na loja Shopify certa e escolha as configurações adequadas aos campos de clientes que você quer atualizar.
É um aplicativo nativo do Shopify com configurações próprias de processamento e de plano. A implementação, revisada em 27 de setembro de 2026, não chama o endpoint público de previsões da V2. Não presuma que o saldo da sua chave de API, as opções de IA da V2 ou os campos de resposta da V2 se apliquem a este aplicativo.
Prepare a loja e escolha o que será alterado
- Abra Gender API - Determine gender na Shopify App Store. Verifique o desenvolvedor Ozan Soft, a loja de destino, as permissões atuais e o plano antes de instalar.
- Revise o saldo do aplicativo e as configurações de processamento de clientes dele. Decida se você quer processar clientes existentes, ativar o processamento automático de novos clientes ou ambos.
- Verifique um pequeno grupo de registros de clientes com primeiros nomes informados, primeiros nomes ausentes e entradas ambíguas. Mantenha os nomes e as tags existentes visíveis enquanto revisa os resultados.
- Ative o preenchimento de primeiros nomes ausentes somente se um candidato inferido do endereço de e-mail deve ser gravado no campo de primeiro nome do cliente. A previsão de gênero e a alteração do nome são duas decisões separadas.
- Verifique as tags criadas e o metacampo do cliente antes de usá-los em um segmento. Confirme que as demais informações do cliente permanecem inalteradas.
Entenda os campos de clientes que o aplicativo usa
Os mapeamentos abaixo descrevem o código-fonte revisado do aplicativo. Verifique-os no aplicativo instalado e em uma amostra controlada antes de conectar um fluxo de trabalho posterior.
| Campo do cliente ou configuração | Direção | Comportamento |
|---|---|---|
| Primeiro nome | Entrada | Entrada preferencial quando há um primeiro nome. |
| Entrada | Usado para inferir um nome candidato quando o primeiro nome está ausente. Um endereço sem um nome utilizável pode continuar não resolvido. | |
| País do endereço | Contexto opcional | O processamento pode usar o país de um endereço de cliente disponível como contexto para a consulta do nome. |
| Tags do cliente | Saída | A implementação revisada usa male, female ou gender_null e preserva as tags não relacionadas. |
| custom.gender | Saída | Um metacampo do cliente que contém o rótulo inferido como um valor de texto de uma linha. |
| Atualização do primeiro nome | Saída opcional | Quando o recurso está ativo, um candidato inferido do endereço de e-mail pode preencher um primeiro nome ausente. A implementação adiciona first_name_found_from_email. |
| Enriquecimento automático | Configuração do aplicativo | Controla o processamento de eventos de novos clientes. A disponibilidade depende do plano e das configurações do aplicativo. |
Verifique tags, resultados desconhecidos e classificações existentes
Abra um cliente processado no Shopify e compare as tags, custom.gender e o primeiro nome do cliente com o registro original. No segmento, use o campo e o rótulo que estão realmente salvos, em vez de presumir que um caminho JSON da API esteja disponível.
O fluxo revisado ignora clientes que já têm a tag male, female ou gender_null. Um registro inalterado pode, portanto, ser uma classificação existente, e não uma nova consulta. Decida como revisar as classificações anteriores antes de iniciar uma nova execução.
Trate gender_null como um resultado não resolvido. Os mapeamentos nativos não fornecem um valor de confiança da V2, um campo de origem nem um registro usage por requisição. Não invente esses valores em uma exportação de planilha e não transforme um resultado desconhecido em uma classificação binária.
| Resultado | Próximo passo recomendado |
|---|---|
| Tag e metacampo esperados | Verifique o ID do cliente de origem e permita somente o segmento ou a atualização posterior previstos. |
| gender_null | Deixe o caso como não resolvido e exclua-o de regras que exigem um resultado identified. |
| Tag de gênero existente | Verifique se o aplicativo ignorou o cliente antes de decidir por um novo processamento. |
| Atualização ausente ou divergente | Verifique o status do processamento no aplicativo antes de executar o grupo inteiro novamente. |
Verifique o plano do aplicativo e o acesso aos dados
Consulte os limites de processamento de clientes na tela atual de plano e saldo do aplicativo do Shopify. O aplicativo revisado tem um saldo de créditos por loja e processa as compras pelo Shopify. Ele não é configurado com uma chave pública da GenderAPI. Verifique os preços atuais na página do aplicativo em vez de aplicar as tarifas de créditos da V2.
O aplicativo precisa de acesso aos dados de clientes e pode alterar registros de clientes. O processamento inclui uma fila do lado do aplicativo. Por isso, informações sobre a retenção de requisições de e-mail não devem ser lidas como uma promessa de que nenhum dado de cliente jamais é armazenado neste fluxo de trabalho. Revise as permissões do aplicativo e a política publicada para a sua loja.
Um rótulo inferido é um sinal probabilístico nos dados. Mantenha-o separado das informações fornecidas pela própria pessoa e não o use como única base para decisões sobre elegibilidade, acesso, preços ou outras decisões com consequências relevantes.
Use a V2 quando precisar de uma resposta estruturada
Para uma integração personalizada, a GenderAPI V2 aceita nomes, endereços de e-mail e nomes de usuário e retorna campos explícitos de resultado, confiança, origem e uso. Configure essa conexão separadamente: ler o guia da V2 não altera o aplicativo instalado nem as colunas de saída dele.
Os exemplos em Python e Node.js cobrem requisições individuais, lotes, resultados unknown e erros operacionais. Comece pelo guia de autenticação e escolha o modo de IA antes de enviar uma requisição cobrada.
Perguntas frequentes
Configuro o aplicativo do Shopify com a minha chave de API da V2?
O aplicativo nativo revisado se baseia na instalação no Shopify, nas próprias configurações de plano e em um saldo por loja. Um fluxo de trabalho HTTP personalizado com a V2 é uma integração separada e não substitui as configurações do aplicativo nativo.
Onde encontro o rótulo inferido de um cliente?
O aplicativo revisado grava tags do cliente e o metacampo do cliente custom.gender. Verifique o aplicativo instalado e um cliente de exemplo antes de criar segmentos com base nesses valores.
O que significa gender_null?
O valor indica um rótulo não resolvido no aplicativo nativo revisado. Mantenha o cliente no grupo de resultados desconhecidos em vez de converter o valor em male ou female.
Posso deixar os nomes dos clientes inalterados?
Verifique a configuração de preenchimento de primeiros nomes ausentes separadamente do processamento de gênero. Ative-a somente se o aplicativo deve preencher um primeiro nome ausente com um candidato inferido do endereço de e-mail.
Fontes e documentação
A última revisão deste guia foi em . Confira a instalação na documentação da plataforma e use a documentação da API indicada para uma integração separada com a V2.