RevGlanceApp Store
Collega App Store Connect con una chiave API per leggere i report giornalieri Sales and Trends per iOS e Mac.
RevGlance legge i report giornalieri Sales and Trends di Apple tramite l'App Store Connect API. Il riepilogo SALES fornisce le app a pagamento e gli acquisti in-app; il report SUBSCRIBER fornisce ogni addebito di abbonamento, prova gratuita e rimborso.
Collegamento
- In App Store Connect, apri Users and Access › Integrations › App Store Connect API e genera una chiave del team con il ruolo Finance o Sales.
- Annota l'Issuer ID sopra l'elenco delle chiavi e il Key ID della chiave, poi scarica il file
.p8. Apple ti permette di scaricarlo una sola volta. - Trova il tuo vendor number in Payments and Financial Reports (in alto a sinistra).
- Compila i quattro campi, incollando l'intero file
.p8, comprese le righe-----BEGIN PRIVATE KEY-----, poi scegli Collega App Store.
Cosa chiede il modulo
| Campo | Esempio |
|---|---|
| ID emittente | 57246542-96fe-1a63-e053-0824d011072a |
| ID chiave | 2X9R4HXF34 |
| Numero fornitore | 85012345 |
| Chiave privata (contenuto del file .p8)Salvato cifrato | -----BEGIN PRIVATE KEY----- |
Aggiungi il webhook
I report arrivano con circa un giorno di ritardo. Le App Store Server Notifications avvisano RevGlance appena qualcosa cambia, così il report successivo viene scaricato non appena esiste.
- In RevGlance, apri Impostazioni › Fonti, apri il menu della fonte App Store e scegli Webhook.
- Inventa un segreto lungo e casuale, incollalo in Segreto di firma e salva.
- Copia l'URL del webhook e aggiungi alla fine
?token=seguito dal tuo segreto. - In App Store Connect, apri App Information della tua app e, in App Store Server Notifications, imposta quell'indirizzo come URL di produzione, versione 2.
RevGlance verifica il segreto nell'URL e la firma di Apple, una catena di certificati fino ad Apple Root CA G3.
Cosa aspettarsi
- Clienti anonimi. Apple non indica gli acquirenti. Ogni abbonato diventa un cliente con un Subscriber ID anonimo, e codici offerta, upgrade tra gruppi di abbonamenti e reset degli ID possono sembrare nuovi abbonamenti.
- Un anno di storico. I report giornalieri risalgono a un anno fa, e ogni giorno arriva con circa un giorno di ritardo.
- Le disdette compaiono in ritardo. Apple non segnala le disdette: un abbonamento termina quando il suo rinnovo è in ritardo di tre giorni.
Come viene calcolato l'App Store
- Il prezzo per il cliente conta come ricavo e la commissione è il prezzo per il cliente meno i tuoi proventi, quindi le imposte nei prezzi comprensivi di imposte appaiono come commissione.
- L'MRR è l'ultimo prezzo per il cliente, quindi include le imposte dove le includono i prezzi: i report di Apple non separano le imposte. Un'offerta introduttiva conta al suo prezzo di offerta, e il prezzo normale appare poi come un'espansione.
- Un rimborso proviene dal report di Apple con un prezzo negativo. Quando Apple annulla un rimborso, RevGlance rimuove il rimborso più recente di quell'abbonato e di quell'abbonamento. Apple non dice quale rimborso è stato annullato, quindi con più rimborsi sullo stesso abbonamento può essere rimosso quello sbagliato.
- I rimborsi richiesti dopo che Apple reimposta l'ID di un abbonato (180 giorni) vengono conservati, ma senza cliente.
- I crediti per i pacchetti di app (CMB-C) non sono rimborsi e vengono esclusi.
- Apple non mostra le disdette: un abbonamento termina quando un rinnovo è in ritardo di tre giorni.
- Gli addebiti non riusciti non vengono riportati, quindi quel valore resta a zero.