Yhdistä saapuvat tietueet tulossarakkeisiin
GenderAPI-lisäosassa on työnkulkunäkymä, jossa laskentataulukon uudet tietueet yhdistetään sukupuolen ja valinnaisten tulosten sarakkeisiin. Määritä työnkulku oikealle taulukolle ja tarkista sitten todellinen saapuva tietue ennen kuin luotat automaatioon.
Lisäosan oma työnkulku on erillään suorasta V2:n HTTP-toiminnosta. Käynnistimen toiminta, ajoitus ja tuloskentät riippuvat asennetusta lisäosasta ja Google-tilistä. Välitöntä päivitystä ei taata kaikille uusien rivien lähteille.
Luo ja testaa työnkulku
- Asenna ja avaa GenderAPI-lisäosa ja avaa sitten sivupaneelin valikosta Workflows.
- Valitse taulukko ja API-avaimesi. Valitse analyysitavaksi name, email tai username lähdesarakkeen mukaan.
- Yhdistä lähdesarake ja erillinen sukupuolen kohdesarake. Lisää kohdesarakkeet Probability-arvolle, maalle ja löydetylle nimelle vain tarvittaessa.
- Tarkista kaikki sarakkeiden yhdistämiset ennen työnkulun luomista. Käyttöliittymä estää sarakeristiriidat ja voi ilmoittaa, että työnkulku on jo olemassa tai että työnkulkujen enimmäismäärä on saavutettu.
- Lisää edustava tietue samalla tavalla kuin tuotantotietosi saapuvat. Varmista, että arvot näkyvät oikealla rivillä eikä mitään olemassa olevaa kenttää korvata.
- Testaa ratkaisematon arvo ja toimintavirhe ja päätä sitten, miten havaitset ja tarkistat puuttuvat tai epäonnistuneet rivit.
Määritä lisäosan työnkulun kentät
| Asetus | Tyyppi | Käyttö |
|---|---|---|
| API-avain | Tunnistetieto | Valitse oikea tili ja varmista käytettävissä olevat krediitit. |
| Taulukko | Taulukon valinta | Taulukko, jonka tietueita tämä työnkulku käsittelee. |
| Syötetapa | Valinta | name, email tai username. Valittu tapa määrää, miten syöte tulkitaan. |
| Lähdesarake | Sarakeviittaus | Arvo, joka analysoidaan jokaisesta tietueesta. |
| Sukupuolisarake | Sarakeviittaus | Kohde, joka on erillään syötteestä ja muista tuloksista. |
| Probability, maa, löydetty nimi | Valinnaiset kohteet | Erilliset sarakkeet lisäosan lisätuloksille. |
Testaa, miten rivit todella saapuvat
Arvon kirjoittaminen, lomakkeen lähettäminen ja tietueiden tuonti CRM-järjestelmästä ovat eri tapahtumia. Googlen käynnistimiä koskeva dokumentaatio kertoo, että skriptien suoritukset ja API-pyynnöt eivät yleensä laukaise asennettavia käynnistimiä. Lisäosan julkinen sivu ei kerro, miten sen käynnistin on tarkalleen toteutettu, joten testaa lähde, jota aiot käyttää.
Älä oleta, että työnkulku on käsitellyt olemassa olevat rivit jälkikäteen. Käytä olemassa olevien rivien harkittuun käsittelyyn joukkokäsittelyn sivupaneelia ja pidä kirjaa siitä, mitkä rivit on jo käsitelty.
Jos odotettu päivitys puuttuu, tarkista työnkulku, käyttöoikeudet, avaimen saldo, tulossarakkeiden yhdistäminen ja alustan virheet ennen kuin lähetät samat tietueet uudelleen.
Näin luet tulossarakkeet
Säilytä alkuperäinen syöte tuloksen vieressä. Nimeen perustuva yhteys ei osoita henkilön itse ilmoittamaa sukupuolta, eikä palautettu maa ole vahvistettu asuinmaa tai kansalaisuus.
- Tarkastele tavallista tulosta, monitulkintaista syötettä ja epäonnistunutta toimintoa ennen kuin käsittelet koko tietoaineiston.
- Tyhjä solu, teksti null ja kaavavirhe ovat laskentataulukossa eri arvoja. Yhtenäistä tuntemattomat tulokset (unknown) harkitusti äläkä piilota virheitä.
- Käytä neutraalia oletusvaihtoehtoa tuntemattomille tai epävarmoille tietueille. Pidä henkilön itse antamat profiilitiedot erillään päätellyistä sarakkeista.
| Tulos | Tyypillinen tyyppi | Näin käytät sitä |
|---|---|---|
| Gender | Teksti tai ratkaisematon arvo | Pidä arvo male tai female vain onnistuneissa tuloksissa. Säilytä ratkaisematon arvo arvona unknown ja tarkista virhetekstit erikseen. |
| Probability | Luku, jos saatavilla | Vanha luottamussignaali. Se ei ole V2:n kenttä confidence eikä tietoaineistollesi mitattu tarkkuus. |
| Country | Teksti, jos saatavilla | Haun palauttama konteksti. Pidä se erillään asiakkaan vahvistetusta maasta. |
| Found / normalized name | Teksti, jos saatavilla | Käsittelyssä käytetty tai poimittu nimi. Tarkista se, kun sähköpostiosoite tai käyttäjänimi on monitulkintainen. |
Suunnittele krediitit, rajoitukset ja uudet ajot
Rekisteröity maksuton GenderAPI-tili saa 200 krediittiä joka päivä. Krediitit ovat tilin saldoa, eivätkä ne lupaa 200 onnistunutta tulosta jokaisessa työnkulussa. Tarkista valitun avaimen saldo ja työkalun nykyiset käsittelyvaihtoehdot ennen aloittamista.
Natiiveilla lisäosilla ja tiedostotehtävillä on omat käsittelytapansa. REST API V2:n eräpyynnön enimmäiskoko, tekoälyasetukset ja pyyntökohtaiset laskutuskentät eivät automaattisesti koske niitä. Uusi ajo tai uudelleenlaskenta voi lähettää tiedot käsiteltäviksi uudelleen, joten älä oleta sen olevan maksuton.
Aloita pienellä otoksella, säilytä valmiit tulokset ja käy epäonnistuneet rivit läpi ennen uutta ajoa. Jos sinun tarvitsee vain korjata myöhempi vienti tai kohdesovelluksen päivitys, käytä uudelleen jo saamiasi tuloksia.
Milloin käyttää API V2:ta suoraan
Käytä erillistä HTTP-integraatiota, kun sovelluksesi tarvitsee V2:n tekoälyasetuksia erikseen määritettyinä sekä kohdekohtaiset tiedot status, source, confidence_kind ja usage. Noudata V2:n pyyntö- ja vastausmäärittelyä. V2:n kenttänimien lisääminen natiiviin kaavaan tai nykyiseen lisäosaan ei muuta kyseisen asiakasohjelman toimintaa.
Usein kysytyt kysymykset
Käynnistääkö jokainen CRM-tuonti lisäosan työnkulun?
Älä oleta niin. Testaa tietue todellisesta CRM-järjestelmästä tai automaatiosta. Google erottaa käyttäjien muokkaukset, lomakkeiden lähetykset ja API:n kautta tehdyt päivitykset, ja asennetun lisäosan käynnistimen toiminta on tarkistettava.
Voinko käsitellä rivejä, jotka olivat taulukossa jo valmiiksi?
Käytä joukkokäsittelyn sivupaneelia ja harkiten valittua rivialuetta. Uusien rivien työnkulun luominen ei tarkoita, että olemassa olevat tietueet käsitellään jälkikäteen.
Mikä on työnkulkujen enimmäismäärä?
Käyttöliittymä voi ilmoittaa työnkulkujen enimmäismäärästä, mutta tässä ohjeessa ei mainita vahvistamatonta lukua. Tarkista nykyinen lisäosa ja poista tarpeettomat työnkulut tarvittaessa.
Miten saan V2:n kentät source ja usage?
Luo erillinen V2:n HTTP-integraatio, esimerkiksi Make- tai Zapier-palvelulle dokumentoidun ohjeen mukaan. Älä oleta, että lisäosan tulossarakkeet sisältävät V2:n vastauskehyksen.
Lähteet ja dokumentaatio
Opas tarkistettiin viimeksi . Tarkista asennus alustan dokumentaatiosta ja käytä erillisessä V2-integraatiossa alla olevaa API-dokumentaatiota.