Support/Installatiehandleidingen
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.

  1. Open je layoutbestand -- meestal resources/views/layouts/app.blade.php.
  2. 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:

  1. Maak config/flowsery.php aan:
PHP
<?php
 
return [
    'website_id' => env('FLOWSERY_WEBSITE_ID'),
];
  1. 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.