Dokumentácia

Integrácie

E-shopy

Pripojte Shopify, WooCommerce, Magento 2, Shoptet alebo BiznisWeb, aby ste do domény pridali objednávky, produkty, zákazníkov a maržu a mohli zapisovať interné odkazy do svojho obchodu.

Pri obchode je otázkou za každou metrikou viditeľnosti to, či sa predáva. Pripojenie obchodu prináša objednávky, tržby, produkty a zákazníkov do rovnakej domény ako vaše AI citácie, vyhľadávacia návštevnosť a výdavky na reklamu. Tým sa odomknú reporty Eshop (zisk, náklady, produkty, zákazníci, trhy) a reklamné platformy sa dajú posudzovať podľa objednávok, ktoré skutočne pristáli, a nie podľa konverzií, ktoré si pripisujú.

Integrácie e-shopov sú dostupné od plánu Pro. Pozrite si plány a limity.

Pripojte svoj obchod#

Všetkých päť sa pripája zo Zdroje údajov, v časti Eshops. Integrácie môžu pripájať len správcovia workspaceu. Každý obchod sa pripája prístupovými údajmi z vlastnej administrácie; karty ukazujú, kde ich získať.

Shopify

Shopify vyžaduje, aby inštalácie aplikácií začínali v Shopify App Store.

  1. Kliknite na Connect Shopify Store. Presmeruje vás na aplikáciu FlowHunt v Shopify App Store.
  2. Kliknite na Add app, ak sa zobrazí výzva, prihláste sa do administrácie Shopify, skontrolujte a odsúhlaste oprávnenia.
  3. Dokončite inštaláciu a obchod sa pripojí.

Ak sa nič neotvorí, váš prehliadač zablokoval vyskakovacie okno; povoľte ho alebo otvorte odkaz na App Store zobrazený v dialógu.

WooCommerce

  1. V administrácii WordPress prejdite na WooCommerce → Settings → Advanced → REST API.
  2. Kliknite na Add key, zadajte popis a nastavte Permissions na Read.
  3. Kliknite na Generate API key a skopírujte consumer key a consumer secret (secret sa zobrazí len raz).
  4. V AmICited zadajte Store URL (vrátane podadresára, ak WordPress beží v jednom, napríklad https://example.com/shop), Consumer key a Consumer secret a kliknite na Connect WooCommerce.

Obchod musí byť dostupný cez HTTPS; WooCommerce ignoruje API kľúče odoslané cez obyčajné HTTP.

Magento 2

  1. V administrácii Magento 2 prejdite na System → Extensions → Integrations a kliknite na Add New Integration.
  2. Pomenujte ju (napríklad „FlowHunt“). Na karte API nastavte Resource Access na All alebo udeľte aspoň Sales, Catalog, Customers, Stores a Catalog Inventory.
  3. Uložte a kliknite na Activate.
  4. Skopírujte všetky štyri prístupové údaje OAuth (Consumer Key, Consumer Secret, Access Token, Access Token Secret) a zadajte ich v AmICited spolu s Magento Store URL (bez /admin).

Ak je obchod za HTTP Basic Auth, vyplňte aj obe voliteľné polia Basic Auth.

Shoptet

  1. V administrácii e-shopu prejdite na Connections → Private API.
  2. Kliknite na Add, zadajte popis a nechajte zapnutú každú skupinu endpointov.
  3. Zobrazte token, potvrďte heslom a skopírujte ho.
  4. Vložte ho ako API token (začína ID vášho e-shopu, napríklad 123456-p-…) a kliknite na Connect Shoptet.

Private API je dostupné len v tarife Shoptet Premium.

BiznisWeb

  1. Prihláste sa do administrácie BiznisWeb a prejdite na Settings → API Access.
  2. Vytvorte nový API token s primeranými oprávneniami.
  3. V AmICited zadajte API Token, API Domain (vlastná doména vášho obchodu, napríklad www.yourshop.sk) a Flox Subdomain používanú na autentifikáciu (napríklad yourshop.flox.sk) a kliknite na Connect BiznisWeb.

Po uložení prístupových údajov kliknite na karte na Select account, aby ste obchod namapovali na doménu, a potom vyberte, koľko histórie objednávok importovať. Najdlhšia možnosť importuje všetko od prvej objednávky obchodu; každá možnosť ukazuje predpokladaný počet riadkov a jednorazovú cenu pred potvrdením.

Dáta o zákazníkoch: anonymizované alebo úplné#

Pred prvým importom si vyberiete, čo môže import ukladať o ľuďoch, ktorí nakupujú. Musí sa to rozhodnúť vopred: týka sa to už importovaných objednávok, takže neskoršia zmena znamená odpojiť obchod a pripojiť ho znova.

  • Anonymised (predvolené). Do skladu sa nikdy nedostane e-mail, meno ani adresa. Zákazník je jednosmerný hash jeho e-mailu: stačí na ich spočítanie, sledovanie ich objednávok a segmentáciu, nestačí na ich kontaktovanie.
  • Import full customer data. Ukladá e-mail a meno s objednávkou, takže segment možno exportovať a konať na jeho základe. Ide o osobné údaje, uchovávané podľa pravidiel uchovávania vášho workspaceu.

Každý report funguje v oboch prípadoch.

Nastavenia obchodu#

Čísla sú len také dobré ako náklady za nimi. Otvorte Shop settings na karte obchodu a nastavte:

  • Currency. Mena, v ktorej sa všetko v doméne vykazuje, a výmenné kurzy použité na jej dosiahnutie.
  • Cost inputs. Čo stojí každá objednávka okrem tovaru, za obdobie: čisté poštovné a balenie na objednávku, poplatok za platbu v %, fixné náklady mesačne a predpokladaná marža. Ďalšie náklady (kampaň, agentúra, ročný softvér) možno zaznamenať a rozložiť na ich obdobie. Kým neexistuje aspoň jedno obdobie, príspevok a zisk sa nedajú vypočítať.
  • Product costs. Koľko stálo nakúpiť každý produkt, čo mení tržby na maržu.
  • Order statuses. Ktoré stavy obchodu sa počítajú ako predaj.
  • Payment methods. Ktoré spôsoby nesú poplatok a aký.

Stránka Shop connection ukazuje, čo sa importovalo a čo ešte chýba, kým budú mať reporty e-shopu skutočné čísla. Data health (v reportoch) ukazuje, koľko z každého čísla je zmeraného oproti predpokladanému.

Čo to odomkne#

Reporty → Eshop obsahuje asi 25 reportov, zoskupených ako:

  • Earnings. Cockpit (zisk, čo ho pohlo, sme podľa plánu), Sales engine, Economics.
  • Costs. Cost mix, Pages and ad spend, Marketing & ads, CAC & ROAS, Cross-source reports.
  • Ads and the shop. Attribution reality (tvrdenia Meta oproti objednávkam, ktoré pristáli), Profit-true ROAS, New-customer CAC, Audience efficiency, Dayparting, Profit scaling. Vyžadujú pripojené Meta Ads.
  • Products. Products, Assortment, Product bundles, Entry products.
  • Customers. Retention, Repeat purchase, Lifetime value, Segments, Replenishment (kto má na rade opätovnú objednávku).
  • Markets and timing. Geography, Geo profitability, Calendar, Weather.
  • Operations and data. Metric library, Order mix, Data health.

Objednávky obchodu napájajú aj očakávania anotácií pre e-shop (objednávky, čisté tržby, AOV, ROAS, zisk firmy) a Audit → Link building zapisuje interné odkazy do vášho obchodu: každé pravidlo pomenúva kľúčové slovo a cieľ a odkazy sa pri každom uplatnení pridávajú do textov produktov, kolekcií, stránok a článkov a odstránia sa, keď sa pravidlo pozastaví alebo zmaže.

Cena a odpojenie#

Rovnako ako pri každom zdroji údajov: jednorazový import účtovaný podľa uchovaných riadkov (1 kredit za milión riadkov) a paušálny denný poplatok za dátový sklad za každú pripojenú doménu určený vaším plánom, oboje zobrazené pred potvrdením. Disconnect zastaví import a zmaže importované dáta; nemožno to vrátiť späť. Pozrite si kredity.

Súvisiace#