Die native App zur Anreicherung von Kundendaten verwenden
Die GenderAPI-App für Shopify kann bestehende und neue Kunden verarbeiten, eine Geschlechtsvorhersage hinzufügen und einen fehlenden Vornamen aus der E-Mail-Adresse ableiten. Beginnen Sie im richtigen Shopify-Shop und wählen Sie die Einstellungen, die zu den Kundenfeldern passen, die Sie aktualisieren möchten.
Es handelt sich um eine native Shopify-App mit eigenen Verarbeitungs- und Tarifeinstellungen. Die am 27. September 2026 geprüfte Implementierung ruft nicht den öffentlichen V2-Vorhersage-Endpunkt auf. Gehen Sie nicht davon aus, dass das Guthaben Ihres API-Schlüssels, die KI-Optionen von V2 oder die V2-Antwortfelder für diese App gelten.
Shop vorbereiten und festlegen, was sich ändern soll
- Öffnen Sie Gender API - Determine gender im Shopify App Store. Prüfen Sie vor der Installation den Herausgeber Ozan Soft, den Ziel-Shop, die aktuellen Berechtigungen und den Tarif.
- Prüfen Sie das Guthaben der App und ihre Einstellungen zur Kundenverarbeitung. Entscheiden Sie, ob bestehende Kunden verarbeitet, die automatische Verarbeitung neuer Kunden aktiviert oder beides genutzt werden soll.
- Prüfen Sie eine kleine Gruppe von Kundeneinträgen mit angegebenen Vornamen, fehlenden Vornamen und mehrdeutigen Eingaben. Behalten Sie beim Prüfen der Ergebnisse die vorhandenen Vornamen und Tags im Blick.
- Aktivieren Sie die Ergänzung fehlender Vornamen nur, wenn Sie einen aus der E-Mail-Adresse abgeleiteten Kandidaten in das Vornamensfeld des Kunden schreiben möchten. Die Geschlechtsvorhersage und die Änderung des Vornamens sind zwei getrennte Entscheidungen.
- Prüfen Sie die erzeugten Tags und das Metafeld des Kunden, bevor Sie sie in einem Segment verwenden. Stellen Sie sicher, dass die übrigen Kundeninformationen unverändert bleiben.
Die von der App verwendeten Kundenfelder kennen
Die folgenden Zuordnungen beschreiben den geprüften Quellcode der App. Prüfen Sie sie in der installierten App und an einer kontrollierten Stichprobe, bevor Sie einen nachgelagerten Workflow anbinden.
| Kundenfeld oder Einstellung | Richtung | Verhalten |
|---|---|---|
| Vorname | Eingabe | Bevorzugte Eingabe, wenn ein Vorname angegeben ist. |
| Eingabe | Dient dazu, einen Vornamenskandidaten abzuleiten, wenn der Vorname fehlt; eine Adresse ohne verwertbaren Namen kann ungeklärt bleiben. | |
| Land aus der Adresse | Optionaler Kontext | Die Verarbeitung kann das Land aus einer verfügbaren Kundenadresse als Kontext für die Abfrage nach Namen verwenden. |
| Kunden-Tags | Ausgabe | Die geprüfte Implementierung verwendet male, female oder gender_null und behält nicht zugehörige Tags bei. |
| custom.gender | Ausgabe | Metafeld des Kunden, das die abgeleitete Bezeichnung als einzeiligen Textwert enthält. |
| Aktualisierung des Vornamens | Optionale Ausgabe | Wenn aktiviert, kann ein aus der E-Mail-Adresse abgeleiteter Kandidat einen fehlenden Vornamen ergänzen; die Implementierung fügt first_name_found_from_email hinzu. |
| Automatische Anreicherung | App-Einstellung | Steuert die Verarbeitung von Ereignissen zu neuen Kunden; die Verfügbarkeit hängt vom Tarif und den App-Einstellungen ab. |
Tags, unbekannte Ergebnisse und bestehende Klassifizierungen prüfen
Öffnen Sie einen verarbeiteten Kunden in Shopify und vergleichen Sie seine Tags, custom.gender und den Vornamen mit dem ursprünglichen Eintrag. Verwenden Sie im Segment das tatsächlich geschriebene Feld und die tatsächliche Bezeichnung, statt anzunehmen, dass ein JSON-Pfad aus der API verfügbar ist.
Der geprüfte Ablauf überspringt Kunden, die bereits den Tag male, female oder gender_null haben. Ein unveränderter Eintrag kann daher eine bestehende Klassifizierung bedeuten und keine neue Abfrage. Legen Sie fest, wie Sie frühere Klassifizierungen prüfen, bevor Sie eine weitere Verarbeitung starten.
Behandeln Sie gender_null als ungeklärtes Ergebnis. Die nativen Zuordnungen liefern weder einen V2-Konfidenzwert noch ein Quellfeld oder einen usage-Eintrag pro Anfrage. Erfinden Sie diese Werte nicht in einem Tabellenexport und verwandeln Sie ein unbekanntes Ergebnis nicht in eine binäre Klassifizierung.
| Ergebnis | Empfohlener nächster Schritt |
|---|---|
| Erwarteter Tag und erwartetes Metafeld | Prüfen Sie die ID des Quellkunden und geben Sie nur das geplante Segment oder die geplante nachgelagerte Aktualisierung frei. |
| gender_null | Belassen Sie den Fall als ungeklärt und schließen Sie ihn von Regeln aus, die ein identified-Ergebnis erfordern. |
| Vorhandener Geschlechts-Tag | Prüfen Sie, ob die App den Kunden übersprungen hat, bevor Sie über eine erneute Verarbeitung entscheiden. |
| Fehlende oder uneinheitliche Aktualisierung | Prüfen Sie den Verarbeitungsstatus in der App, bevor Sie die gesamte Gruppe erneut starten. |
Tarif der App und Datenzugriff prüfen
Prüfen Sie die Limits für die Kundenverarbeitung auf dem aktuellen Tarif- und Guthabenbildschirm der Shopify-App. Die geprüfte App führt ein Credit-Guthaben pro Shop und wickelt Käufe über Shopify ab; sie wird nicht mit einem öffentlichen GenderAPI-API-Schlüssel konfiguriert. Prüfen Sie die aktuellen Preise auf der Seite der App, statt die Credit-Preise von V2 anzuwenden.
Die App benötigt Zugriff auf Kundendaten und kann Kundeneinträge bearbeiten. Ihre Verarbeitung umfasst eine Warteschlange auf Seiten der App. Angaben zur Speicherung von E-Mail-Anfragen sind daher nicht als Zusage zu verstehen, dass in diesem Workflow niemals Kundendaten gespeichert werden. Prüfen Sie die Berechtigungen der App und die veröffentlichte Richtlinie für Ihren Shop.
Eine abgeleitete Bezeichnung ist ein probabilistisches Signal in den Daten. Bewahren Sie sie getrennt von Angaben der Person selbst auf und verwenden Sie sie nicht als alleinige Grundlage für Entscheidungen über Berechtigungen, Zugang, Preise oder andere wesentliche Entscheidungen.
V2 verwenden, wenn Sie eine strukturierte Antwort benötigen
Für eine eigene Integration akzeptiert GenderAPI V2 Namen, E-Mail-Adressen und Benutzernamen und gibt ausdrückliche Felder für Ergebnis, Konfidenz, Quelle und Verbrauch zurück. Richten Sie diese Verbindung separat ein: Das Lesen des V2-Leitfadens ändert weder die installierte App noch ihre Ausgabespalten.
Die Beispiele in Python und Node.js behandeln Einzelanfragen, Batches, unknown-Ergebnisse und Betriebsfehler. Beginnen Sie mit dem Leitfaden zur Authentifizierung und wählen Sie den KI-Modus, bevor Sie eine kostenpflichtige Anfrage senden.
Häufige Fragen
Konfiguriere ich die Shopify-App mit meinem V2-API-Schlüssel?
Die geprüfte native App beruht auf der Installation in Shopify, eigenen Tarifeinstellungen und einem Guthaben pro Shop. Ein eigener HTTP-Workflow mit V2 ist eine separate Integration und ersetzt nicht die Einstellungen der nativen App.
Wo finde ich die abgeleitete Bezeichnung eines Kunden?
Die geprüfte App schreibt Kunden-Tags und das Kunden-Metafeld custom.gender. Prüfen Sie die installierte App und einen Beispielkunden, bevor Sie Segmente auf Grundlage dieser Werte erstellen.
Was bedeutet gender_null?
Dieser Wert kennzeichnet in der geprüften nativen App eine ungeklärte Bezeichnung. Belassen Sie einen solchen Kunden in der Gruppe der unbekannten Ergebnisse, statt den Wert in male oder female umzuwandeln.
Kann ich die Vornamen der Kunden unverändert lassen?
Prüfen Sie die Einstellung zur Ergänzung fehlender Vornamen unabhängig von der Geschlechtsverarbeitung. Aktivieren Sie sie nur, wenn die App einen fehlenden Vornamen mit einem aus der E-Mail-Adresse abgeleiteten Kandidaten ergänzen soll.
Quellendokumentation
Letzte Prüfung dieser Anleitung: . Prüfen Sie die Installation in der Dokumentation der Plattform und nutzen Sie für eine separate V2-Integration die verlinkte API-Dokumentation.