Integrazioni
Store ecommerce
Collega Shopify, WooCommerce, Magento 2, Shoptet o BiznisWeb per aggiungere a un dominio ordini, prodotti, clienti e margine, e per scrivere link interni nel tuo store.
Per uno shop, la domanda dietro ogni metrica di visibilità è se genera vendite. Collegare il tuo store porta ordini, ricavi, prodotti e clienti nello stesso dominio delle tue citazioni AI, del traffico di ricerca e della spesa pubblicitaria. Questo sblocca i report Eshop (profitto, costi, prodotti, clienti, mercati) e permette di valutare le piattaforme pubblicitarie in base agli ordini realmente arrivati e non alle conversioni che dichiarano.
Le integrazioni ecommerce sono disponibili dal piano Pro. Vedi piani e limiti.
Collega il tuo store#
Tutti e cinque si collegano da Origini dati, sotto Eshops. Solo gli amministratori del workspace possono collegare le integrazioni. Ogni store si collega con le credenziali prese dal proprio pannello di amministrazione; le schede mostrano dove ottenerle.
Shopify
Shopify richiede che l’installazione delle app parta dallo Shopify App Store.
- Fai clic su Connect Shopify Store. Vieni portato all’app FlowHunt sullo Shopify App Store.
- Fai clic su Add app, accedi al tuo admin Shopify se richiesto, controlla e accetta i permessi.
- Completa l’installazione per collegare lo store.
Se non si apre nulla, il browser ha bloccato il pop-up: consentilo oppure apri il link dell’App Store mostrato nella finestra.
WooCommerce
- Nell’admin di WordPress, vai su WooCommerce → Settings → Advanced → REST API.
- Fai clic su Add key, inserisci una descrizione e imposta Permissions su Read.
- Fai clic su Generate API key e copia la consumer key e il consumer secret (il secret viene mostrato una sola volta).
- In AmICited, inserisci lo Store URL (includi la sottocartella se WordPress si trova in una, ad esempio
https://example.com/shop), la Consumer key e il Consumer secret, poi fai clic su Connect WooCommerce.
Lo store deve essere raggiungibile via HTTPS; WooCommerce ignora le chiavi API inviate tramite HTTP semplice.
Magento 2
- Nell’Admin di Magento 2, vai su System → Extensions → Integrations e fai clic su Add New Integration.
- Assegna un nome (ad esempio “FlowHunt”). Nella scheda API, imposta Resource Access su All, oppure concedi almeno Sales, Catalog, Customers, Stores e Catalog Inventory.
- Salva e fai clic su Activate.
- Copia tutte e quattro le credenziali OAuth (Consumer Key, Consumer Secret, Access Token, Access Token Secret) e inseriscile in AmICited insieme al Magento Store URL (senza
/admin).
Se lo store è protetto da HTTP Basic Auth, compila anche entrambi i campi facoltativi di Basic Auth.
Shoptet
- Nell’amministrazione del tuo e-shop, vai su Connections → Private API.
- Fai clic su Add, inserisci una descrizione e lascia abilitati tutti i gruppi di endpoint.
- Mostra il token, conferma con la tua password e copialo.
- Incollalo come API token (inizia con l’ID del tuo e-shop, come
123456-p-…) e fai clic su Connect Shoptet.
La Private API è disponibile solo con il piano Shoptet Premium.
BiznisWeb
- Accedi al pannello di amministrazione di BiznisWeb e vai su Settings → API Access.
- Crea un nuovo token API con i permessi appropriati.
- In AmICited, inserisci l’API Token, l’API Domain (il dominio del tuo shop, ad esempio
www.yourshop.sk) e il Flox Subdomain usato per l’autenticazione (ad esempioyourshop.flox.sk), poi fai clic su Connect BiznisWeb.
Dopo il salvataggio delle credenziali, fai clic su Select account nella scheda per associare lo store al dominio, poi scegli quanto storico degli ordini importare. L’opzione più lunga importa tutto dal primo ordine dello shop; ogni opzione mostra le righe previste e il costo una tantum prima della conferma.
Dati dei clienti: anonimizzati o completi#
Prima della prima importazione scegli cosa può salvare l’importazione sulle persone che acquistano. Va deciso subito: riguarda gli ordini già importati, quindi cambiarlo in seguito significa scollegare e ricollegare lo store.
- Anonimizzati (predefinito). Nessuna email, nome o indirizzo arriva mai al warehouse. Un cliente è un hash unidirezionale della sua email: abbastanza per contarlo, seguirne gli ordini e segmentarlo, non abbastanza per contattarlo.
- Import full customer data. Salva email e nome insieme all’ordine, così un segmento può essere esportato e usato per agire. Sono dati personali, conservati secondo le regole di retention del tuo workspace.
Ogni report funziona in entrambi i casi.
Impostazioni dello shop#
I numeri valgono quanto i costi che ci stanno dietro. Apri Shop settings nella scheda dello store per impostare:
- Currency. La valuta in cui viene riportato tutto sul dominio e i tassi di cambio usati per arrivarci.
- Cost inputs. Quanto costa ogni ordine oltre ai beni, per periodo: spedizione e imballaggio netti per ordine, % di commissione di pagamento, costi fissi mensili e un margine ipotizzato. Altri costi (una campagna, un’agenzia, un anno di software) possono essere registrati e ripartiti sul loro periodo. Finché non esiste almeno un periodo, non è possibile calcolare margine di contribuzione e profitto.
- Product costs. Quanto è costato acquistare ogni prodotto, che trasforma i ricavi in margine.
- Order statuses. Quali stati dello shop contano come vendita.
- Payment methods. Quali metodi comportano una commissione e di quanto.
La pagina Shop connection mostra cosa è stato importato e cosa manca ancora prima che i report dell’eshop abbiano numeri reali. Data health (nei report) mostra quanta parte di ogni dato è misurata e quanta è ipotizzata.
Cosa sblocca#
Reports → Eshop contiene circa 25 report, raggruppati così:
- Earnings. Cockpit (profitto, cosa lo ha mosso, siamo in linea con il piano), Sales engine, Economics.
- Costs. Cost mix, Pages and ad spend, Marketing & ads, CAC & ROAS, Cross-source reports.
- Ads and the shop. Attribution reality (le dichiarazioni di Meta a confronto con gli ordini arrivati), Profit-true ROAS, New-customer CAC, Audience efficiency, Dayparting, Profit scaling. Richiedono Meta Ads collegato.
- Products. Products, Assortment, Product bundles, Entry products.
- Customers. Retention, Repeat purchase, Lifetime value, Segments, Replenishment (chi deve riordinare).
- Markets and timing. Geography, Geo profitability, Calendar, Weather.
- Operations and data. Metric library, Order mix, Data health.
Gli ordini dello store alimentano anche le aspettative delle annotazioni per l’ecommerce (ordini, ricavi netti, AOV, ROAS, profitto aziendale), e Audit → Link building scrive link interni nel tuo store: ogni regola indica una parola chiave e una destinazione, e i link vengono aggiunti nei testi di prodotti, collezioni, pagine e articoli a ogni applicazione e rimossi quando la regola viene messa in pausa o eliminata.
Costi e scollegamento#
Come ogni origine dati: un’importazione una tantum fatturata in base alle righe conservate (1 credito per milione di righe) e una tariffa giornaliera fissa del warehouse per dominio collegato, stabilita dal tuo piano; entrambe vengono mostrate prima della conferma. Disconnetti interrompe l’importazione ed elimina i dati importati; non è reversibile. Vedi crediti.