Come configurare le notifiche di AdMate e i webhook di RevenueCat

Le notifiche di AdMate possono aggiungere contesto agli eventi di RevenueCat, ma il percorso delle notifiche è separato dalla connessione della dashboard. L’app interroga i progetti con le credenziali configurate dall’utente; l’API di AdMate riceve i webhook configurati e usa un contesto temporaneo del dispositivo per creare la notifica appropriata.

Mantenere separate queste responsabilità è essenziale per la sicurezza e la risoluzione dei problemi.

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

Due configurazioni, due scopi

Connessione della dashboard

L’account RevenueCat in AdMate consente all’app di leggere i progetti e le metriche disponibili con l’autorizzazione configurata.

Consegna dei webhook

RevenueCat invia gli eventi all’endpoint webhook dell’API di AdMate. L’API usa il contesto registrato del dispositivo, come progetto, app, lingua e valuta, per preparare le notifiche supportate.

Aggiungere una chiave alla dashboard non crea automaticamente il webhook presso il provider. Creare il webhook non autorizza la dashboard dell’app.

Prepara il contesto dell’app

Collega e convalida l’account RevenueCat in AdMate.
Seleziona i progetti e le applicazioni previsti.
Apri la configurazione dei webhook o delle notifiche fornita dall’app.
Sincronizza il contesto del dispositivo richiesto dalla procedura.
Conferma lingua, valuta e nomi dei progetti.
Consenti le notifiche a livello di sistema operativo.

Il contesto dell’API ha una durata limitata e va aggiornato tramite la procedura supportata dall’app. Non è un database finanziario permanente.

Configura RevenueCat

Usa la configurazione dei webhook di RevenueCat per aggiungere l’endpoint e le informazioni di autorizzazione mostrate dalla procedura di AdMate. Segui le istruzioni attuali nell’app invece di copiare credenziali da un altro ambiente.

Quando possibile, prova con un evento non sensibile. Non includere mai una chiave segreta o il valore completo di autorizzazione del webhook in uno screenshot, in un repository o in una discussione pubblica di assistenza.

Verifica tutto il percorso

Controlla l’intera catena:

RevenueCat accetta la configurazione del webhook.
Un evento supportato viene consegnato correttamente.
L’API di AdMate riesce a risolvere il contesto del dispositivo e del progetto.
La consegna push viene accettata dal servizio della piattaforma.
Il dispositivo è ancora registrato e consente le notifiche.
Progetto, app, lingua e valuta mostrati sono corretti.

Un aggiornamento riuscito della dashboard verifica solo un percorso diverso.

Risoluzione dei problemi

RevenueCat segnala un errore del webhook

Controlla endpoint, autorizzazione e stato della risposta in RevenueCat. Non sostituire chiavi della dashboard che non c’entrano.

Il webhook funziona ma non arriva nessuna notifica

Verifica contesto del dispositivo, permesso per le notifiche push, registrazione e se il tipo di evento è supportato. Il contesto del dispositivo può scadere dopo un periodo di inattività.

La notifica mostra il nome di progetto sbagliato

Aggiorna il contesto dal progetto corretto e assicurati che due account non siano stati associati allo stesso nome visualizzato.

Un dispositivo funziona e un altro no

Ogni dispositivo ha la propria registrazione e il proprio contesto. Verifica permessi e contesto sul dispositivo interessato.

Regole di sicurezza

Tieni l’autorizzazione dei webhook e le chiavi dei provider fuori da Git.
Non registrare nei log payload completi che contengono identificatori di clienti o transazioni.
Non usare l’API dei webhook come archivio dei ricavi.
Sostituisci immediatamente le autorizzazioni esposte.
Rimuovi il contesto di un dispositivo quando non deve più ricevere eventi.

Domande frequenti

AdMate salva tutta la mia cronologia RevenueCat sul suo server?

No. L’API elabora gli eventi webhook e un contesto temporaneo di dispositivo e progetto; l’app interroga direttamente i servizi configurati.

Perché mi servono sia un account per la dashboard sia un webhook?

Servono percorsi diversi: i report interattivi e le notifiche di eventi consegnate dal server.

Un webhook può risolvere metriche mancanti nella dashboard?

No. Controlla l’autorizzazione RevenueCat dell’app e l’associazione dei progetti.

Che cosa dovrebbe contenere una segnalazione sicura all’assistenza?

Tipo di evento, orario approssimativo, stato oscurato e contesto di dispositivo e app, mai chiavi segrete o identificatori completi dei clienti.