Dokumentace

Integrace

E-shopy

Připojte Shopify, WooCommerce, Magento 2, Shoptet nebo BiznisWeb, abyste k doméně přidali objednávky, produkty, zákazníky a marži a mohli do svého obchodu zapisovat interní odkazy.

U obchodu je otázkou za každou metrikou viditelnosti to, zda se prodává. Připojení vašeho obchodu přináší objednávky, tržby, produkty a zákazníky do stejné domény jako vaše AI citace, vyhledávací provoz a výdaje na reklamu. To odemyká reporty Eshop (zisk, náklady, produkty, zákazníci, trhy) a umožňuje posuzovat reklamní platformy podle objednávek, které skutečně dorazily, místo konverzí, které si připisují.

Integrace e-shopů jsou dostupné od tarifu Pro. Viz tarify a limity.

Připojte svůj obchod#

Všech pět se připojuje z Data Sources, pod Eshops. Integrace mohou připojovat jen administrátoři workspace. Každý obchod se připojuje přihlašovacími údaji z jeho vlastní administrace; záložky ukazují, kde je získat.

Shopify

Shopify vyžaduje, aby instalace aplikací začínaly v obchodě Shopify App Store.

  1. Klikněte na Connect Shopify Store. Budete přesměrováni na aplikaci FlowHunt v Shopify App Store.
  2. Klikněte na Add app, v případě výzvy se přihlaste do administrace Shopify, zkontrolujte a přijměte oprávnění.
  3. Dokončete instalaci a obchod se připojí.

Pokud se nic neotevře, váš prohlížeč zablokoval vyskakovací okno; povolte je nebo otevřete odkaz na App Store zobrazený v dialogu.

WooCommerce

  1. V administraci WordPress přejděte na WooCommerce → Settings → Advanced → REST API.
  2. Klikněte na Add key, zadejte popis a nastavte Permissions na Read.
  3. Klikněte na Generate API key a zkopírujte consumer key a consumer secret (secret se zobrazí jen jednou).
  4. V AmICited zadejte Store URL (včetně podadresáře, pokud WordPress žije v jednom, například https://example.com/shop), Consumer key a Consumer secret a klikněte na Connect WooCommerce.

Obchod musí být dostupný přes HTTPS; WooCommerce ignoruje klíče API odeslané přes prosté HTTP.

Magento 2

  1. V Adminu Magento 2 přejděte na System → Extensions → Integrations a klikněte na Add New Integration.
  2. Pojmenujte ji (například “FlowHunt”). Na záložce API nastavte Resource Access na All, nebo udělte alespoň Sales, Catalog, Customers, Stores a Catalog Inventory.
  3. Uložte a klikněte na Activate.
  4. Zkopírujte všechny čtyři přihlašovací údaje OAuth (Consumer Key, Consumer Secret, Access Token, Access Token Secret) a zadejte je v AmICited spolu s Magento Store URL (bez /admin).

Pokud je obchod za HTTP Basic Auth, vyplňte také obě volitelná pole Basic Auth.

Shoptet

  1. V administraci e-shopu přejděte na Connections → Private API.
  2. Klikněte na Add, zadejte popis a ponechte povolenou každou skupinu endpointů.
  3. Zobrazte token, potvrďte heslem a zkopírujte jej.
  4. Vložte jej jako API token (začíná ID vašeho e-shopu, například 123456-p-…) a klikněte na Connect Shoptet.

Private API je dostupné jen v tarifu Shoptet Premium.

BiznisWeb

  1. Přihlaste se do administrace BiznisWeb a přejděte na Settings → API Access.
  2. Vytvořte nový token API s příslušnými oprávněními.
  3. V AmICited zadejte API Token, API Domain (vlastní doména vašeho obchodu, například www.yourshop.sk) a Flox Subdomain používanou pro autentizaci (například yourshop.flox.sk) a klikněte na Connect BiznisWeb.

Po uložení přihlašovacích údajů klikněte na kartě na Select account, abyste obchod namapovali na doménu, a poté zvolte, kolik historie objednávek importovat. Nejdelší možnost importuje vše od první objednávky obchodu; každá možnost před potvrzením ukazuje předpokládané řádky a jednorázovou cenu.

Data o zákaznících: anonymizovaná nebo úplná#

Před prvním importem zvolíte, co smí import o lidech, kteří nakupují, ukládat. Musí se odpovědět předem: týká se objednávek, které se už importovaly, takže pozdější změna znamená obchod odpojit a připojit znovu.

  • Anonymised (výchozí). Do datového skladu se nikdy nedostane e-mail, jméno ani adresa. Zákazník je jednosměrný hash svého e-mailu: dost na to, abyste je spočítali, sledovali jejich objednávky a segmentovali je, ale ne na to, abyste je kontaktovali.
  • Import full customer data. Ukládá s objednávkou e-mail a jméno, takže lze segment exportovat a jednat na jeho základě. Jsou to osobní údaje, uchovávané podle pravidel uchovávání vašeho workspace.

Každý report funguje v obou případech.

Nastavení obchodu#

Čísla jsou jen tak dobrá jako náklady za nimi. Otevřete Shop settings na kartě obchodu a nastavte:

  • Currency. Měna, ve které se vše na doméně vykazuje, a směnné kurzy použité k jejímu dosažení.
  • Cost inputs. Co každá objednávka stojí navíc k zboží, za období: čisté poštovné a balné na objednávku, poplatek za platbu v %, fixní náklady za měsíc a předpokládaná marže. Další náklady (kampaň, agentura, roční software) lze zaznamenat a rozložit na jejich období. Dokud neexistuje alespoň jedno období, nelze spočítat příspěvek a zisk.
  • Product costs. Kolik stál každý produkt při nákupu, což mění tržby v marži.
  • Order statuses. Které stavy obchodu se počítají jako prodej.
  • Payment methods. Které metody nesou poplatek a jak velký.

Stránka Shop connection ukazuje, co bylo importováno a co ještě chybí, než budou reporty e-shopu mít skutečná čísla. Data health (v reportech) ukazuje, kolik každého čísla je změřeno oproti předpokládanému.

Co to odemyká#

Reports → Eshop obsahuje asi 25 reportů, seskupených jako:

  • Earnings. Cockpit (zisk, co jej pohnulo, držíme plán), Sales engine, Economics.
  • Costs. Cost mix, Pages and ad spend, Marketing & ads, CAC & ROAS, Cross-source reports.
  • Ads and the shop. Attribution reality (tvrzení Meta proti dorazivším objednávkám), Profit-true ROAS, New-customer CAC, Audience efficiency, Dayparting, Profit scaling. Vyžadují připojené Meta Ads.
  • Products. Products, Assortment, Product bundles, Entry products.
  • Customers. Retention, Repeat purchase, Lifetime value, Segments, Replenishment (kdo má čas na opakovanou objednávku).
  • Markets and timing. Geography, Geo profitability, Calendar, Weather.
  • Operations and data. Metric library, Order mix, Data health.

Objednávky z obchodu také napájejí očekávání anotací pro e-commerce (objednávky, čisté tržby, AOV, ROAS, zisk společnosti) a Audit → Link building zapisuje interní odkazy do vašeho obchodu: každé pravidlo uvádí klíčové slovo a cíl a odkazy se při každém použití přidávají do textů produktů, kolekcí, stránek a článků a odstraňují se, když je pravidlo pozastaveno nebo smazáno.

Cena a odpojení#

Jako každý zdroj dat: jednorázový import účtovaný podle uchovaných řádků (1 kredit za milion řádků) a paušální denní poplatek za datový sklad za každou připojenou doménu podle vašeho tarifu, obojí zobrazeno před potvrzením. Disconnect zastaví import a smaže importovaná data; nelze vrátit zpět. Viz kredity.

Související#