Webshopintegratie

Server-side tracking voor Shopware 6

Voeg een Shopware-integratie met leestoegang tot bestellingen toe en ROASaurus synchroniseert betaalde bestellingen via de Admin API. Een Flow Builder-webhook zorgt dat ze binnenkomen zodra ze zijn betaald.

Shopware in één oogopslag
Bestellingen komen binnen viaAdmin API-polling elke 5 minuten; direct met een Flow Builder-webhook
InloggegevensToegangssleutel-ID en geheime toegangssleutel van de integratie
Betaalde bestellingenEen transactie met status paid
Bestel-idHet bestelnummer van Shopware
Snippet voor de bedankpaginacheckout/finish-template, met page.order.orderNumber

Zo koppelt Shopware

  1. Voeg het ROASaurus-script toe aan je thema (base.html.twig, blok base_script_tracking) of via een tagmanager-plugin.
  2. Settings › System › Integrations › Add integration, met leestoegang tot bestellingen. Voer de toegangssleutel-ID en de geheime toegangssleutel in bij ROASaurus.
  3. Voeg voor een exacte koppeling het snippet voor de bedankpagina toe aan storefront/page/checkout/finish/index.html.twig.

ROASaurus wisselt de integratiesleutels om voor een kortlevend Admin API-token en zoekt elke 5 minuten naar bestellingen die sinds de vorige run zijn bijgewerkt. Een bestelling telt als betaald wanneer een van de transacties de status paid heeft. Het bestelnummer wordt als id gebruikt en dat is ook wat het snippet voor de bedankpagina verstuurt.

Directe bestellingen met Flow Builder

Maak in Shopware Evolve en hoger een flow met trigger State Enter / Order Transaction / State / Paid en actie Call URL (Webhook), POST naar je ROASaurus-webhook-URL. De aanroep is slechts een signaal: ROASaurus vertrouwt de inhoud niet en haalt in plaats daarvan de bestellingen van de afgelopen twee uur op via de geauthenticeerde API. Bestellingen die het al heeft, worden genegeerd.

Wat ROASaurus uit elke bestelling leest

Het totaal, de valuta, de besteldatum, het e-mailadres en de naam van de klant, het telefoonnummer, de plaats, postcode en het land van de factuur, het klant-id en de productregels met aantal, stukprijs en productnummer.

Bestellingen koppelen aan advertentieklikken

Het snippet voor de bedankpagina laat de ROASaurus-aankoop afgaan met het bestelnummer en het totaal, waarmee de bestelling aan de bezoeker wordt gekoppeld. Zonder dat snippet gebruikt ROASaurus een e-mailadres dat de bezoeker eerder op je site heeft opgegeven, bijvoorbeeld in een popup.

Beperkingen

  • Shopware anonimiseert het IP-adres van de klant standaard, dus de IP-terugval helpt zelden. Voeg het snippet voor de bedankpagina toe.
  • Flow Builder-webhooks vereisen Shopware Evolve of hoger. Zonder webhooks duurt het tot 5 minuten voordat bestellingen binnenkomen.
  • De connector is gebouwd op basis van de officiële API-documentatie van het platform. Klik na het opslaan van je inloggegevens op Test connection, plaats daarna een testbestelling en controleer het Event log.

Gerelateerd

FAQ

Vragen, beantwoord

Heb ik Flow Builder nodig?

Nee. Zonder Flow Builder haalt ROASaurus elke 5 minuten betaalde bestellingen op. De Flow Builder-webhook, beschikbaar vanaf Shopware Evolve, zorgt er alleen voor dat ze direct binnenkomen.

Is de Flow Builder-webhook veilig?

ROASaurus behandelt hem alleen als signaal. Het neemt nooit bestelgegevens uit de aanroep over; het haalt recente bestellingen op via de Admin API met je integratiesleutels.

Welke toegang heeft de integratie nodig?

Leestoegang tot bestellingen. ROASaurus gebruikt de toegangssleutel-ID en het geheim van de integratie om een kortlevend Admin API-token te krijgen.

Elke verkoop herleid tot de advertentie die hem opleverde

Server-side tracking, winst en lifetime value in één app. 14 dagen gratis proberen, geen creditcard.

Start je gratis proefperiode →