RevGlanceDocumentatie

Synchronisatiegeschiedenis

Controleer of een bron bijblijft, wat elke synchronisatie heeft veranderd en of de webhook werkt.

Elke bron die synchroniseert heeft een eigen geschiedenis: hoe het er nu voor staat en een logboek van elke synchronisatie van de afgelopen 90 dagen. Kijk hier als een cijfer verouderd lijkt of een webhook niet lijkt te werken.

Waar je het vindt

  • Open in Instellingen › Bronnen het menu "…" van een bron en kies Synchronisatiegeschiedenis.
  • Kies in de synchronisatiestatus onderaan de pagina Synchronisatiegeschiedenis onder de bron.

Alleen bronnen die synchroniseren hebben er een, voorbeeldgegevens dus niet.

Gezondheid

Deze kaart laat zien hoe het er nu voor de bron voorstaat.

  • Status is Bijgewerkt, Synchroniseren, Achter op schema of Mislukt. Achter op schema betekent dat de laatste synchronisatie meer dan twee uur oud is, of dat een mislukte synchronisatie op de volgende poging wacht. Mislukt betekent dat de bron een fout heeft, die onder deze velden staat. Een synchronisatie met Deels gelezen telt ook. De fout blijft staan tot een latere synchronisatie alles leest.
  • Laatste synchronisatie is het moment waarop RevGlance de bron voor het laatst helemaal heeft gelezen. Een synchronisatie die door een fout stopt, verandert dit niet.
  • Nieuwste gegevens is de datum van de laatste betaling of abonnementswijziging die RevGlance van deze bron heeft.
  • Webhook laat zien of de aanroepen van de provider binnenkomen. Zie Webhookstatus.

Als de proefperiode is afgelopen, staat dat op de kaart en wachten nieuwe synchronisaties tot je RevGlance koopt.

Waarom Nieuwste gegevens ouder kan zijn dan Laatste synchronisatie

Laatste synchronisatie zegt wanneer RevGlance de bron heeft gelezen. Nieuwste gegevens zegt hoe recent de gevonden gegevens zijn. Een synchronisatie kan prima gaan en toch niets nieuwers vinden:

  • App Store: de rapporten van Apple komen ongeveer een dag te laat binnen.
  • Google Play: Google plaatst zijn rapporten binnen 3 tot 7 dagen.
  • Elke provider: er is niets gebeurd. Een rustige periode zonder betalingen of abonnementswijzigingen laat de datum staan.

Wat een synchronisatie start

Elke regel in het Synchronisatielogboek zegt wat de synchronisatie heeft gestart:

LabelWat er gebeurde
WebhookDe provider heeft RevGlance aangeroepen omdat er iets is veranderd.
GeplandDe gewone synchronisatie: elk uur zolang iemand het bedrijf gebruikt, anders dagelijks.
Handmatig gestartIemand koos Synchroniseren bij de bron of Nu synchroniseren, of zette de privémodus uit.
Eerste synchronisatieDe bron is net gekoppeld.
Terug in de appIemand kwam terug na 30 dagen afwezigheid, en de laatste synchronisatie van de bron was meer dan een uur oud.
Volledig opnieuw gelezenRevGlance heeft de hele geschiedenis van de bron opnieuw gelezen, wat we doen als een telregel verandert. Je kunt dit niet zelf starten.

Er wacht maar één synchronisatie per bron tegelijk in de wachtrij. Een webhookaanroep die dan binnenkomt, sluit daarbij aan, dus je kunt minder Webhook-regels zien dan aanroepen.

Zo lees je het logboek

De nieuwste synchronisatie staat bovenaan. Elke regel laat zien wanneer die begon, wat die startte en, bij een enkele synchronisatie, hoe lang die duurde.

Aantallen

Elk soort record dat een synchronisatie heeft veranderd, krijgt eigen aantallen: Betalingen, Abonnementswijzigingen, Klanten, Proefperiodes en Opzeggingen. Een aantal van nul wordt weggelaten.

  • 3 nieuw: records die deze synchronisatie heeft toegevoegd.
  • 2 bijgewerkt: records die RevGlance al had en die deze synchronisatie heeft veranderd.
  • 4 verwijderd: records die na deze synchronisatie weg zijn.

Geen wijzigingen betekent dat de synchronisatie niets te doen had. Opeenvolgende synchronisaties zonder wijzigingen die op dezelfde manier zijn gestart, worden samengevoegd tot één regel. Die zegt hoeveel het er zijn en hoe ver ze teruggaan. Zo verdwijnen de belangrijke synchronisaties niet tussen de uurlijkse.

Als een synchronisatie problemen heeft

  • Bezig: de synchronisatie loopt nog. De pagina werkt zichzelf bij.
  • Deels gelezen: hij is klaar, maar een deel van de provider kon niet worden gelezen. De regel toont de fout. Wat wel is gelezen, is opgeslagen en geteld, en de volgende synchronisatie leest hetzelfde stuk opnieuw.
  • Mislukt: een fout heeft hem gestopt. De regel toont de fout, en wat eerder is gelezen, is opgeslagen en geteld. Gestopt voordat het klaar was. betekent dat de synchronisatie is afgebroken zonder fout om te tonen.

RevGlance probeert een mislukte synchronisatie vanzelf opnieuw, en elke poging krijgt een eigen regel. Een regel Mislukt met daarboven een regel zonder fout betekent dat het probleem weg is, dus je hoeft niets te doen. Staat bij Status nog steeds Mislukt, dan zegt de fout wat er misging.

Gecorrigeerde cijfers

Hier staan vastgelegde cijfers die de synchronisatie heeft gecorrigeerd, met de oude en de nieuwe waarde. Een correctie is niet iets wat een klant heeft gedaan.

  • Na Volledig opnieuw gelezen: elk totaal dat is verschoven, zoals MRR, terugbetalingen of kosten.
  • De MRR van een abonnement: het vastgelegde bedrag van één abonnement is gecorrigeerd.
  • Een opzegdatum: de datum van een opzegging bij de provider wijkt af van de vastgelegde.

Een regel toont er maximaal vijf, daarna en nog 3.

Webhookstatus

Eigenaren en beheerders zien de staat van de webhook bij Gezondheid. Er kan een van deze vier dingen staan:

  • Laatste aanroep ontvangen, met de tijd: aanroepen komen binnen. Je hoeft niets te doen.
  • Ingesteld, maar er is nog geen aanroep binnengekomen. De bron is klaar, maar de provider heeft nog niet aangeroepen. Controleer of de webhook bij de provider is toegevoegd. Aanroepen komen alleen als er iets verandert, dus een rustige bron kan hier een tijdje blijven staan.
  • Niet ingesteld, dus nieuwe gegevens wachten op de volgende geplande synchronisatie. Er is geen geheim opgeslagen. Nieuwe gegevens komen met de uurlijkse of dagelijkse synchronisatie tot je de webhook toevoegt.
  • Aanroepen worden geweigerd, met de tijd van de laatste: de provider bereikt RevGlance, maar zijn aanroepen komen niet door de controle en starten dus geen synchronisatie.

In elke staat behalve de eerste linkt de kaart naar de stap-voor-stapgids voor je provider.

Als aanroepen worden geweigerd

De waarschuwing verschijnt na 3 geweigerde aanroepen op rij, dus één losse aanroep zet hem niet aan. Webhook geweigerd staat dan ook in de regel van de bron in Instellingen › Bronnen. Wat je moet controleren hangt af van hoe de provider zijn aanroepen controleert:

  • Stripe, Polar, Lemon Squeezy, Paddle, Recurly: kopieer het ondertekeningsgeheim opnieuw bij de provider en plak het onder Ondertekeningsgeheim in het paneel Webhook van de bron.
  • Gumroad, App Store, Google Play, Chargebee: controleer of de ?token= in de URL bij de provider overeenkomt met het geheim onder Ondertekeningsgeheim, of sla een nieuw geheim op en werk de URL bij.
  • Braintree, Shopify: er is geen geheim om te plakken. Controleer of de webhook is toegevoegd in hetzelfde Braintree-account of dezelfde Shopify-app waarmee de bron is gekoppeld.

Aanroepen naar een bron zonder opgeslagen geheim worden ook geweigerd. Het geheim opslaan lost dat op.

De waarschuwing verdwijnt bij de volgende goede aanroep of als je een nieuw geheim opslaat. Is het geheim nog steeds verkeerd, dan komt hij terug na nog 3 geweigerde aanroepen. Hij verdwijnt ook 7 dagen na de laatste geweigerde aanroep.

Hoe lang het wordt bewaard

Elke synchronisatie blijft 90 dagen in het logboek en wordt daarna verwijderd. Als je een bron verwijdert, verdwijnt ook de synchronisatiegeschiedenis.

Wie wat ziet

Iedereen in het bedrijf kan de synchronisatiegeschiedenis van een bron openen en Gezondheid en het Synchronisatielogboek lezen. Kijkers zien de staat van de webhook niet: geen veld Webhook, badge of menu-item. Een synchronisatie starten en een geheim opslaan is voor eigenaren en beheerders. Zie Team en rollen.