Namapujte příchozí záznamy na výsledkové sloupce
Doplněk GenderAPI nabízí obrazovku pro workflow, kde namapujete nové záznamy v tabulce na pohlaví a volitelné výsledkové sloupce. Nastavte workflow pro správný list a pak ověřte skutečný příchozí záznam dřív, než se na automatizaci začnete spoléhat.
Nativní workflow je oddělené od přímé akce HTTP s V2. Chování spouštěče, načasování a výsledková pole závisí na nainstalovaném doplňku a účtu Google. Okamžitá aktualizace není zaručena pro všechny zdroje nových řádků.
Vytvořte a otestujte workflow
- Nainstalujte a otevřete doplněk GenderAPI a potom v nabídce postranního panelu otevřete Workflows.
- Vyberte list a svůj API klíč. Zvolte analýzu name, email nebo username podle zdrojového sloupce.
- Namapujte zdrojový sloupec a samostatný cíl pro pohlaví. Cíle pro Probability, zemi a nalezené jméno přidejte, jen když je potřebujete.
- Před vytvořením workflow zkontrolujte všechna mapování. Rozhraní brání konfliktům sloupců a může ohlásit, že workflow už existuje nebo že byl dosažen limit počtu workflow.
- Přidejte reprezentativní záznam stejným mechanismem, jaký používají vaše produkční data. Ověřte, že se hodnoty objeví ve správném řádku a že se nepřepíše žádné existující pole.
- Otestujte nevyřešenou hodnotu a provozní chybu a potom rozhodněte, jak budete chybějící nebo neúspěšné řádky odhalovat a kontrolovat.
Nakonfigurujte pole nativního workflow
| Nastavení | Typ | Použití |
|---|---|---|
| API klíč | Přihlašovací údaj | Vyberte správný účet a ověřte dostupné kredity. |
| List | Výběr listu | List se záznamy, které má toto workflow zpracovávat. |
| Metoda | Volba | name, email nebo username. Zvolená metoda určuje, jak se vstup interpretuje. |
| Zdrojový sloupec | Odkaz na sloupec | Hodnota, která se má v každém záznamu analyzovat. |
| Sloupec pohlaví | Odkaz na sloupec | Cíl oddělený od vstupu i ostatních výsledků. |
| Probability, země, nalezené jméno | Volitelné cíle | Samostatné sloupce pro další výsledky doplňku. |
Otestujte, jak řádky skutečně přicházejí
Ruční zadání hodnoty, odeslání formuláře a import záznamů přes CRM jsou různé události. Dokumentace Googlu ke spouštěčům vysvětluje, že spuštění skriptů a požadavky API obvykle instalovatelné spouštěče neaktivují. Veřejná stránka doplňku neuvádí, jak přesně doplněk spouštěč implementuje, proto otestujte zdroj, který plánujete používat.
Nepředpokládejte, že workflow dodatečně zpracovalo existující řádky. Pro záměrné zpracování existujících řádků použijte postranní panel pro hromadné zpracování a veďte si evidenci o tom, které řádky už byly zpracovány.
Pokud očekávaná aktualizace chybí, zkontrolujte workflow, oprávnění, zůstatek klíče, mapování výsledků a chyby platformy dřív, než stejné záznamy odešlete znovu.
Jak číst výsledkové sloupce
Původní hodnotu ponechte vedle výsledku. Přiřazení na základě jména neurčuje pohlaví, které osoba sama uvedla, a vrácená země není ověřené bydliště ani státní příslušnost.
- Než zpracujete celou datovou sadu, prohlédněte si běžný výsledek, nejednoznačný vstup a neúspěšnou operaci.
- Prázdná buňka, text null a chyba vzorce jsou v tabulce různé hodnoty. Výsledky unknown normalizujte záměrně a chyby přitom neskrývejte.
- Pro neznámé nebo nejisté záznamy použijte neutrální záložní řešení. Údaje z profilu, které osoba sama uvedla, držte odděleně od odvozených sloupců.
| Výstup | Typický typ | Jak s ním pracovat |
|---|---|---|
| Gender | Text nebo nevyřešená hodnota | Hodnotu male nebo female ponechte jen u úspěšného výsledku. Nevyřešenou hodnotu zachovejte jako unknown a chybové texty kontrolujte zvlášť. |
| Probability | Číslo, pokud je k dispozici | Starší signál spolehlivosti. Nejde o pole confidence z V2 ani o naměřenou přesnost pro vaši datovou sadu. |
| Country | Text, pokud je k dispozici | Kontext vrácený vyhledáním. Uchovávejte ho odděleně od ověřené země zákazníka. |
| Found / normalized name | Text, pokud je k dispozici | Jméno použité nebo extrahované při zpracování. U nejednoznačných e-mailových adres a uživatelských jmen ho zkontrolujte. |
Naplánujte kredity, limity a opakovaná spuštění
Registrovaný bezplatný účet GenderAPI zahrnuje 200 kreditů za den. Kredity představují zůstatek účtu, nikoli příslib 200 úspěšných výsledků v každém workflow. Před spuštěním zkontrolujte zůstatek vybraného klíče a aktuální možnosti zpracování daného nástroje.
Nativní doplňky a souborové úlohy mají vlastní způsob zpracování. Limit dávkových požadavků v REST API V2, možnosti AI a pole účtování jednotlivých požadavků se na ně automaticky nevztahují. Opakované spuštění nebo přepočet může odeslat data ke zpracování znovu, proto nepředpokládejte, že je zdarma.
Začněte malým vzorkem, dokončené výsledky si ponechte a před opětovným spuštěním projděte neúspěšné řádky. Pokud potřebujete jen opravit pozdější export nebo aktualizaci v cílové aplikaci, použijte znovu výsledky, které už máte.
Kdy použít přímo API V2
Samostatnou integraci přes HTTP použijte, když vaše aplikace potřebuje explicitní možnosti AI a z V2 informace status, source, confidence_kind a usage pro každou položku. Řiďte se specifikací požadavku a odpovědi V2. Přidání názvů polí V2 do nativního vzorce nebo stávajícího doplňku chování tohoto klienta nezmění.
Časté otázky
Spustí každý import z CRM nativní workflow?
Nepředpokládejte to. Otestujte záznam ze skutečného CRM nebo automatizace. Google rozlišuje změny provedené uživateli, odeslané formuláře a aktualizace prováděné přes API a chování spouštěče v nainstalovaném doplňku je nutné ověřit.
Mohu zpracovat řádky, které už v listu byly?
Použijte postranní panel pro hromadné zpracování se záměrně vybraným rozsahem řádků. Vytvoření workflow pro nové řádky neznamená, že se existující záznamy zpracují dodatečně.
Kolik workflow mohu mít?
Rozhraní může zobrazit limit počtu workflow, tento návod však neuvádí neověřené číslo. Zkontrolujte aktuální doplněk a zastaralá workflow podle potřeby odstraňte.
Jak získám pole source a usage z V2?
Vytvořte samostatnou integraci s V2 přes HTTP, například podle zdokumentovaného postupu pro Make nebo Zapier. Nepředpokládejte, že nativní výsledkové sloupce obsahují strukturu odpovědi V2.
Zdroje a dokumentace
Průvodce byl naposledy zkontrolován . Instalaci ověřte v dokumentaci platformy a pro samostatnou integraci V2 použijte níže uvedenou dokumentaci API.