Come collegare App Store Connect ad AdMate

App Store Connect contiene diverse famiglie di dati: metadati delle app, recensioni, analisi, vendite, proventi stimati e report finanziari definitivi. AdMate può portare tutte queste informazioni nella stessa app usata per AdMob e RevenueCat, ma la connessione deve avere gli identificatori e le autorizzazioni corretti.

La configurazione usa una chiave API di App Store Connect. Tratta la chiave privata come una password: importala solo nella schermata delle credenziali e non allegarla mai a una richiesta di assistenza.

AdMate

Tutti i tuoi ricavi in un'unica dashboard

Monitora AdMob, AdSense, RevenueCat e App Store Connect su più account con filtri per app, piattaforma e Paese

Controlla ricavi, clic, eCPM, abbonamenti, installazioni e pagamenti su iPhone, iPad, Mac e Apple Watch

Cosa ti serve da App Store Connect

Prepara i valori mostrati da Apple nella sezione Utenti e accesso per la chiave API:

Key ID, che identifica la chiave API;
Issuer ID, che identifica l’emittente dell’API di App Store Connect;
il contenuto o il file della chiave privata .p8;
un alias dell’account chiaro per AdMate;
il numero fornitore quando il report di vendita o finanziario richiesto lo prevede.

Il ruolo assegnato alla chiave determina cosa restituisce Apple. Una chiave in grado di elencare le app potrebbe comunque non avere accesso ai dati di vendita o finanziari. Usa il ruolo adatto più ristretto, ma assicurati che copra i report che intendi effettivamente leggere.

Di solito Apple consente di scaricare il file della chiave privata una sola volta. Conserva l’originale in un luogo sicuro, fuori dal repository e fuori dagli screenshot. Se il file viene perso o esposto, revoca la chiave e creane una nuova invece di chiedere a qualcuno di inviartela via chat.

Aggiungi l’account in AdMate

Apri Impostazioni e la gestione degli account.
Scegli di aggiungere un account App Store Connect.
Inserisci un nome visualizzato riconoscibile.
Aggiungi Key ID e Issuer ID esattamente come li fornisce Apple.
Importa o incolla la chiave privata tramite la schermata delle credenziali.
Aggiungi il numero fornitore quando i report finanziari o di vendita lo richiedono.
Salva l’account e lascia che AdMate convalidi le credenziali.
Apri il riepilogo dell’account e verifica che compaiano le app previste.

Evita di modificare a mano l’intestazione o la chiusura della chiave .p8. Testo aggiuntivo, interruzioni di riga mancanti o una chiave di un altro emittente impediranno la creazione del token.

Verifica separatamente ogni area di dati

Un riepilogo tutto verde non dimostra che ogni endpoint di App Store Connect sia disponibile. Controlla le aree che intendi usare:

App e metadati

Verifica che compaiano le app e le icone previste. Un’app mancante può indicare che la chiave appartiene a un’altra organizzazione fornitrice o che il suo ruolo è limitato.

Recensioni

Apri la vista delle recensioni e controlla un’app nota. Le recensioni dipendono da store e paese; una schermata vuota valida può semplicemente indicare che non ci sono recensioni corrispondenti.

Analisi

Scegli un periodo completo e tieni conto dei tempi di disponibilità dei report di Apple. Alcuni report di analisi non sono immediati e hanno granularità e ritardi propri.

Vendite e proventi

Etichetta separatamente le vendite ai clienti e i proventi dello sviluppatore. Non sono lo stesso valore e nessuno dei due va confuso con un pagamento bancario.

Report finanziari

I report finanziari usano i periodi di rendicontazione chiusi di Apple e possono richiedere il numero fornitore e il ruolo corretti. Usali per la riconciliazione invece di aspettarti che compaia il giorno in corso.

Risolvi i problemi di connessione

Chiave o firma non valida

Ricontrolla insieme Key ID, Issuer ID e chiave privata. Una chiave valida associata all’emittente sbagliato fallisce comunque. Se la chiave potrebbe essere stata esposta, revocala prima di proseguire con i test.

Le app si caricano ma i report finanziari no

Controlla il ruolo della chiave API, il numero fornitore e il periodo finanziario richiesto. L’accesso ai metadati da solo non garantisce l’accesso ai dati finanziari.

Le analisi non mostrano dati

Usa un intervallo storico supportato, verifica che il report sia già disponibile e conferma che l’app selezionata abbia generato la metrica richiesta.

Compaiono le app di un’altra organizzazione

Rimuovi l’account e aggiungi la chiave del fornitore corretto. Non unire i totali di due organizzazioni solo perché le loro app seguono la stessa convenzione di denominazione dei bundle.

Più account App Store Connect

AdMate supporta più account. Usa alias che identifichino l’organizzazione, non la persona che ha creato la chiave. Quando una chiave viene ruotata, sostituiscila nell’account corretto e prova separatamente app, analisi e finanze.

Per i confronti con le analisi degli abbonamenti, leggi perché i totali di App Store Connect e RevenueCat differiscono.

Domande frequenti

AdMate ha bisogno della password del mio ID Apple?

No. La connessione usa una chiave API di App Store Connect, l’emittente e gli identificatori correlati. Non inserire né condividere mai la password dell’ID Apple per questa configurazione.

Perché le app si caricano ma i proventi no?

La chiave potrebbe avere autorizzazioni sufficienti per i metadati delle app ma non per vendite o finanze, oppure potrebbero mancare il numero fornitore e il periodo del report.

Posso riutilizzare una chiave su più dispositivi AdMate?

Tecnicamente la stessa credenziale del fornitore può funzionare, ma ogni copia aggiuntiva aumenta l’esposizione. Segui la policy di gestione delle chiavi della tua organizzazione e revoca le chiavi dai dispositivi che non devono più avere accesso.

Le stime di App Store Connect sono valori contabili definitivi?

No. Per la contabilità usa i report finanziari chiusi e i pagamenti effettivi.