Przewodniki instalacji
Konfiguracja Flowsery Analytics w projekcie Laravel
Z tego przewodnika dowiesz się, jak dodać śledzenie Flowsery Analytics do aplikacji Laravel.
1. Osadź skrypt w layoucie
Najczystszym rozwiązaniem jest umieszczenie fragmentu kodu w głównym layoucie Blade.
- Otwórz plik layoutu -- zwykle
resources/views/layouts/app.blade.php. - Wstaw fragment kodu Flowsery Analytics w sekcji
<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. Dodaj konfigurację (opcjonalnie)
Aby zarządzać konfiguracją w jednym miejscu, utwórz osobny plik konfiguracyjny:
- Utwórz
config/flowsery.php:
PHP
<?php
return [
'website_id' => env('FLOWSERY_WEBSITE_ID'),
];- Dodaj wartość do pliku
.env:
Terminal
FLOWSERY_WEBSITE_ID=flid_******3. Śledzenie przychodów po stronie serwera
Połącz dostawcę płatności
Otwórz ustawienia witryny we Flowsery Analytics i połącz swoje konto Stripe lub LemonSqueezy.
Przekaż metadane podczas płatności
Stripe
Tworząc sesję płatności, przekaż pliki cookie Flowsery Analytics w metadanych:
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
W przypadku LemonSqueezy dodaj pliki cookie Flowsery Analytics do danych niestandardowych:
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. Sprawdź, czy wszystko działa
Po wdrożeniu:
- Otwórz swoją działającą witrynę
- Otwórz panel Flowsery Analytics i sprawdź, czy pojawiają się odsłony
- Pierwsze dane mogą pojawić się dopiero po kilku minutach
- Dokonaj testowego zakupu i sprawdź, czy atrybucja przychodów działa
Dodatkowe opcje, takie jak śledzenie na localhost, niestandardowe endpointy API czy konfigurację między domenami, znajdziesz w dokumentacji konfiguracji skryptu.