Come collegare RevenueCat ad AdMate

Una connessione RevenueCat offre ad AdMate una vista incentrata sugli abbonamenti accanto ai report pubblicitari e degli store. Può mostrare i progetti, le transazioni e le metriche esposti da RevenueCat senza trasformare l’API di AdMate in un archivio di ricavi lato server.

Le credenziali RevenueCat sono potenti. Prepara la connessione con attenzione, usa la modalità di autorizzazione offerta dalla versione attuale di AdMate e non incollare mai una chiave segreta in una segnalazione pubblica o in uno screenshot.

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

Scegli l’accesso RevenueCat corretto

AdMate supporta la configurazione di account RevenueCat e più progetti. A seconda dell’account e della versione attuali, la schermata delle credenziali può usare l’autorizzazione API v2 supportata, incluse le chiavi segrete di progetto, e può offrire un flusso di autorizzazione a livello di account.

Usa la credenziale con i privilegi minimi in grado di leggere i dati che ti servono. Una chiave SDK pubblica pensata per essere inclusa in un’app non sostituisce automaticamente una credenziale API segreta, e la credenziale di un progetto non permette necessariamente di elencare tutti i progetti di un’organizzazione.

Prima della configurazione:

individua l’organizzazione RevenueCat e i progetti che ti servono;
verifica se stai aggiungendo la chiave di un solo progetto o una connessione a livello di account;
rimuovi le vecchie chiavi non più necessarie;
scegli un alias chiaro per l’account in AdMate.

Aggiungi l’account RevenueCat

Apri Impostazioni e la gestione degli account in AdMate.
Trova RevenueCat e scegli di aggiungere un account.
Seleziona il metodo di autorizzazione mostrato dall’app attuale.
Inserisci o autorizza la credenziale richiesta senza modificarne i caratteri.
Lascia che AdMate convalidi l’account e recuperi i progetti accessibili.
Dai alla connessione un nome riconoscibile quando ci sono più organizzazioni o clienti.
Apri il riepilogo RevenueCat e verifica il progetto e il periodo previsti.

Se usi più chiavi segrete di progetto, associa ciascuna al progetto corretto. Non chiamare ogni voce semplicemente “RevenueCat”: un alias descrittivo evita confronti accidentali tra clienti diversi.

Cosa verificare dopo il collegamento

Parti dall’identità prima dei totali:

nome dell’account o dell’organizzazione;
nome e identificatore del progetto;
app e store inclusi;
intervallo di date e valuta selezionati;
se rimborsi o rettifiche al ribasso sono inclusi nella metrica mostrata.

Poi confronta un periodo chiuso con la dashboard di RevenueCat. Piccole differenze possono dipendere dai tempi di aggiornamento, dalle regole sulle valute o dalle definizioni delle metriche. Un progetto completamente assente indica di solito un problema di ambito della credenziale o di associazione del progetto, non un errore di calcolo.

Accesso alla dashboard e webhook sono separati

AdMate usa RevenueCat in due modi distinti:

l’app Apple interroga i progetti configurati dall’utente per i dati della dashboard;
l’API di AdMate può ricevere i webhook di RevenueCat per le notifiche.

Configurare una credenziale per la dashboard non configura automaticamente un webhook, e creare un webhook non dà all’app il permesso di elencare le metriche di un progetto. Trattali come attività separate, con credenziali e scopi separati.

L’API conserva un contesto temporaneo di dispositivo e progetto affinché una notifica possa mostrare nomi e valuta utili. Questo contesto non è una copia lato server dell’intera cronologia dei ricavi dell’utente né del suo token di accesso.

Risolvi l’assenza di un progetto

La credenziale viene convalidata ma compare un solo progetto

Verifica se la credenziale appartiene specificamente a quel progetto. Aggiungi o associa le chiavi necessarie, oppure usa il metodo supportato a livello di account se è appropriato.

Non compaiono metriche per un progetto valido

Seleziona un intervallo di date concluso con transazioni note, verifica i filtri di progetto e store e aggiorna nell’app principale. Un progetto nuovo o inattivo può correttamente restituire zero.

L’autorizzazione fallisce all’improvviso

La chiave potrebbe essere stata revocata, ruotata o copiata con spazi. Verificane lo stato in RevenueCat, poi sostituiscila in AdMate. Non tenere una chiave revocata come riserva.

Il nome del progetto è giusto ma il totale sembra sbagliato

Controlla la definizione della metrica, i rimborsi, la valuta e i limiti delle date. Non confrontare direttamente i ricavi di RevenueCat con i proventi di App Store Connect finché gli ambiti non sono allineati.

Proteggi la credenziale

non includere mai la chiave in analisi, log o screenshot diagnostici;
non riutilizzare una chiave di progetto al di fuori dell’organizzazione prevista;
ruotala se è stata esposta;
rimuovi l’account AdMate dai dispositivi che non devono più leggere il progetto;
rivedi periodicamente gli accessi quando termina un rapporto con un collaboratore o un cliente.

Continua con perché i totali dei fornitori differiscono prima di pubblicare un dato di ricavi combinato.

Domande frequenti

AdMate può collegare più progetti RevenueCat?

Sì. Il modello di account supporta più progetti e credenziali di progetto. Assegna un nome e verifica ogni progetto prima di combinare le viste.

Basta una chiave SDK pubblica di RevenueCat?

Usa il tipo di credenziale richiesto dalla configurazione RevenueCat di AdMate. Le chiavi SDK pubbliche delle app e le credenziali API segrete hanno scopi diversi.

AdMate invia tutti i ricavi degli abbonamenti alla sua API?

No. L’app interroga direttamente i servizi configurati. Il contesto RevenueCat dell’API serve alle notifiche tramite webhook e non è un archivio di ricavi.

Cosa devo inviare all’assistenza?

Invia il nome del progetto, l’intervallo di date, la metrica e l’errore oscurato. Non inviare mai la chiave segreta.