Integraties
Webshops
Koppel Shopify, WooCommerce, Magento 2, Shoptet of BiznisWeb om bestellingen, producten, klanten en marge aan een domein toe te voegen en om interne links in je webshop te schrijven.
Voor een webshop is de vraag achter elke zichtbaarheidsmetric of het verkoopt. Door je webshop te koppelen komen bestellingen, omzet, producten en klanten in hetzelfde domein te staan als je AI-bronvermeldingen, zoekverkeer en advertentie-uitgaven. Dat ontgrendelt de Eshop-rapporten (winst, kosten, producten, klanten, markten) en laat advertentieplatforms beoordelen op bestellingen die daadwerkelijk binnenkwamen in plaats van op de conversies die ze claimen.
Ecommerce-integraties zijn beschikbaar vanaf het Pro-abonnement. Zie abonnementen en limieten.
Koppel je webshop#
Alle vijf worden gekoppeld vanuit Data Sources, onder Eshops. Alleen workspacebeheerders kunnen integraties koppelen. Elke webshop wordt gekoppeld met inloggegevens uit zijn eigen beheeromgeving; de tabbladen tonen waar je ze vindt.
Shopify
Shopify vereist dat app-installaties starten vanuit de Shopify App Store.
- Klik op Connect Shopify Store. Je wordt doorgestuurd naar de FlowHunt-app in de Shopify App Store.
- Klik op Add app, log in bij je Shopify-beheer als daarom wordt gevraagd, bekijk de rechten en accepteer ze.
- Rond de installatie af om de webshop te koppelen.
Als er niets opent, heeft je browser de pop-up geblokkeerd; sta hem toe of open de App Store-link die in het dialoogvenster staat.
WooCommerce
- Ga in het WordPress-beheer naar WooCommerce → Settings → Advanced → REST API.
- Klik op Add key, geef een beschrijving op en stel Permissions in op Read.
- Klik op Generate API key en kopieer de consumer key en consumer secret (de secret wordt maar één keer getoond).
- Voer in AmICited de Store URL in (neem de submap mee als WordPress in een submap staat, bijvoorbeeld
https://example.com/shop), de Consumer key en de Consumer secret en klik op Connect WooCommerce.
De webshop moet bereikbaar zijn via HTTPS; WooCommerce negeert API-sleutels die via gewone HTTP worden verstuurd.
Magento 2
- Ga in de Magento 2 Admin naar System → Extensions → Integrations en klik op Add New Integration.
- Geef hem een naam (bijvoorbeeld “FlowHunt”). Stel op het tabblad API Resource Access in op All, of geef minstens Sales, Catalog, Customers, Stores en Catalog Inventory toegang.
- Sla op en klik op Activate.
- Kopieer alle vier de OAuth-gegevens (Consumer Key, Consumer Secret, Access Token, Access Token Secret) en voer ze in AmICited in samen met de Magento Store URL (zonder
/admin).
Als de webshop achter HTTP Basic Auth zit, vul dan ook beide optionele Basic Auth-velden in.
Shoptet
- Ga in het beheer van je e-shop naar Connections → Private API.
- Klik op Add, voer een beschrijving in en laat elke endpointgroep ingeschakeld.
- Toon het token, bevestig met je wachtwoord en kopieer het.
- Plak het als API token (het begint met je e-shop-ID, zoals
123456-p-…) en klik op Connect Shoptet.
De Private API is alleen beschikbaar in het tarief Shoptet Premium.
BiznisWeb
- Log in op je BiznisWeb-beheerpaneel en ga naar Settings → API Access.
- Maak een nieuw API-token aan met de juiste rechten.
- Voer in AmICited het API Token in, het API Domain (het eigen domein van je webshop, bijvoorbeeld
www.yourshop.sk) en het Flox Subdomain dat voor authenticatie wordt gebruikt (bijvoorbeeldyourshop.flox.sk) en klik op Connect BiznisWeb.
Nadat de inloggegevens zijn opgeslagen, klik je op de kaart op Select account om de webshop aan het domein te koppelen en kies je vervolgens hoeveel bestelhistorie je importeert. De langste optie importeert alles sinds de eerste bestelling van de webshop; elke optie toont vóór je bevestigt zijn verwachte rijen en eenmalige kosten.
Klantgegevens: geanonimiseerd of volledig#
Vóór de eerste import kies je wat de import mag opslaan over de mensen die kopen. Dit moet vooraf worden beantwoord: het beschrijft de bestellingen die al zijn geïmporteerd, dus wijzigen kan later alleen door de webshop los te koppelen en opnieuw te koppelen.
- Anonymised (standaard). Geen e-mailadres, naam of adres bereikt ooit het warehouse. Een klant is een eenrichtingshash van zijn e-mailadres: genoeg om hem te tellen, zijn bestellingen te volgen en hem te segmenteren, niet genoeg om contact op te nemen.
- Import full customer data. Slaat het e-mailadres en de naam op bij de bestelling, zodat een segment kan worden geëxporteerd en erop kan worden gehandeld. Dit zijn persoonsgegevens, bewaard volgens de bewaarregels van je workspace.
Elk rapport werkt op beide manieren.
Shopinstellingen#
De cijfers zijn alleen zo goed als de kosten erachter. Open Shop settings op de kaart van de webshop om in te stellen:
- Currency. De valuta waarin alles op het domein wordt gerapporteerd en de wisselkoersen om die te bereiken.
- Cost inputs. Wat elke bestelling kost naast de goederen, per periode: netto verzend- en verpakkingskosten per bestelling, betaalkosten %, vaste kosten per maand en een aangenomen marge. Andere kosten (een campagne, een bureau, een jaar software) kunnen worden vastgelegd en over hun periode verdeeld. Zolang er geen enkele periode bestaat, kunnen bijdrage en winst niet worden berekend.
- Product costs. Wat elk product in de inkoop kostte, waardoor omzet marge wordt.
- Order statuses. Welke van de statussen van de webshop als verkoop tellen.
- Payment methods. Welke methoden kosten meebrengen en hoeveel.
De pagina Shop connection toont wat is geïmporteerd en wat nog ontbreekt voordat de eshoprapporten echte cijfers hebben. Data health (in de rapporten) toont hoeveel van elk cijfer gemeten is ten opzichte van aangenomen.
Wat het ontgrendelt#
Reports → Eshop bevat ongeveer 25 rapporten, gegroepeerd als:
- Earnings. Cockpit (winst, wat die deed bewegen, liggen we op schema), Sales engine, Economics.
- Costs. Cost mix, Pages and ad spend, Marketing & ads, CAC & ROAS, Cross-source reports.
- Ads and the shop. Attribution reality (de claims van Meta tegenover bestellingen die binnenkwamen), Profit-true ROAS, New-customer CAC, Audience efficiency, Dayparting, Profit scaling. Hiervoor moet Meta Ads zijn gekoppeld.
- Products. Products, Assortment, Product bundles, Entry products.
- Customers. Retention, Repeat purchase, Lifetime value, Segments, Replenishment (wie is aan de beurt om opnieuw te bestellen).
- Markets and timing. Geography, Geo profitability, Calendar, Weather.
- Operations and data. Metric library, Order mix, Data health.
Webshopbestellingen voeden ook de verwachtingen van ecommerce-annotaties (bestellingen, netto-omzet, AOV, ROAS, bedrijfswinst), en Audit → Link building schrijft interne links in je webshop: elke regel noemt een zoekwoord en een bestemming, en links worden bij elke toepassing toegevoegd aan de teksten van producten, collecties, pagina’s en artikelen en verwijderd wanneer de regel wordt gepauzeerd of verwijderd.
Kosten en loskoppelen#
Zoals elke databron: een eenmalige import die wordt gefactureerd op basis van bewaarde rijen (1 credit per miljoen rijen) en een vast dagelijks warehousetarief per gekoppeld domein dat door je abonnement wordt bepaald, beide getoond voordat je bevestigt. Disconnect stopt de import en verwijdert de geïmporteerde data; het kan niet ongedaan worden gemaakt. Zie credits.