App Store Connect koppelen aan AdMate

App Store Connect bevat verschillende soorten gegevens: app-metadata, recensies, analyses, verkopen, geschatte opbrengsten en definitieve financiële rapporten. AdMate kan die onderdelen samenbrengen in dezelfde app die je voor AdMob en RevenueCat gebruikt, maar de koppeling moet de juiste ID’s en rechten hebben.

De installatie gebruikt een App Store Connect API-sleutel. Behandel de privésleutel als een wachtwoord: importeer hem alleen in het scherm voor inloggegevens en voeg hem nooit toe aan een supportverzoek.

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

Wat je nodig hebt uit App Store Connect

Houd de waarden bij de hand die Apple in het onderdeel Gebruikers en toegang voor de API-sleutel toont:

Key ID, die de API-sleutel identificeert;
Issuer ID, die de uitgever van de App Store Connect API identificeert;
de inhoud of het bestand van de privésleutel .p8;
een duidelijke accountalias voor AdMate;
het leveranciersnummer wanneer het gevraagde verkoop- of financiële rapport dat vereist.

De rol die aan de sleutel is toegewezen, bepaalt wat Apple teruggeeft. Een sleutel die apps kan opvragen, heeft mogelijk toch geen toegang tot verkoop- of financiële gegevens. Gebruik de kleinste passende rol, maar zorg dat die de rapporten dekt die je echt wilt lezen.

Apple laat het bestand met de privésleutel normaal maar één keer downloaden. Bewaar het origineel veilig, buiten de repository en buiten screenshots. Raakt het bestand kwijt of is het uitgelekt, trek de sleutel dan in en maak een nieuwe, in plaats van iemand te vragen hem via chat te sturen.

Het account toevoegen in AdMate

Open Instellingen en accountbeheer.
Kies ervoor een App Store Connect-account toe te voegen.
Voer een herkenbare weergavenaam in.
Voeg Key ID en Issuer ID precies zo toe als Apple ze geeft.
Importeer of plak de privésleutel via het scherm voor inloggegevens.
Voeg het leveranciersnummer toe als financiële of verkooprapporten het nodig hebben.
Sla het account op en laat AdMate de inloggegevens valideren.
Open het accountoverzicht en controleer of de verwachte apps verschijnen.

Bewerk de kop- of voettekst van de .p8-sleutel niet handmatig. Extra tekst, ontbrekende regeleinden of een sleutel van een andere uitgever voorkomen dat het token kan worden aangemaakt.

Controleer elk gegevensonderdeel apart

Eén groen overzicht bewijst niet dat elk App Store Connect-endpoint beschikbaar is. Controleer de onderdelen die je wilt gebruiken:

Apps en metadata

Controleer of de verwachte apps en pictogrammen verschijnen. Een ontbrekende app kan erop wijzen dat de sleutel bij een andere aanbiedersorganisatie hoort of dat de rol beperkt is.

Recensies

Open de recensieweergave en controleer een bekende app. Recensies zijn store- en landgegevens; een geldige lege weergave kan simpelweg betekenen dat er geen passende recensies zijn.

Analyses

Kies een volledige periode en houd rekening met wanneer Apple de rapporten beschikbaar stelt. Sommige analyserapporten zijn niet direct beschikbaar en hebben hun eigen detailniveau en vertraging.

Verkopen en opbrengsten

Label klantverkopen en ontwikkelaarsopbrengsten apart. Het zijn niet dezelfde waarden, en geen van beide mag worden verward met een bankbetaling.

Financiële rapporten

Financiële rapporten gebruiken de afgesloten rapportageperiodes van Apple en kunnen het juiste leveranciersnummer en de juiste rol vereisen. Gebruik ze voor afstemming in plaats van te verwachten dat de huidige dag verschijnt.

De koppeling oplossen

Ongeldige sleutel of handtekening

Controleer Key ID, Issuer ID en privésleutel opnieuw als één set. Een geldige sleutel in combinatie met de verkeerde uitgever mislukt alsnog. Is de sleutel mogelijk uitgelekt, trek hem dan in voordat je verder test.

Apps laden, maar financiële rapporten niet

Controleer de rol van de API-sleutel, het leveranciersnummer en de gevraagde financiële periode. Toegang tot metadata garandeert geen toegang tot financiële gegevens.

Analyses tonen geen gegevens

Gebruik een ondersteund historisch bereik, controleer of het rapport al beschikbaar is en bevestig dat de geselecteerde app de gevraagde statistiek heeft opgeleverd.

Er verschijnen apps van een andere organisatie

Verwijder het account en voeg de sleutel van de juiste aanbieder toe. Voeg de totalen van twee organisaties niet samen alleen omdat hun apps dezelfde naamgevingsconventie voor bundles gebruiken.

Meerdere App Store Connect-accounts

AdMate ondersteunt meer dan één account. Gebruik aliassen die de organisatie aanduiden, niet de persoon die de sleutel heeft gemaakt. Wordt een sleutel vervangen, vervang hem dan in het juiste account en test apps, analyses en financiën afzonderlijk.

Lees voor vergelijkingen met abonnementsanalyses waarom de totalen van App Store Connect en RevenueCat verschillen.

Veelgestelde vragen

Heeft AdMate het wachtwoord van mijn Apple ID nodig?

Nee. De koppeling gebruikt een App Store Connect API-sleutel, de uitgever en bijbehorende ID’s. Voer voor deze installatie nooit een Apple ID-wachtwoord in en deel het niet.

Waarom laden apps wel, maar opbrengsten niet?

De sleutel heeft mogelijk genoeg rechten voor app-metadata, maar niet voor verkopen of financiën, of het leveranciersnummer en de rapportageperiode ontbreken.

Kan ik één sleutel op meerdere AdMate-apparaten gebruiken?

Technisch kunnen dezelfde inloggegevens werken, maar elke extra kopie vergroot het risico. Volg het sleutelbeleid van je organisatie en trek sleutels in op apparaten die geen toegang meer mogen hebben.

Zijn de schattingen van App Store Connect definitieve boekhoudwaarden?

Nee. Gebruik voor de boekhouding afgesloten financiële rapporten en werkelijke betalingen.