Configurar o Flowsery Analytics num projeto Laravel...

Este guia abrange como adicionar o rastreamento do Flowsery Analytics à sua aplicação Laravel.

1. Incorporar o script no seu layout

A abordagem mais limpa é colocar o snippet no seu layout Blade principal.

Abra o seu ficheiro de layout -- normalmente resources/views/layouts/app.blade.php.
Insira o snippet do Flowsery Analytics dentro do <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. Adicionar configuração (opcional)

Para gestão centralizada de configuração, crie um ficheiro de configuração dedicado:

Crie config/flowsery.php:

PHP

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

Adicione o valor ao seu ficheiro .env:

Terminal

FLOWSERY_WEBSITE_ID=flid_******

3. Rastreamento de receita do lado do servidor

Conectar o seu provedor de pagamentos

Abra as definições do seu website no Flowsery Analytics e vincule a sua conta Stripe ou LemonSqueezy.

Passar metadata durante o checkout

Stripe

Quando criar uma sessão de checkout, encaminhe os cookies do Flowsery Analytics na 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

Para o LemonSqueezy, inclua os cookies do Flowsery Analytics no payload de dados personalizados:

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. Confirmar que tudo está a funcionar

Após o deploy:

Navegue até ao seu site em produção
Abra o seu painel do Flowsery Analytics e verifique os pageviews recebidos
Aguarde alguns minutos para que os primeiros dados apareçam
Complete uma compra de teste e verifique se a atribuição de receita está a funcionar

Para opções adicionais como rastreamento em localhost, endpoints de API personalizados ou configuração entre domínios, consulte a referência de configuração do script.