Utiliza la aplicación para los registros de Shopify
La aplicación GenderAPI para Shopify puede procesar clientes existentes y nuevos, añadir una estimación de género y extraer del correo un nombre candidato cuando falta el nombre de pila. Selecciona los ajustes según los campos que quieras modificar.
La implementación revisada el 28 de septiembre de 2026 no llama al endpoint público de predicción V2. Tiene sus propios controles de procesamiento y plan. No supongas que utiliza el saldo de tu clave API, las opciones de IA o los campos de respuesta de V2.
Prepara la tienda y decide qué campos modificar
- Abre Gender API - Determine gender en Shopify App Store. Confirma el desarrollador Ozan Soft, la tienda, los permisos y el plan vigente antes de instalar.
- Revisa el saldo y los controles de procesamiento de la aplicación. Elige clientes existentes, procesamiento automático de nuevos clientes o ambos.
- Empieza con un grupo pequeño que incluya nombres presentes, ausentes y ambiguos. Conserva visibles los nombres y etiquetas originales.
- Activa el relleno de nombres solo si deseas escribir el candidato extraído del correo como nombre de pila del cliente. Esta edición y la estimación de género son opciones distintas.
- Antes de crear segmentos, revisa las etiquetas y el metafield de cliente. Comprueba que los demás datos se conserven.
Comprende los campos de cliente utilizados
Estas asignaciones se basan en el código revisado. Verifícalas con un cliente de prueba controlado en tu versión instalada antes de conectarlas a otro flujo.
| Campo o ajuste | Dirección | Comportamiento |
|---|---|---|
| Nombre de pila | Entrada | Se utiliza como entrada preferente cuando está disponible. |
| Correo electrónico | Entrada | Si falta el nombre, permite extraer un candidato. Un correo sin un nombre adecuado puede quedar sin resolver. |
| País de la dirección | Contexto opcional | El procesamiento puede utilizar el país de una dirección existente como contexto de la consulta. |
| Etiquetas de cliente | Salida | La implementación revisada utiliza male, female o gender_null y conserva las etiquetas ajenas a esta clasificación. |
| custom.gender | Salida | Metafield de cliente de texto de una sola línea que almacena la etiqueta estimada. |
| Actualización del nombre | Salida opcional | Puede rellenar un nombre ausente con el candidato del correo y añadir first_name_found_from_email. |
| Enriquecimiento automático | Ajuste de la aplicación | Procesa eventos de nuevos clientes; su disponibilidad depende del plan y la configuración. |
Revisa las etiquetas y los casos desconocidos
Abre un cliente procesado en Shopify y compara sus etiquetas, custom.gender y nombre de pila con el registro original. Crea segmentos con el campo realmente guardado, no con una ruta JSON supuesta.
El procesador revisado omite clientes que ya tienen male, female o gender_null. Un registro sin cambios puede representar una clasificación anterior, no una nueva consulta. Define cómo revisarás los resultados previos antes de repetir.
Mantén gender_null como desconocido. Estos campos no proporcionan confianza V2, source ni usage por solicitud; no inventes esos datos al exportar.
| Resultado | Qué revisar |
|---|---|
| Etiqueta y metafield previstos | Confirma la identidad del registro y aplica solo el segmento o cambio deseado. |
| gender_null | Conserva el caso desconocido y exclúyelo de reglas que exijan un resultado identificado. |
| Etiqueta de género anterior | Comprueba si el cliente se ha omitido antes de repetir el procesamiento. |
| Actualización ausente o incoherente | Revisa el estado del proceso antes de volver a ejecutar todo el grupo. |
Comprueba el plan y el acceso a los datos
Consulta el plan y el saldo vigentes dentro de la aplicación de Shopify. La implementación revisada utiliza saldo por tienda y compras mediante Shopify; no se configura con una clave pública de GenderAPI. No apliques automáticamente la tarifa V2.
La aplicación puede acceder a datos de clientes y editar registros. El procesamiento mantiene una cola en la aplicación: las explicaciones sobre retención de consultas de correo no significan que este flujo nunca almacene datos de clientes. Revisa los permisos y la política publicada.
Conserva la estimación separada de la información declarada por la persona. No bases decisiones importantes de acceso, elegibilidad o precio únicamente en esta etiqueta.
Utiliza V2 si necesitas una respuesta estructurada
GenderAPI V2 acepta nombres, correos y usuarios y devuelve campos explícitos de resultado, confianza, origen y uso. Configura esta conexión por separado: consultar V2 no actualiza una aplicación instalada ni cambia sus columnas.
Los ejemplos de Python y Node.js cubren solicitudes individuales, lotes, resultados desconocidos y errores operativos. Configura la autenticación y elige el modo de IA antes de enviar una solicitud facturable.
Preguntas frecuentes
¿Configuro Shopify con mi clave API V2?
La aplicación revisada utiliza la instalación de Shopify, sus propios controles de plan y un saldo por tienda. Un flujo HTTP V2 personalizado es una integración independiente.
¿Dónde se guarda la estimación?
La implementación revisada escribe etiquetas de cliente y el metafield custom.gender. Confirma el resultado con un cliente de muestra antes de crear segmentos.
¿Qué significa gender_null?
Es la etiqueta sin resolver de la implementación revisada. Conserva al cliente en el grupo desconocido en lugar de convertirla en male o female.
¿Puedo utilizarla sin cambiar los nombres?
Controla el relleno de nombres por separado de la estimación de género. Actívalo solo si quieres completar un nombre ausente con un candidato extraído del correo.
Documentación de referencia
Última revisión de esta guía: . Consulta la documentación de la plataforma para la instalación y la referencia API enlazada para una integración V2 independiente.