Assistance/Guides d'installation
Guides d'installation

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.

  1. Ouvrez votre fichier layout -- généralement resources/views/layouts/app.blade.php.
  2. Insérez le snippet Flowsery Analytics dans le <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. Ajouter la configuration (optionnel)

Pour une gestion centralisée de la configuration, créez un fichier de configuration dédié :

  1. Créez config/flowsery.php :
PHP
<?php
 
return [
    'website_id' => env('FLOWSERY_WEBSITE_ID'),
];
  1. Ajoutez la valeur dans votre fichier .env :
Terminal
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
<?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
<?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.