RevGlanceDocumentazione

Cronologia sincronizzazioni

Controlla se una fonte è in pari, cosa ha cambiato ogni sincronizzazione e se il suo webhook funziona.

Ogni fonte che si sincronizza ha la propria cronologia: come sta andando ora e un registro di ogni sincronizzazione degli ultimi 90 giorni. Guardala quando un numero sembra non aggiornato o un webhook sembra non funzionare.

Dove trovarla

  • In Impostazioni › Fonti, apri il menu "…" di una fonte e scegli Cronologia sincronizzazioni.
  • Nello stato di sincronizzazione, in fondo alla pagina, scegli Cronologia sincronizzazioni sotto la fonte.

Ce l'hanno solo le fonti che si sincronizzano, quindi non i dati di esempio.

Stato di salute

Questa scheda mostra come sta andando la fonte ora.

  • Stato può essere Aggiornato, Sincronizzazione, In ritardo o Non riuscita. In ritardo significa che l'ultima sincronizzazione ha più di due ore, o che una sincronizzazione fallita aspetta il prossimo tentativo. Non riuscita significa che la fonte ha un errore, mostrato sotto questi campi. Conta anche una sincronizzazione con Lettura parziale. L'errore resta finché una sincronizzazione successiva non legge tutto.
  • Ultima sincronizzazione è l'ultima volta che RevGlance ha finito di leggere la fonte. Una sincronizzazione fermata da un errore non la cambia.
  • Dati più recenti è la data dell'ultimo pagamento o modifica di abbonamento che RevGlance ha da questa fonte.
  • Webhook indica se le chiamate del provider stanno arrivando. Vedi Stato del webhook.

Quando la prova è finita, la scheda lo dice e le nuove sincronizzazioni aspettano finché non acquisti RevGlance.

Perché Dati più recenti può essere più vecchio di Ultima sincronizzazione

Ultima sincronizzazione dice quando RevGlance ha letto la fonte. Dati più recenti dice quanto sono recenti i dati trovati. Una sincronizzazione può andare bene e non trovare niente di più recente:

  • App Store: i report di Apple arrivano con circa un giorno di ritardo.
  • Google Play: Google pubblica i report entro 3-7 giorni.
  • Qualsiasi provider: non è successo niente. Un periodo tranquillo, senza pagamenti né modifiche agli abbonamenti, lascia la data dov'è.

Cosa avvia una sincronizzazione

Ogni riga del Registro sincronizzazioni dice cosa l'ha avviata:

EtichettaCosa è successo
WebhookIl provider ha chiamato RevGlance per dire che qualcosa è cambiato.
PianificataLa sincronizzazione normale: ogni ora finché qualcuno usa l'attività, altrimenti una volta al giorno.
Avviata a manoQualcuno ha premuto Sincronizza sulla fonte o Sincronizza ora, oppure ha disattivato la modalità privata.
Prima sincronizzazioneLa fonte è appena stata collegata.
Di nuovo nell'appQualcuno è tornato dopo 30 giorni di assenza e l'ultima sincronizzazione della fonte aveva più di un'ora.
Rilettura completaRevGlance ha riletto tutto lo storico della fonte, cosa che facciamo quando cambia una regola di conteggio. Non puoi avviarla tu.

Per ogni fonte aspetta in coda una sola sincronizzazione alla volta. Una chiamata webhook che arriva nel frattempo si unisce a quella in attesa, quindi puoi vedere meno righe Webhook rispetto alle chiamate.

Come leggere il registro

La sincronizzazione più recente viene per prima. Ogni riga mostra quando è iniziata, cosa l'ha avviata e, per una singola sincronizzazione, quanto è durata.

Conteggi

Ogni tipo di record cambiato da una sincronizzazione ha i propri conteggi: Pagamenti, Modifiche agli abbonamenti, Clienti, Prove e Disdette. Un conteggio pari a zero non viene mostrato.

  • 3 nuovi: record aggiunti da questa sincronizzazione.
  • 2 aggiornati: record che RevGlance aveva già, cambiati da questa sincronizzazione.
  • 4 rimossi: record che non ci sono più dopo questa sincronizzazione.

Nessuna modifica significa che la sincronizzazione non ha trovato niente da fare. Le sincronizzazioni senza modifiche consecutive e avviate allo stesso modo si raccolgono in una riga, che dice quante sono e fin dove risalgono. Così una sincronizzazione oraria non nasconde quelle che contano.

Quando una sincronizzazione ha problemi

  • In corso: la sincronizzazione è ancora in corso. La pagina si aggiorna da sola.
  • Lettura parziale: è finita, ma una parte del provider non si è potuta leggere. La riga mostra l'errore. Ciò che ha letto viene salvato e contato, e la sincronizzazione successiva rilegge lo stesso tratto.
  • Non riuscita: un errore l'ha fermata. La riga mostra l'errore, e ciò che ha letto prima di fermarsi viene salvato e contato. Interrotta prima della fine. significa che la sincronizzazione è stata interrotta senza un errore da mostrare.

RevGlance riprova da solo una sincronizzazione fallita, e ogni tentativo ha la propria riga. Una riga Non riuscita con sopra una riga senza errori significa che il problema è sparito, quindi non c'è niente da fare. Se Stato indica ancora Non riuscita, l'errore dice cosa è andato storto.

Cifre corrette

Qui compaiono le cifre registrate che la sincronizzazione ha corretto, con il vecchio e il nuovo valore. Una correzione non è qualcosa che ha fatto un cliente.

  • Dopo una Rilettura completa: qualsiasi totale che è cambiato, come MRR, rimborsi o commissioni.
  • L'MRR di un abbonamento: l'importo registrato di un abbonamento è stato corretto.
  • Una data di disdetta: la data di una disdetta indicata dal provider è diversa da quella registrata.

Una riga ne elenca al massimo cinque, poi e altri 3.

Stato del webhook

Proprietari e amministratori vedono lo stato del webhook in Stato di salute. Può indicare quattro cose:

  • Ultima chiamata ricevuta, con l'ora: le chiamate stanno arrivando. Non c'è niente da fare.
  • Configurato, ma non è ancora arrivata nessuna chiamata. La fonte è pronta, ma il provider non ha ancora chiamato. Controlla che il webhook sia aggiunto nel provider. Le chiamate arrivano solo quando qualcosa cambia, quindi una fonte tranquilla può restare così per un po'.
  • Non configurato, quindi i nuovi dati aspettano la prossima sincronizzazione pianificata. Nessun segreto è salvato. I nuovi dati arrivano con la sincronizzazione oraria o giornaliera finché non aggiungi il webhook.
  • Le chiamate vengono rifiutate, con l'ora dell'ultima: il provider raggiunge RevGlance, ma le sue chiamate non superano il controllo e quindi non avviano nessuna sincronizzazione.

In tutti gli stati tranne il primo, la scheda porta alla guida passo dopo passo del tuo provider.

Quando le chiamate vengono rifiutate

L'avviso compare dopo 3 chiamate rifiutate di fila, quindi una chiamata isolata non lo fa scattare. Webhook rifiutato compare allora anche sulla riga della fonte in Impostazioni › Fonti. Cosa controllare dipende da come il provider verifica le sue chiamate:

  • Stripe, Polar, Lemon Squeezy, Paddle, Recurly: copia di nuovo il segreto di firma dal provider e incollalo in Segreto di firma, nel pannello Webhook della fonte.
  • Gumroad, App Store, Google Play, Chargebee: controlla che il ?token= nell'URL presso il provider corrisponda al segreto salvato in Segreto di firma, oppure salvane uno nuovo e aggiorna l'URL.
  • Braintree, Shopify: non c'è nessun segreto da incollare. Controlla che il webhook sia stato aggiunto nello stesso account Braintree o nella stessa app Shopify con cui si collega la fonte.

Vengono rifiutate anche le chiamate a una fonte senza segreto salvato. Salvare il segreto risolve il problema.

L'avviso sparisce con la prossima chiamata valida o quando salvi un nuovo segreto. Se il segreto è ancora sbagliato, torna dopo altre 3 chiamate rifiutate. Sparisce anche 7 giorni dopo l'ultima chiamata rifiutata.

Per quanto tempo viene conservata

Ogni sincronizzazione resta nel registro per 90 giorni, poi viene eliminata. Rimuovere una fonte rimuove anche la sua cronologia di sincronizzazione.

Chi vede cosa

Tutti nell'attività possono aprire la cronologia di sincronizzazione di una fonte e leggere Stato di salute e il Registro sincronizzazioni. I visualizzatori non vedono lo stato del webhook: né il campo Webhook, né il badge, né la voce di menu. Avviare una sincronizzazione e salvare un segreto spetta a proprietari e amministratori. Vedi Team e ruoli.