RevenueCat koppelen aan AdMate

Een RevenueCat-koppeling geeft AdMate een weergave gericht op abonnementen, naast advertentie- en store-rapporten. Zo kunnen de projecten, transacties en statistieken die RevenueCat beschikbaar stelt worden getoond, zonder dat de AdMate-API een serveropslag voor inkomsten wordt.

RevenueCat-inloggegevens zijn krachtig. Bereid de koppeling zorgvuldig voor, gebruik de autorisatiemodus van je huidige AdMate-versie en plak nooit een geheime sleutel in een openbaar issue of een screenshot.

AdMate

Al je inkomsten in één dashboard

Volg AdMob, AdSense, RevenueCat en App Store Connect in meerdere accounts met filters op app, platform en land

Monitor inkomsten, klikken, eCPM, abonnementen, installaties en betalingen op iPhone, iPad, Mac en Apple Watch

Kies de juiste RevenueCat-toegang

AdMate ondersteunt de configuratie van RevenueCat-accounts en meerdere projecten. Afhankelijk van het huidige account en de versie kan het scherm voor inloggegevens de ondersteunde API v2-autorisatie gebruiken, inclusief geheime projectsleutels, en een autorisatieproces op accountniveau aanbieden.

Gebruik de inloggegevens met de minste rechten waarmee je de benodigde gegevens kunt lezen. Een openbare SDK-sleutel die bedoeld is om in een app te gebruiken, vervangt niet automatisch geheime API-inloggegevens, en inloggegevens voor één project tonen niet vanzelfsprekend alle projecten van een organisatie.

Voor de installatie:

bepaal welke RevenueCat-organisatie en welke projecten je nodig hebt;
ga na of je één projectsleutel toevoegt of een koppeling op accountniveau;
verwijder oude sleutels die je niet meer nodig hebt;
kies een duidelijke alias voor het account in AdMate.

Het RevenueCat-account toevoegen

Open Instellingen en accountbeheer in AdMate.
Zoek RevenueCat en kies ervoor een account toe te voegen.
Selecteer de autorisatiemethode die de huidige app toont.
Voer de gevraagde inloggegevens in of autoriseer ze zonder tekens te wijzigen.
Laat AdMate het account valideren en de toegankelijke projecten ophalen.
Geef de koppeling een herkenbare naam als er meerdere organisaties of klanten zijn.
Open het RevenueCat-overzicht en controleer het bedoelde project en de periode.

Gebruik je meerdere geheime projectsleutels, koppel ze dan elk aan het juiste project. Noem niet elk item gewoon ‘RevenueCat’; een beschrijvende alias voorkomt per ongeluk vergelijkingen tussen klanten.

Wat je na de koppeling controleert

Begin bij de identiteit voordat je naar totalen kijkt:

naam van het account of de organisatie;
projectnaam en project-ID;
opgenomen apps en stores;
geselecteerd datumbereik en valuta;
of terugbetalingen of neerwaartse correcties in de getoonde statistiek zijn meegenomen.

Vergelijk daarna een afgesloten periode met het RevenueCat-dashboard. Kleine verschillen kunnen ontstaan door het moment van vernieuwen, valutaregels of definities van statistieken. Een project dat helemaal ontbreekt, wijst meestal op het bereik van de inloggegevens of de projectkoppeling, niet op een rekenfout.

Dashboardtoegang en webhooks zijn gescheiden

AdMate gebruikt RevenueCat op twee verschillende manieren:

de Apple-app vraagt de door de gebruiker ingestelde projecten op voor dashboardgegevens;
de AdMate-API kan RevenueCat-webhooks ontvangen voor meldingen.

Inloggegevens voor het dashboard instellen configureert niet automatisch een webhook, en een webhook aanmaken geeft de app geen toestemming om projectstatistieken op te vragen. Behandel ze als aparte taken met aparte inloggegevens en doelen.

De API bewaart tijdelijk context over het apparaat en het project, zodat een melding bruikbare namen en de valuta kan tonen. Die context is geen serverkopie van de volledige inkomstengeschiedenis of het toegangstoken van de gebruiker.

Een ontbrekend project oplossen

De inloggegevens worden geaccepteerd, maar er verschijnt maar één project

Controleer of de inloggegevens specifiek bij dat project horen. Voeg de benodigde sleutels toe of koppel ze, of gebruik de ondersteunde methode op accountniveau als dat past.

Er verschijnen geen statistieken voor een geldig project

Kies een afgesloten datumbereik met bekende transacties, controleer de project- en storefilters en vernieuw in de hoofdapp. Een nieuw of inactief project kan terecht nul opleveren.

De autorisatie mislukt plotseling

De sleutel is mogelijk ingetrokken, vervangen of met spaties gekopieerd. Controleer de status in RevenueCat en vervang hem daarna in AdMate. Bewaar geen ingetrokken sleutel als reserve.

De projectnaam klopt, maar het totaal lijkt fout

Controleer de definitie van de statistiek, terugbetalingen, valuta en datumgrenzen. Vergelijk RevenueCat-inkomsten niet rechtstreeks met de opbrengsten in App Store Connect zolang de reikwijdtes niet op elkaar zijn afgestemd.

Bescherm de inloggegevens

neem de sleutel nooit op in analytics, logs of een diagnosescreenshot;
gebruik een projectsleutel niet buiten de organisatie waarvoor hij bedoeld is;
vervang hem als hij is uitgelekt;
verwijder het AdMate-account van apparaten die het project niet meer mogen lezen;
controleer de toegang regelmatig wanneer een samenwerking met een opdrachtnemer of klant eindigt.

Lees verder over waarom de totalen van aanbieders verschillen voordat je een gecombineerd inkomstencijfer publiceert.

Veelgestelde vragen

Kan AdMate meerdere RevenueCat-projecten koppelen?

Ja. Het accountmodel ondersteunt meerdere projecten en projectinloggegevens. Geef elk project een naam en controleer het voordat je weergaven combineert.

Is een openbare RevenueCat-SDK-sleutel voldoende?

Gebruik het type inloggegevens dat de RevenueCat-instelling in AdMate vraagt. Openbare SDK-sleutels voor apps en geheime API-inloggegevens hebben verschillende doelen.

Stuurt AdMate alle abonnementsinkomsten naar zijn API?

Nee. De app vraagt de ingestelde diensten rechtstreeks op. De RevenueCat-context van de API dient voor webhookmeldingen en is geen opslag voor inkomsten.

Wat stuur ik naar support?

Stuur de projectnaam, het datumbereik, de statistiek en de afgeschermde foutmelding. Stuur nooit de geheime sleutel.