RevGlanceDokumentacja

Historia synchronizacji

Sprawdź, czy źródło nadąża, co zmieniła każda synchronizacja i czy działa jego webhook.

Każde źródło, które się synchronizuje, ma własną historię: bieżący stan i dziennik każdej synchronizacji z ostatnich 90 dni. Zajrzyj tu, gdy liczba wygląda na nieaktualną albo webhook zdaje się nie działać.

Gdzie ją znaleźć

  • W Ustawienia › Źródła otwórz menu "…" źródła i wybierz Historia synchronizacji.
  • W statusie synchronizacji na dole strony wybierz Historia synchronizacji pod źródłem.

Mają ją tylko źródła, które się synchronizują, więc przykładowe dane jej nie mają.

Kondycja

Ta karta pokazuje bieżący stan źródła.

  • Status to Aktualne, Synchronizowanie, Opóźnione lub Niepowodzenie. Opóźnione oznacza, że ostatnia synchronizacja ma ponad dwie godziny albo że nieudana synchronizacja czeka na kolejną próbę. Niepowodzenie oznacza, że źródło ma błąd, widoczny pod tymi polami. Liczy się też synchronizacja ze stanem Odczytano częściowo. Błąd zostaje, dopóki późniejsza synchronizacja nie odczyta wszystkiego.
  • Ostatnia synchronizacja to moment, w którym RevGlance ostatnio skończył odczytywać źródło. Synchronizacja zatrzymana przez błąd go nie zmienia.
  • Najnowsze dane to data ostatniej płatności lub zmiany subskrypcji, jaką RevGlance ma z tego źródła.
  • Webhook mówi, czy wywołania od dostawcy docierają. Zobacz Status webhooka.

Gdy okres próbny się skończy, karta o tym informuje, a nowe synchronizacje czekają na zakup RevGlance.

Dlaczego Najnowsze dane mogą być starsze niż Ostatnia synchronizacja

Ostatnia synchronizacja mówi, kiedy RevGlance odczytał źródło. Najnowsze dane mówi, jak świeże są znalezione dane. Synchronizacja może przebiec dobrze i nie znaleźć nic nowszego:

  • App Store: raporty Apple docierają z około jednodniowym opóźnieniem.
  • Google Play: Google publikuje raporty w ciągu 3 do 7 dni.
  • Każdy dostawca: nic się nie wydarzyło. Spokojny okres bez płatności i zmian subskrypcji pozostawia datę bez zmian.

Co uruchamia synchronizację

Każdy wiersz w Dziennik synchronizacji mówi, co ją uruchomiło:

EtykietaCo się stało
WebhookDostawca wywołał RevGlance, aby powiadomić o zmianie.
ZaplanowanaZwykła synchronizacja: co godzinę, dopóki ktoś korzysta z firmy, w przeciwnym razie raz dziennie.
Uruchomiona ręcznieKtoś kliknął Synchronizuj przy źródle lub Synchronizuj teraz albo wyłączył tryb prywatny.
Pierwsza synchronizacjaŹródło zostało właśnie połączone.
Powrót do aplikacjiKtoś wrócił po 30 dniach nieobecności, a ostatnia synchronizacja źródła miała ponad godzinę.
Pełny ponowny odczytRevGlance odczytał ponownie całą historię źródła, co robimy po zmianie reguły liczenia. Nie można uruchomić tego samodzielnie.

W kolejce czeka naraz tylko jedna synchronizacja danego źródła. Wywołanie webhooka, które dotrze w tym czasie, dołącza do niej, więc wierszy Webhook może być mniej niż wywołań.

Jak czytać dziennik

Najnowsza synchronizacja jest na górze. Każdy wiersz pokazuje, kiedy się zaczęła, co ją uruchomiło i, w przypadku pojedynczej synchronizacji, ile trwała.

Liczniki

Każdy rodzaj rekordu zmieniony przez synchronizację ma własne liczniki: Płatności, Zmiany subskrypcji, Klienci, Okresy próbne i Anulowania. Licznik równy zero nie jest pokazywany.

  • Nowe: 3: rekordy dodane przez tę synchronizację.
  • Zaktualizowano: 2: rekordy, które RevGlance już miał, zmienione przez tę synchronizację.
  • Usunięto: 4: rekordy, których po tej synchronizacji już nie ma.

Bez zmian oznacza, że synchronizacja nie miała nic do zrobienia. Następujące po sobie synchronizacje bez zmian, uruchomione w ten sam sposób, są zwijane w jeden wiersz, który mówi, ile ich jest i jak daleko sięgają. Dzięki temu cogodzinna synchronizacja nie przysłania tych ważnych.

Gdy synchronizacja ma problemy

  • W toku: synchronizacja wciąż trwa. Strona aktualizuje się sama.
  • Odczytano częściowo: zakończyła się, ale części danych dostawcy nie udało się odczytać. Wiersz pokazuje błąd. To, co odczytano, jest zapisane i policzone, a kolejna synchronizacja odczytuje ten sam fragment ponownie.
  • Niepowodzenie: zatrzymał ją błąd. Wiersz pokazuje błąd, a to, co odczytano przed zatrzymaniem, jest zapisane i policzone. Zatrzymano przed zakończeniem. oznacza, że synchronizacja została przerwana i nie ma błędu do pokazania.

RevGlance sam ponawia nieudaną synchronizację, a każda próba ma własny wiersz. Wiersz Niepowodzenie z bezbłędnym wierszem powyżej oznacza, że problem minął i nie trzeba nic robić. Jeśli Status wciąż pokazuje Niepowodzenie, błąd mówi, co poszło nie tak.

Poprawione liczby

Tu widać zapisane liczby, które synchronizacja poprawiła, ze starą i nową wartością. Poprawka nie jest działaniem klienta.

  • Po Pełny ponowny odczyt: każda suma, która się zmieniła, np. MRR, zwroty lub prowizje.
  • MRR subskrypcji: poprawiono zapisaną kwotę jednej subskrypcji.
  • Data anulowania: data anulowania podana przez dostawcę różni się od zapisanej.

Wiersz pokazuje najwyżej pięć pozycji, a potem i jeszcze 3.

Status webhooka

Właściciele i administratorzy widzą stan webhooka w Kondycja. Może on mieć jedną z czterech postaci:

  • Ostatnie wywołanie odebrano, z godziną: wywołania docierają. Nie trzeba nic robić.
  • Skonfigurowano, ale nie dotarło jeszcze żadne wywołanie. Źródło jest gotowe, ale dostawca jeszcze nie wywołał. Sprawdź, czy webhook został dodany u dostawcy. Wywołania przychodzą tylko wtedy, gdy coś się zmienia, więc spokojne źródło może przez jakiś czas pozostać w tym stanie.
  • Nie skonfigurowano, więc nowe dane czekają na następną zaplanowaną synchronizację. Nie zapisano sekretu. Nowe dane docierają z synchronizacją cogodzinną lub codzienną, dopóki nie dodasz webhooka.
  • Wywołania są odrzucane, z godziną ostatniego: dostawca dociera do RevGlance, ale jego wywołania nie przechodzą weryfikacji, więc nie uruchamiają synchronizacji.

We wszystkich stanach oprócz pierwszego karta prowadzi do instrukcji krok po kroku dla twojego dostawcy.

Gdy wywołania są odrzucane

Ostrzeżenie pojawia się po 3 odrzuconych wywołaniach z rzędu, więc jedno przypadkowe wywołanie go nie włącza. Webhook odrzucony widać wtedy też w wierszu źródła w Ustawienia › Źródła. To, co sprawdzić, zależy od sposobu, w jaki dostawca weryfikuje swoje wywołania:

  • Stripe, Polar, Lemon Squeezy, Paddle, Recurly: skopiuj ponownie sekret podpisywania od dostawcy i wklej go w Sekret podpisywania w panelu Webhook źródła.
  • Gumroad, App Store, Google Play, Chargebee: sprawdź, czy ?token= w adresie URL u dostawcy zgadza się z sekretem zapisanym w Sekret podpisywania, albo zapisz nowy i zaktualizuj adres URL.
  • Braintree, Shopify: nie ma sekretu do wklejenia. Sprawdź, czy webhook dodano na tym samym koncie Braintree lub w tej samej aplikacji Shopify, z którą łączy się źródło.

Wywołania do źródła bez zapisanego sekretu również są odrzucane. Zapisanie sekretu to naprawia.

Ostrzeżenie znika przy następnym poprawnym wywołaniu lub po zapisaniu nowego sekretu. Jeśli sekret nadal jest błędny, wraca po kolejnych 3 odrzuconych wywołaniach. Znika też po 7 dniach od ostatniego odrzuconego wywołania.

Jak długo jest przechowywana

Każda synchronizacja pozostaje w dzienniku przez 90 dni, a potem jest usuwana. Usunięcie źródła usuwa też jego historię synchronizacji.

Kto co widzi

Każdy w firmie może otworzyć historię synchronizacji źródła i czytać Kondycja oraz Dziennik synchronizacji. Przeglądający nie widzą stanu webhooka: ani pola Webhook, ani plakietki, ani pozycji w menu. Uruchamianie synchronizacji i zapisywanie sekretu należą do właścicieli i administratorów. Zobacz Zespół i role.