Installatiehandleidingen
Flowsery Analytics instellen in een Laravel-project
Deze handleiding laat zien hoe je Flowsery Analytics-tracking aan je Laravel-applicatie toevoegt.
1. Zet het script in je layout
De netste aanpak is de snippet in je hoofd-Blade-layout te plaatsen.
- Open je layoutbestand -- meestal
resources/views/layouts/app.blade.php. - Plaats de snippet van Flowsery Analytics binnen
<head>:
HTML
<!DOCTYPE html>
<html>
<head>
<!-- ... other head elements ... -->
<script defer data-fl-website-id="{{ config('flowsery.website_id') }}" src="https://cdn.flowsery.com/main.js"></script>
</head>
<body>
@yield('content')
</body>
</html>2. Configuratie toevoegen (optioneel)
Wil je je configuratie centraal beheren, maak dan een apart configuratiebestand:
- Maak
config/flowsery.phpaan:
PHP
<?php
return [
'website_id' => env('FLOWSERY_WEBSITE_ID'),
];- Voeg de waarde toe aan je
.env-bestand:
Terminal
FLOWSERY_WEBSITE_ID=flid_******3. Omzettracking aan de serverkant
Koppel je betaalprovider
Open je website-instellingen in Flowsery Analytics en koppel je Stripe- of LemonSqueezy-account.
Geef metadata mee tijdens de checkout
Stripe
Stuur bij het aanmaken van een checkoutsessie de cookies van Flowsery Analytics mee in de metadata:
PHP
<?php
use Stripe\Stripe;
use Stripe\Checkout\Session;
Stripe::setApiKey(config('services.stripe.secret'));
$session = Session::create([
'payment_method_types' => ['card'],
'line_items' => [[
'price' => 'price_1234567890',
'quantity' => 1,
]],
'mode' => 'payment',
'success_url' => route('checkout.success'),
'cancel_url' => route('checkout.cancel'),
'metadata' => [
'_fs_vid' => request()->cookie('_fs_vid'),
'_fs_sid' => request()->cookie('_fs_sid')
]
]);
return redirect($session->url);LemonSqueezy
Neem bij LemonSqueezy de cookies van Flowsery Analytics op in de payload met custom data:
PHP
<?php
use Illuminate\Support\Facades\Http;
$response = Http::withHeaders([
'Authorization' => 'Bearer ' . config('services.lemonsqueezy.api_key'),
'Content-Type' => 'application/json'
])->post('https://api.lemonsqueezy.com/v1/checkouts', [
'store_id' => config('services.lemonsqueezy.store_id'),
'variant_id' => 'your_variant_id',
'custom' => [
'_fs_vid' => request()->cookie('_fs_vid'),
'_fs_sid' => request()->cookie('_fs_sid')
]
]);
return redirect($response->json()['data']['attributes']['url']);4. Controleer of alles werkt
Na het deployen:
- Ga naar je live site
- Open je Flowsery Analytics-dashboard en kijk of er pageviews binnenkomen
- Houd er rekening mee dat de eerste data een paar minuten nodig heeft
- Doe een testaankoop en controleer of de omzetattributie werkt
Voor extra opties zoals tracking op localhost, eigen API-endpoints of cross-domain-configuratie, zie de referentie voor scriptconfiguratie.