Assistance/Guides d'installation
Guides d'installation

Configurer Flowsery Analytics dans un projet Laravel

Ce guide couvre l'ajout du suivi Flowsery Analytics a votre application Laravel.

1. Integrer 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 -- generalement resources/views/layouts/app.blade.php.
  2. Inserez 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 centralisee de la configuration, creez un fichier de configuration dedie :

  1. Creez config/flowsery.php :
HTML
<?php return [ 'website_id' =>
env('FLOWSERY_WEBSITE_ID'), ];
  1. Ajoutez la valeur dans votre fichier .env :
HTML
FLOWSERY_WEBSITE_ID=flid_******

3. Suivi des revenus cote serveur

Connecter votre fournisseur de paiement

Ouvrez les parametres de votre site dans Flowsery Analytics et liez votre compte Stripe ou LemonSqueezy.

Transmettre les metadonnees lors du checkout

Stripe

Lorsque vous creez une session de checkout, transmettez les cookies Flowsery Analytics dans les metadonnees :

HTML
<?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); ```bash #### LemonSqueezy Pour LemonSqueezy, incluez les cookies Flowsery Analytics dans les donnees personnalisees :
'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. Verifier que tout fonctionne Apres le deploiement : - Accedez a votre site en production - Ouvrez votre tableau de bord Flowsery Analytics et verifiez les pages vues entrantes - Accordez quelques minutes pour que les premieres donnees apparaissent - Effectuez un achat test et verifiez que l'attribution des revenus fonctionne Pour des options supplementaires telles que le suivi en localhost, les endpoints API personnalises ou la configuration inter-domaines, consultez la [reference de configuration du script](/docs/script-configuration).