Flowsery Analytics in einem Laravel-Projekt einrichten...

Diese Anleitung behandelt das Hinzufügen von Flowsery Analytics Tracking zu Ihrer Laravel-Anwendung.

1. Script in Ihr Layout einbetten

Der sauberste Ansatz ist, das Snippet in Ihr Haupt-Blade-Layout zu platzieren.

Öffnen Sie Ihre Layout-Datei -- normalerweise resources/views/layouts/app.blade.php.
Fügen Sie das Flowsery Analytics Snippet innerhalb von <head> ein:

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. Konfiguration hinzufügen (optional)

Für eine zentrale Konfigurationsverwaltung erstellen Sie eine dedizierte Konfigurationsdatei:

Erstellen Sie config/flowsery.php:

PHP

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

Fügen Sie den Wert zu Ihrer .env-Datei hinzu:

Terminal

FLOWSERY_WEBSITE_ID=flid_******

3. Serverseitiges Revenue-Tracking

Zahlungsanbieter verbinden

Öffnen Sie Ihre Website-Einstellungen in Flowsery Analytics und verknüpfen Sie Ihr Stripe- oder LemonSqueezy-Konto.

Metadaten beim Checkout übergeben

Stripe

Wenn Sie eine Checkout-Sitzung erstellen, leiten Sie die Flowsery Analytics Cookies in den Metadaten weiter:

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

Für LemonSqueezy fügen Sie die Flowsery Analytics Cookies in der Custom-Data-Payload ein:

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. Funktionsfähigkeit überprüfen

Nach der Bereitstellung:

Navigieren Sie zu Ihrer Live-Website
Öffnen Sie Ihr Flowsery Analytics Dashboard und suchen Sie nach eingehenden Seitenaufrufen
Warten Sie einige Minuten, bis die ersten Daten erscheinen
Führen Sie einen Testkauf durch und überprüfen Sie, ob die Umsatzzuordnung funktioniert

Für weitere Optionen wie Localhost-Tracking, benutzerdefinierte API-Endpunkte oder Cross-Domain-Konfiguration lesen Sie die Script-Konfigurationsreferenz.