Configurer Flowsery Analytics dans un projet Laravel
Ce guide couvre l'ajout du suivi Flowsery Analytics à votre application Laravel.
1. Intégrer le script dans votre layout
L'approche la plus propre est de placer le snippet dans votre layout Blade principal.
- Ouvrez votre fichier layout -- généralement
resources/views/layouts/app.blade.php. - Insérez le snippet Flowsery Analytics dans le
<head>:
<!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. Ajouter la configuration (optionnel)
Pour une gestion centralisée de la configuration, créez un fichier de configuration dédié :
- Créez
config/flowsery.php:
<?php
return [
'website_id' => env('FLOWSERY_WEBSITE_ID'),
];- Ajoutez la valeur dans votre fichier
.env:
FLOWSERY_WEBSITE_ID=flid_******3. Suivi des revenus côté serveur
Connecter votre fournisseur de paiement
Ouvrez les paramètres de votre site dans Flowsery Analytics et liez votre compte Stripe ou LemonSqueezy.
Transmettre les métadonnées lors du checkout
Stripe
Lorsque vous créez une session de checkout, transmettez les cookies Flowsery Analytics dans les métadonnées :
<?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
Pour LemonSqueezy, incluez les cookies Flowsery Analytics dans les données personnalisées :
<?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. Vérifier que tout fonctionne
Après le déploiement :
- Accédez à votre site en production
- Ouvrez votre tableau de bord Flowsery Analytics et vérifiez les pages vues entrantes
- Accordez quelques minutes pour que les premières données apparaissent
- Effectuez un achat test et vérifiez que l'attribution des revenus fonctionne
Pour des options supplémentaires telles que le suivi en localhost, les endpoints API personnalisés ou la configuration inter-domaines, consultez la référence de configuration du script.