Käytä Shopify-sovellusta asiakastietojen rikastamiseen
GenderAPI:n Shopify-sovellus voi käsitellä olemassa olevia ja uusia asiakkaita, lisätä ennustetun sukupuolisignaalin ja päätellä puuttuvan etunimen sähköpostiosoitteesta. Aloita oikeasta Shopify-kaupasta ja valitse sovelluksen asetukset, jotka vastaavat päivitettäviä asiakaskenttiä.
Kyseessä on Shopifyn oma sovellus, jolla on omat käsittely- ja pakettiasetuksensa. Toteutus, joka tarkistettiin 27. syyskuuta 2026, ei kutsu julkista V2:n ennuste-endpointia. Älä oleta, että API-avainten saldot, V2:n tekoälyasetukset tai V2:n vastauskentät koskevat tätä sovellusta.
Valmistele kauppa ja päätä, mitä muutetaan
- Avaa Shopify App Storessa sovellus Gender API - Determine gender. Varmista ennen asennusta, että sivu on Ozan Softin julkaisema, ja tarkista kohdekauppa, nykyiset käyttöoikeudet ja paketti.
- Tarkista sovelluksen saldo ja asiakkaiden käsittelyasetukset. Päätä, käsitteletkö olemassa olevat tietueet, otatko käyttöön uusien asiakkaiden automaattisen käsittelyn vai molemmat.
- Tarkista pieni joukko asiakastietueita, joissa on annettuja etunimiä, puuttuvia etunimiä ja monitulkintaisia syötteitä. Pidä olemassa olevat nimet ja tunnisteet näkyvissä, kun tarkistat tuloksia.
- Ota puuttuvien etunimien täydentäminen käyttöön vain, jos haluat, että sähköpostiosoitteesta päätelty ehdokas kirjoitetaan asiakkaan etunimikenttään. Sukupuolen päätteleminen ja nimen muokkaaminen ovat erillisiä päätöksiä.
- Tarkista luodut tunnisteet ja asiakkaan metakenttä ennen kuin käytät niitä segmentissä. Varmista, että muut asiakastiedot säilyvät ennallaan.
Tutustu sovelluksen käyttämiin asiakaskenttiin
Seuraava kenttien yhdistäminen kuvaa tarkistettua sovelluksen lähdekoodia. Varmista se asennetussa sovelluksessasi ja hallitulla otoksella ennen kuin liität siihen jatkotyönkulun.
| Asiakaskenttä tai asetus | Suunta | Toiminta |
|---|---|---|
| Etunimi | Syöte | Ensisijainen nimisyöte, jos se on annettu. |
| Sähköpostiosoite | Syöte | Käytetään nimiehdokkaan päättelemiseen, kun etunimi puuttuu; osoite, josta ei saada käyttökelpoista nimeä, voi jäädä ratkaisemattomaksi. |
| Osoitteen maa | Valinnainen konteksti | Käsittely voi käyttää asiakkaan osoitteen maata nimihaun kontekstina, jos se on saatavilla. |
| Asiakkaan tunnisteet | Tuloste | Tarkasteltu toteutus käyttää tunnisteita male, female tai gender_null ja säilyttää muut tunnisteet ennallaan. |
| custom.gender | Tuloste | Asiakkaan metakenttä, johon päätelty luokitus tallentuu yksirivisenä tekstiarvona. |
| Etunimen päivitys | Valinnainen tuloste | Kun asetus on käytössä, sähköpostiosoitteesta päätelty ehdokas voi täyttää puuttuvan etunimen; toteutus lisää merkinnän first_name_found_from_email. |
| Automaattinen rikastaminen | Sovelluksen asetus | Ohjaa uusien asiakastapahtumien käsittelyä; saatavuus riippuu sovelluksen paketista ja asetuksista. |
Tarkista tunnisteet, tuntemattomat tulokset ja aiemmat luokitukset
Avaa käsitelty asiakas Shopifyssa ja vertaa sen tunnisteita, metakenttää custom.gender ja etunimeä alkuperäiseen tietueeseen. Käytä segmentissä todellista tallennettua kenttää ja luokitusta äläkä oleta, että API:n JSON-polku olisi käytettävissä.
Tarkasteltu taustaprosessi ohittaa asiakkaat, joilla on jo tunniste male, female tai gender_null. Muuttumaton tietue voi siksi tarkoittaa aiempaa luokitusta eikä uutta hakua. Päätä, miten aiemmat luokitukset tarkistetaan, ennen kuin käynnistät uuden ajon.
Pidä gender_null ratkaisemattomana. Sovelluksen oma kenttien yhdistäminen ei tuota V2:n luottamusarvoa, lähdekenttää eikä pyyntökohtaista tietoa krediittien käytöstä. Älä keksi näitä arvoja laskentataulukkoon viedyille tiedoille äläkä muuta tuntematonta tulosta binääriseksi luokitukseksi.
| Tulos | Suositeltu seuraava vaihe |
|---|---|
| Odotettu tunniste ja metakenttä | Tarkista lähdeasiakkaan asiakastunnus ja salli vain tarkoitettu segmentti tai jatkopäivitys. |
| gender_null | Pidä tulos ratkaisemattomana ja jätä asiakas pois säännöistä, jotka edellyttävät tulosta identified. |
| Olemassa oleva sukupuolitunniste | Tarkista, ohittiko sovellus asiakkaan, ennen kuin päätät käsitellä sen uudelleen. |
| Puuttuva tai odotuksista poikkeava päivitys | Tarkista toiminnon tila sovelluksessa ennen kuin ajat koko ryhmän uudelleen. |
Tarkista sovelluksen paketti ja pääsy tietoihin
Tarkista asiakkaiden käsittelyrajat Shopify-sovelluksen nykyisestä pakettinäkymästä ja saldosta. Tarkistettu sovellus ylläpitää kauppakohtaista krediittisaldoa ja käyttää Shopifyn ostoprosesseja; julkista GenderAPI:n API-avainta ei käytetä sen määrittämiseen. Tarkista nykyiset hinnat sovelluksen sivulta äläkä sovella V2:n krediittihinnastoa.
Sovellus tarvitsee pääsyn asiakastietoihin ja voi muokata asiakastietueita. Sen käsittelyyn kuuluu sovelluksen puolella toimiva jono, joten sähköpostihakujen säilyttämistä koskevaa lausumaa ei pidä tulkita lupaukseksi siitä, että asiakastietoja ei missään vaiheessa tallentuisi tämän työnkulun aikana. Tarkista sovelluksen käyttöoikeudet ja julkaistu käytäntö kauppasi osalta.
Päätelty luokitus on ennusteeseen perustuva datasignaali, johon liittyy aina epävarmuutta. Pidä se erillään henkilön itse ilmoittamista tiedoista äläkä käytä sitä yksinään kelpoisuutta, pääsyä, hinnoittelua tai muita merkittäviä päätöksiä varten.
Valitse API, kun tarvitset ohjelmallisen vastauksen
Omassa integraatiossa GenderAPI V2 hyväksyy nimiä, sähköpostiosoitteita ja käyttäjänimiä ja palauttaa erilliset kentät tulokselle, luottamusarvolle, lähteelle ja krediittien käytölle. Määritä tämä yhteys erikseen: V2-oppaan lukeminen ei muuta asennettua sovellusta tai sen tulossarakkeita.
Python- ja Node.js-esimerkit kattavat yksittäiset pyynnöt, eräpyynnöt, tuntemattomat tulokset ja toimintavirheet. Aloita todennusoppaasta ja valitse tekoälytila ennen kuin lähetät veloitettavan pyynnön.
Usein kysytyt kysymykset
Määritänkö Shopify-sovelluksen V2:n API-avaimellani?
Tarkistettu sovellus käyttää Shopify-asennusta, omia pakettiasetuksiaan ja kauppakohtaista saldoa. Oma V2:n HTTP-työnkulku on erillinen integraatio, eikä se korvaa sovelluksen omia asetuksia.
Mistä löydän asiakkaan päätellyn luokituksen?
Tarkistettu sovellus kirjoittaa asiakkaan tunnisteet ja asiakkaan metakentän custom.gender. Tarkista asennettu sovellus ja esimerkkiasiakas ennen kuin rakennat segmenttejä näiden arvojen perusteella.
Mitä gender_null tarkoittaa?
Se on ratkaisematon luokitus tarkastellussa sovelluksessa. Pidä asiakas tuntemattomien tulosten ryhmässä äläkä muuta arvoa muotoon male tai female.
Voinko jättää asiakkaiden nimet ennalleen?
Arvioi puuttuvien etunimien täydentämisen asetus erillään sukupuolen käsittelystä. Ota se käyttöön vain, jos haluat sovelluksen täyttävän puuttuvan etunimen sähköpostiosoitteesta päätellyllä ehdokkaalla.
Lähteet ja dokumentaatio
Opas tarkistettiin viimeksi . Tarkista asennus alustan dokumentaatiosta ja käytä erillisessä V2-integraatiossa alla olevaa API-dokumentaatiota.