RevenueCat mit AdMate verbinden

Eine RevenueCat-Verbindung gibt AdMate neben Werbe- und Store-Berichten eine abonnementbezogene Ansicht. Sie kann die Projekte, Transaktionen und Kennzahlen anzeigen, die RevenueCat bereitstellt, ohne die AdMate-API zu einem serverseitigen Umsatzspeicher zu machen.

RevenueCat-Zugangsdaten sind mächtig. Bereite die Verbindung sorgfältig vor, nutze den Autorisierungsmodus deiner aktuellen AdMate-Version und füge niemals einen geheimen Schlüssel in ein öffentliches Issue oder einen Screenshot ein.

AdMate

Alle Ihre Einnahmen in einem Dashboard

Verfolgen Sie AdMob, AdSense, RevenueCat und App Store Connect über mehrere Konten hinweg mit Filtern nach App, Plattform und Land

Überwachen Sie Einnahmen, Klicks, eCPM, Abonnements, Installationen und Zahlungen auf iPhone, iPad, Mac und Apple Watch

Den richtigen RevenueCat-Zugang wählen

AdMate unterstützt die Konfiguration von RevenueCat-Konten und mehrere Projekte. Je nach aktuellem Konto und App-Version kann der Bildschirm für Zugangsdaten die unterstützte API-v2-Autorisierung einschließlich geheimer Projektschlüssel verwenden und einen Autorisierungsablauf auf Kontoebene anbieten.

Verwende die Zugangsdaten mit den geringsten Rechten, die die benötigten Daten lesen können. Ein öffentlicher SDK-Schlüssel, der für die Einbettung in eine App gedacht ist, ersetzt nicht automatisch geheime API-Zugangsdaten, und Zugangsdaten für ein Projekt listen nicht zwangsläufig alle Projekte einer Organisation auf.

Vor der Einrichtung:

ermittle die RevenueCat-Organisation und die benötigten Projekte;
kläre, ob du einen einzelnen Projektschlüssel oder eine Verbindung auf Kontoebene hinzufügst;
entferne alte Schlüssel, die nicht mehr benötigt werden;
lege einen eindeutigen Alias für das Konto in AdMate fest.

Das RevenueCat-Konto hinzufügen

Öffne in AdMate die Einstellungen und die Kontoverwaltung.
Suche RevenueCat und wähle die Option zum Hinzufügen eines Kontos.
Wähle die Autorisierungsmethode, die die aktuelle App anzeigt.
Gib die angeforderten Zugangsdaten ein oder autorisiere sie, ohne Zeichen zu verändern.
Lass AdMate das Konto prüfen und die zugänglichen Projekte abrufen.
Gib der Verbindung einen gut erkennbaren Namen, wenn mehrere Organisationen oder Kunden beteiligt sind.
Öffne die RevenueCat-Übersicht und prüfe das gewünschte Projekt und den Zeitraum.

Wenn du mehrere geheime Projektschlüssel verwendest, ordne jeden dem richtigen Projekt zu. Benenne nicht jeden Eintrag einfach „RevenueCat“; ein aussagekräftiger Alias verhindert versehentliche Vergleiche zwischen verschiedenen Kunden.

Was du nach der Verbindung prüfen solltest

Prüfe zuerst die Identität, dann die Summen:

Name des Kontos oder der Organisation;
Projektname und Projekt-ID;
enthaltene Apps und Stores;
ausgewählter Zeitraum und Währung;
ob Rückerstattungen oder Abwärtskorrekturen in der angezeigten Kennzahl enthalten sind.

Vergleiche anschließend einen abgeschlossenen Zeitraum mit dem RevenueCat-Dashboard. Kleine Abweichungen können durch Aktualisierungszeitpunkte, Währungsregeln oder Kennzahldefinitionen entstehen. Ein komplett fehlendes Projekt deutet meist auf den Umfang der Zugangsdaten oder die Projektzuordnung hin, nicht auf einen Rechenfehler.

Dashboard-Zugriff und Webhooks sind getrennt

AdMate nutzt RevenueCat auf zwei verschiedene Arten:

die Apple-App fragt die vom Nutzer konfigurierten Projekte für Dashboard-Daten ab;
die AdMate-API kann RevenueCat-Webhooks für Benachrichtigungen empfangen.

Das Einrichten von Zugangsdaten für das Dashboard konfiguriert nicht automatisch einen Webhook, und ein Webhook gibt der App keine Berechtigung, Projektkennzahlen aufzulisten. Behandle beides als getrennte Aufgaben mit getrennten Zugangsdaten und Zwecken.

Die API speichert vorübergehend Geräte- und Projektkontext, damit eine Benachrichtigung sinnvolle Namen und die Währung anzeigen kann. Dieser Kontext ist keine serverseitige Kopie des vollständigen Umsatzverlaufs oder des Zugriffstokens des Nutzers.

Ein fehlendes Projekt beheben

Die Zugangsdaten werden akzeptiert, aber nur ein Projekt erscheint

Prüfe, ob die Zugangsdaten speziell zu diesem Projekt gehören. Füge die benötigten Schlüssel hinzu oder ordne sie zu, oder nutze die unterstützte Methode auf Kontoebene, wenn das passt.

Für ein gültiges Projekt erscheinen keine Kennzahlen

Wähle einen abgeschlossenen Zeitraum mit bekannten Transaktionen, prüfe die Projekt- und Store-Filter und aktualisiere in der Haupt-App. Ein neues oder inaktives Projekt kann zu Recht null liefern.

Die Autorisierung schlägt plötzlich fehl

Der Schlüssel wurde möglicherweise widerrufen, rotiert oder mit Leerzeichen kopiert. Prüfe seinen Status in RevenueCat und ersetze ihn anschließend in AdMate. Behalte keinen widerrufenen Schlüssel als Reserve.

Der Projektname stimmt, aber die Summe wirkt falsch

Prüfe die Kennzahldefinition, Rückerstattungen, Währung und Datumsgrenzen. Vergleiche RevenueCat-Umsätze nicht direkt mit den Erlösen in App Store Connect, bevor die Umfänge abgestimmt sind.

Die Zugangsdaten schützen

nimm den Schlüssel niemals in Analysen, Logs oder einen Diagnose-Screenshot auf;
verwende einen Projektschlüssel nicht außerhalb der vorgesehenen Organisation;
rotiere ihn, wenn er offengelegt wurde;
entferne das AdMate-Konto von Geräten, die das Projekt nicht mehr lesen sollen;
überprüfe die Zugriffe regelmäßig, wenn eine Zusammenarbeit mit Dienstleistern oder Kunden endet.

Lies weiter, warum sich die Summen der Anbieter unterscheiden, bevor du eine kombinierte Umsatzzahl veröffentlichst.

Häufig gestellte Fragen

Kann AdMate mehrere RevenueCat-Projekte verbinden?

Ja. Das Kontomodell unterstützt mehrere Projekte und Projekt-Zugangsdaten. Benenne und prüfe jedes Projekt, bevor du Ansichten kombinierst.

Reicht ein öffentlicher RevenueCat-SDK-Schlüssel?

Verwende den Typ von Zugangsdaten, den die RevenueCat-Einrichtung in AdMate anfordert. Öffentliche SDK-Schlüssel für Apps und geheime API-Zugangsdaten haben unterschiedliche Zwecke.

Sendet AdMate alle Abonnementumsätze an seine API?

Nein. Die App fragt die konfigurierten Dienste direkt ab. Der RevenueCat-Kontext der API dient Webhook-Benachrichtigungen und ist kein Umsatzspeicher.

Was sollte ich an den Support senden?

Sende Projektname, Zeitraum, Kennzahl und den bereinigten Fehler. Sende niemals den geheimen Schlüssel.