Einrichtung – komplette Anleitung

① Apple – App Store Connect nicht konfiguriert

1. App Store Connect → Users and Access → Integrations → Keys → Key mit Rolle Finance erzeugen.
2. AuthKey_XXXXXX.p8 herunterladen. Key-ID, Issuer-ID und Vendor-Nummer (Sales & Trends) notieren.

② Google Play – Earnings nicht konfiguriert

1. Play Console → Download reports → Financial → oben „Copy Cloud Storage URI" → ergibt gs://pubsite_prod_rev_…. (Kein Button da? Dann hattest du auf Android noch keine Umsätze – dann Google Play erstmal weglassen.)
2. Google Cloud Console → Projekt wählen/erstellen → IAM & Admin → Service Accounts → Create (keine Rollen nötig) → auf den Account → Keys → Add key → JSON herunterladen. Die Service-Account-E-Mail (…@….iam.gserviceaccount.com) merken.
3. Dem Service-Account Leserechte geben: Play Console → Nutzer und Berechtigungen → Neue Nutzer einladen → Service-Account-E-Mail → Kontoberechtigung „Finanzdaten ansehen". Greift erst nach bis zu 24–48 h (bis dahin HTTP 403).

③ AdMob – Werbeeinnahmen nicht konfiguriert

1. Google Cloud Console → AdMob API aktivieren → OAuth-Client Typ Desktop anlegen.
2. Refresh-Token erzeugen (im Terminal mit !): ! php8.4 /var/www/revenueview/api/collectors/admob_oauth.php <client_id> <client_secret> – oder unten direkt eintragen, falls schon vorhanden.

④ Eigenes Flutter-Package einbinden

Ein einziges privates Package revenueview_sdk meldet Käufe/Abos live an diesen Server – wie RevenueCats purchases_flutter, nur deins. Empfehlung: erst eine Pilot-App (z. B. popart), End-to-End testen, dann ausrollen. Jede App braucht einen eigenen Ingest-Key.

📖 Code-genaue Einbau-Anleitung (was genau in pubspec, main.dart & Kauf-Handler kommt) →

Schritt 1 – Ingest-Key für eine App erzeugen

Schritt 2 – Package als Abhängigkeit

In der pubspec.yaml der App (Pfad-Abhängigkeit auf das lokale Package):

dependencies:
  revenueview_sdk:
    path: ../../revenueview_sdk   # von <app>/app/ aus zu ~/projects/revenueview_sdk

Schritt 3 – Einmal beim App-Start initialisieren

In main() vor runApp(...) (Key = der oben erzeugte):

import 'package:revenueview_sdk/revenueview_sdk.dart';

await RevenueView.configure(
  apiKey: 'DEIN_APP_KEY',
  baseUrl: 'https://revenueview.glowiszyn.com',
);

Schritt 4 – Eine Zeile im bestehenden Kauf-Handler

Dort, wo dein purchaseStream auf PurchaseStatus.purchased reagiert (direkt vor deinem completePurchase):

case PurchaseStatus.purchased:
  RevenueView.report(purchaseDetails);   // <-- diese eine Zeile
  // … dein bestehendes deliver + completePurchase bleibt

Schritt 5 – Bauen, einreichen, testen

1. App neu bauen und in den Store hochladen (das ist der Teil, den nur du machen kannst).
2. Nach Freigabe einen (Sandbox-)Kauf auslösen.
3. Im Dashboard erscheint das Ereignis live (bis zur Store-Validierung Status pending).

Validierung der Kauf-Tokens (bereits gebaut)

Jedes gemeldete Ereignis wird serverseitig gegen den Store geprüft (macht aus pending bestätigten Umsatz/MRR – erscheint dann in der Live-Karte der Übersicht). Zugänge:

• Apple: nutzt den .p8-Key aus Teil A (App Store Server API) – nichts weiter nötig.
• Google: zusätzlich die Play Developer API im GCP-Projekt aktivieren und den Service-Account aus Teil A in der Play Console unter Users & permissions mit Leserechten (View financial data / Orders) hinzufügen. Danach validiert derselbe Account auch die Käufe.

⑤ Täglicher Lauf

Ein Cron-Job läuft täglich 06:30, holt die Store-Reports und schickt einen Umsatz-Report per E-Mail an dennis@glowiszyn.com. Bereits eingerichtet. Manueller Lauf jederzeit:

php8.4 /var/www/revenueview/api/collectors/run_all.php

Store-Reports haben ~1–2 Tage Verzug; Financial-Reports von Google erscheinen als Monats-CSV mit 3–7 Tagen Versatz.