Usa l'app nativa per arricchire i dati dei clienti
L'app GenderAPI per Shopify può elaborare clienti esistenti e nuovi, aggiungere una previsione del genere e ricavare un nome mancante dall'indirizzo email. Inizia dal negozio Shopify corretto e scegli le impostazioni adatte ai campi cliente che vuoi aggiornare.
Si tratta di un'app Shopify nativa con impostazioni proprie di elaborazione e di piano. L'implementazione esaminata il 27 settembre 2026 non chiama l'endpoint pubblico di previsione della V2. Non dare per scontato che il saldo della tua chiave API, le opzioni IA della V2 o i campi di risposta della V2 valgano per questa app.
Prepara il negozio e decidi cosa modificare
- Apri Gender API - Determine gender nello Shopify App Store. Verifica l'editore Ozan Soft, il negozio di destinazione, le autorizzazioni attuali e il piano prima di installare.
- Controlla il saldo dell'app e le sue impostazioni di elaborazione dei clienti. Decidi se elaborare i clienti esistenti, attivare l'elaborazione automatica dei nuovi clienti o entrambe le cose.
- Controlla un piccolo gruppo di record cliente con nomi indicati, nomi mancanti e input ambigui. Tieni visibili i nomi e i tag esistenti mentre verifichi i risultati.
- Attiva il completamento dei nomi mancanti solo se vuoi che un candidato ricavato dall'indirizzo email venga scritto nel campo del nome del cliente. La previsione del genere e la modifica del nome sono due decisioni separate.
- Verifica i tag creati e il metafield del cliente prima di usarli in un segmento. Controlla che le altre informazioni del cliente restino invariate.
Comprendi i campi cliente usati dall'app
Le mappature seguenti descrivono il codice sorgente esaminato dell'app. Verificale nell'app installata e su un campione controllato prima di collegare un flusso di lavoro a valle.
| Campo cliente o impostazione | Direzione | Comportamento |
|---|---|---|
| Nome | Input | Input preferito quando è presente un nome. |
| Input | Usato per ricavare un nome candidato quando il nome manca; un indirizzo senza un nome utilizzabile può restare non risolto. | |
| Paese dell'indirizzo | Contesto facoltativo | L'elaborazione può usare il paese di un indirizzo cliente disponibile come contesto per la ricerca del nome. |
| Tag cliente | Output | L'implementazione esaminata usa male, female o gender_null e conserva i tag non correlati. |
| custom.gender | Output | Un metafield del cliente che contiene l'etichetta dedotta come valore di testo su una riga. |
| Aggiornamento del nome | Output facoltativo | Quando la funzione è attiva, un candidato ricavato dall'indirizzo email può compilare un nome mancante; l'implementazione aggiunge first_name_found_from_email. |
| Arricchimento automatico | Impostazione dell'app | Controlla l'elaborazione degli eventi dei nuovi clienti; la disponibilità dipende dal piano e dalle impostazioni dell'app. |
Controlla tag, risultati sconosciuti e classificazioni esistenti
Apri un cliente elaborato in Shopify e confronta i suoi tag, custom.gender e il nome con il record originale. Nel segmento usa il campo e l'etichetta effettivamente salvati, invece di presumere che sia disponibile un percorso JSON dell'API.
Il flusso esaminato salta i clienti che hanno già il tag male, female o gender_null. Un record invariato può quindi indicare una classificazione esistente piuttosto che una nuova ricerca. Decidi come verificare le classificazioni precedenti prima di avviare una nuova esecuzione.
Tratta gender_null come un risultato non risolto. Le mappature native non forniscono né un valore di confidenza della V2, né un campo di origine, né un record usage per richiesta. Non inventare questi valori in un'esportazione del foglio di calcolo e non trasformare un risultato sconosciuto in una classificazione binaria.
| Risultato | Passaggio successivo consigliato |
|---|---|
| Tag e metafield attesi | Verifica l'ID del cliente di origine e consenti solo il segmento o l'aggiornamento a valle previsto. |
| gender_null | Lascia il caso non risolto ed escludilo dalle regole che richiedono un risultato identified. |
| Tag di genere esistente | Controlla se l'app ha saltato il cliente prima di decidere una nuova elaborazione. |
| Aggiornamento mancante o incoerente | Controlla lo stato dell'elaborazione nell'app prima di eseguire di nuovo l'intero gruppo. |
Verifica il piano dell'app e l'accesso ai dati
Controlla i limiti di elaborazione dei clienti nella schermata attuale del piano e del saldo dell'app Shopify. L'app esaminata ha un saldo di crediti per negozio e gestisce gli acquisti tramite Shopify; non si configura con una chiave API pubblica di GenderAPI. Verifica i prezzi attuali nella pagina dell'app invece di applicare le tariffe dei crediti della V2.
L'app ha bisogno di accedere ai dati dei clienti e può modificare i record cliente. L'elaborazione prevede una coda lato app. Le indicazioni sulla conservazione delle richieste email non vanno quindi lette come una promessa che nessun dato cliente venga mai memorizzato in questo flusso di lavoro. Verifica le autorizzazioni dell'app e l'informativa pubblicata per il tuo negozio.
Un'etichetta dedotta è un segnale probabilistico nei dati. Tienila separata dalle informazioni fornite dalla persona stessa e non usarla come unica base per decisioni su idoneità, accesso, prezzi o altre decisioni con conseguenze rilevanti.
Usa la V2 quando ti serve una risposta strutturata
Per un'integrazione personalizzata, GenderAPI V2 accetta nomi, indirizzi email e nomi utente e restituisce campi espliciti per risultato, confidenza, origine e consumo. Configura quella connessione separatamente: leggere la guida V2 non modifica l'app installata né le sue colonne di output.
Gli esempi in Python e Node.js coprono richieste singole, batch, risultati unknown ed errori operativi. Inizia dalla guida all'autenticazione e scegli la modalità IA prima di inviare una richiesta soggetta ad addebito.
Domande frequenti
Configuro l'app per Shopify con la mia chiave API V2?
L'app nativa esaminata si basa sull'installazione in Shopify, su impostazioni di piano proprie e su un saldo per negozio. Un flusso di lavoro HTTP personalizzato con la V2 è un'integrazione separata e non sostituisce le impostazioni dell'app nativa.
Dove trovo l'etichetta dedotta di un cliente?
L'app esaminata scrive i tag cliente e il metafield del cliente custom.gender. Controlla l'app installata e un cliente di esempio prima di creare segmenti basati su questi valori.
Che cosa significa gender_null?
Il valore indica un'etichetta non risolta nell'app nativa esaminata. Tieni quel cliente nel gruppo dei risultati sconosciuti invece di convertire il valore in male o female.
Posso lasciare invariati i nomi dei clienti?
Verifica l'impostazione per il completamento dei nomi mancanti separatamente dall'elaborazione del genere. Attivala solo se vuoi che l'app compili un nome mancante con un candidato ricavato dall'indirizzo email.
Documentazione di riferimento
La guida è stata verificata l'ultima volta il . Controlla l'installazione nella documentazione della piattaforma e usa la documentazione API collegata per un'integrazione V2 separata.