Configurar Flowsery Analytics en un proyecto Laravel

Esta guia cubre como agregar el seguimiento de Flowsery Analytics a tu aplicacion Laravel.

1. Incrustar el script en tu layout

El enfoque mas limpio es colocar el fragmento en tu layout principal de Blade.

Abre tu archivo de layout -- tipicamente resources/views/layouts/app.blade.php.
Inserta el fragmento de Flowsery Analytics dentro de <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. Agregar configuracion (opcional)

Para una gestion de configuracion centralizada, crea un archivo de configuracion dedicado:

Crea config/flowsery.php:

HTML

<?php return [ 'website_id' =>
env('FLOWSERY_WEBSITE_ID'), 'domain' => env('FLOWSERY_DOMAIN'), ];

Agrega los valores a tu archivo .env:

HTML

FLOWSERY_WEBSITE_ID=flid_****** FLOWSERY_DOMAIN=your_domain.com

3. Seguimiento de ingresos del lado del servidor

Conectar tu proveedor de pagos

Abre la configuracion de tu sitio web en Flowsery Analytics y vincula tu cuenta de Stripe o LemonSqueezy.

Pasar metadata durante el checkout

Stripe

Cuando crees una sesion de checkout, reenvía las cookies de Flowsery Analytics en la metadata:

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 Para LemonSqueezy, incluye las cookies de Flowsery Analytics en el payload de datos
personalizados: ```html <?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. Confirmar que todo funciona

Despues de desplegar:

Navega a tu sitio en produccion
Abre tu panel de Flowsery Analytics y busca las visitas entrantes
Espera un par de minutos para que aparezcan los primeros datos
Completa una compra de prueba y verifica que la atribucion de ingresos funcione

Para opciones adicionales como seguimiento en localhost, endpoints API personalizados o configuracion entre dominios, consulta la referencia de configuracion del script.