Dokumentacja

Integracje

Sklepy internetowe

Połącz Shopify, WooCommerce, Magento 2, Shoptet lub BiznisWeb, aby dodać zamówienia, produkty, klientów i marżę do domeny oraz zapisywać linki wewnętrzne w swoim sklepie.

Dla sklepu pytaniem stojącym za każdą metryką widoczności jest to, czy to się sprzedaje. Połączenie sklepu wprowadza zamówienia, przychody, produkty i klientów do tej samej domeny co Twoje cytowania AI, ruch z wyszukiwarek i wydatki na reklamy. Odblokowuje to raporty Sklepu (zysk, koszty, produkty, klienci, rynki) i pozwala oceniać platformy reklamowe względem zamówień, które faktycznie dotarły, a nie konwersji, które deklarują.

Integracje e-commerce są dostępne od planu Pro. Zobacz plany i limity.

Połącz swój sklep#

Wszystkie pięć łączysz z poziomu Źródeł danych, w sekcji Eshops. Integracje mogą łączyć tylko administratorzy przestrzeni roboczej. Każdy sklep jest łączony poświadczeniami z jego własnego panelu administracyjnego; karty pokazują, skąd je wziąć.

Shopify

Shopify wymaga, aby instalacje aplikacji zaczynały się w Shopify App Store.

  1. Kliknij Connect Shopify Store. Zostaniesz przeniesiony do aplikacji FlowHunt w Shopify App Store.
  2. Kliknij Add app, zaloguj się do panelu Shopify, jeśli zostaniesz poproszony, przejrzyj i zaakceptuj uprawnienia.
  3. Dokończ instalację, aby połączyć sklep.

Jeśli nic się nie otwiera, przeglądarka zablokowała wyskakujące okno; zezwól na nie lub otwórz link do App Store pokazany w oknie.

WooCommerce

  1. W panelu administracyjnym WordPress przejdź do WooCommerce → Settings → Advanced → REST API.
  2. Kliknij Add key, nadaj mu opis i ustaw Permissions na Read.
  3. Kliknij Generate API key i skopiuj consumer key oraz consumer secret (sekret jest pokazywany tylko raz).
  4. W AmICited wpisz Store URL (dołącz podkatalog, jeśli WordPress jest w jednym z nich, na przykład https://example.com/shop), Consumer key i Consumer secret, a następnie kliknij Connect WooCommerce.

Sklep musi być osiągalny przez HTTPS; WooCommerce ignoruje klucze API wysyłane zwykłym HTTP.

Magento 2

  1. W panelu Admin Magento 2 przejdź do System → Extensions → Integrations i kliknij Add New Integration.
  2. Nazwij ją (na przykład „FlowHunt”). Na karcie API ustaw Resource Access na All lub przyznaj co najmniej Sales, Catalog, Customers, Stores i Catalog Inventory.
  3. Zapisz i kliknij Activate.
  4. Skopiuj wszystkie cztery poświadczenia OAuth (Consumer Key, Consumer Secret, Access Token, Access Token Secret) i wpisz je w AmICited wraz z Magento Store URL (bez /admin).

Jeśli sklep jest za HTTP Basic Auth, wypełnij też oba opcjonalne pola Basic Auth.

Shoptet

  1. W administracji e-sklepu przejdź do Connections → Private API.
  2. Kliknij Add, wpisz opis i zostaw włączoną każdą grupę endpointów.
  3. Odkryj token, potwierdź hasłem i skopiuj go.
  4. Wklej go jako API token (zaczyna się od ID Twojego e-sklepu, np. 123456-p-…) i kliknij Connect Shoptet.

Private API jest dostępne wyłącznie w taryfie Shoptet Premium.

BiznisWeb

  1. Zaloguj się do panelu administracyjnego BiznisWeb i przejdź do Settings → API Access.
  2. Utwórz nowy token API z odpowiednimi uprawnieniami.
  3. W AmICited wpisz API Token, API Domain (własna domena Twojego sklepu, na przykład www.yourshop.sk) i Flox Subdomain używaną do uwierzytelniania (na przykład yourshop.flox.sk), a następnie kliknij Connect BiznisWeb.

Po zapisaniu poświadczeń kliknij Select account na karcie, aby zmapować sklep na domenę, a następnie wybierz, ile historii zamówień zaimportować. Najdłuższa opcja importuje wszystko od pierwszego zamówienia sklepu; każda opcja pokazuje przewidywaną liczbę wierszy i jednorazowy koszt przed potwierdzeniem.

Dane klientów: zanonimizowane lub pełne#

Przed pierwszym importem wybierasz, co import może przechowywać o osobach kupujących. Trzeba to ustalić z góry: dotyczy to już zaimportowanych zamówień, więc późniejsza zmiana oznacza odłączenie i ponowne połączenie sklepu.

  • Zanonimizowane (domyślnie). Żaden e-mail, imię ani adres nigdy nie trafia do hurtowni. Klient to jednokierunkowy skrót jego e-maila: wystarczy, by go policzyć, śledzić jego zamówienia i segmentować, ale nie wystarczy, by się z nim skontaktować.
  • Import full customer data. Przechowuje e-mail i imię wraz z zamówieniem, aby segment dało się wyeksportować i na nim działać. To dane osobowe, przechowywane zgodnie z zasadami retencji Twojej przestrzeni roboczej.

Każdy raport działa w obu przypadkach.

Ustawienia sklepu#

Liczby są tak dobre, jak koszty, które za nimi stoją. Otwórz Shop settings na karcie sklepu, aby ustawić:

  • Currency. Walutę, w której raportowane jest wszystko w domenie, i kursy wymiany użyte do jej osiągnięcia.
  • Cost inputs. Ile kosztuje każde zamówienie poza towarem, w podziale na okresy: netto wysyłka i pakowanie na zamówienie, opłata za płatność w %, koszty stałe miesięcznie i zakładana marża. Inne koszty (kampania, agencja, rok oprogramowania) można zapisać i rozłożyć na ich okres. Dopóki nie istnieje co najmniej jeden okres, nie da się obliczyć wkładu i zysku.
  • Product costs. Ile kosztował zakup każdego produktu, co zamienia przychód w marżę.
  • Order statuses. Które statusy sklepu liczą się jako sprzedaż.
  • Payment methods. Które metody niosą opłatę i jak dużą.

Strona Shop connection pokazuje, co zostało zaimportowane i czego jeszcze brakuje, zanim raporty sklepu będą miały prawdziwe liczby. Data health (w raportach) pokazuje, jaka część każdej liczby jest zmierzona, a jaka założona.

Co to odblokowuje#

Raporty → Sklep zawiera około 25 raportów, pogrupowanych jako:

  • Earnings. Cockpit (zysk, co go zmieniło, czy jesteśmy zgodnie z planem), Sales engine, Economics.
  • Costs. Cost mix, Pages and ad spend, Marketing & ads, CAC & ROAS, Cross-source reports.
  • Ads and the shop. Attribution reality (deklaracje Meta względem zamówień, które dotarły), Profit-true ROAS, New-customer CAC, Audience efficiency, Dayparting, Profit scaling. Wymagają połączonego Meta Ads.
  • Products. Products, Assortment, Product bundles, Entry products.
  • Customers. Retention, Repeat purchase, Lifetime value, Segments, Replenishment (kto powinien ponowić zamówienie).
  • Markets and timing. Geography, Geo profitability, Calendar, Weather.
  • Operations and data. Metric library, Order mix, Data health.

Zamówienia ze sklepu zasilają też oczekiwania adnotacji dla e-commerce (zamówienia, przychód netto, AOV, ROAS, zysk firmy), a Audyt → Budowanie linków zapisuje linki wewnętrzne w Twoim sklepie: każda reguła wskazuje słowo kluczowe i cel, a linki są dodawane do treści produktów, kolekcji, stron i artykułów przy każdym zastosowaniu i usuwane, gdy reguła zostanie wstrzymana lub usunięta.

Koszt i odłączanie#

Jak każde źródło danych: jednorazowy import rozliczany według zachowanych wierszy (1 kredyt za milion wierszy) i stała dzienna opłata za hurtownię za każdą połączoną domenę, ustalona przez Twój plan, obie pokazywane przed potwierdzeniem. Disconnect zatrzymuje import i usuwa zaimportowane dane; nie można tego cofnąć. Zobacz kredyty.

Powiązane#