RevGlanceDoku

Synchronisierungsverlauf

Prüfen Sie, ob eine Quelle mithält, was jede Synchronisierung geändert hat und ob ihr Webhook funktioniert.

Jede Quelle, die synchronisiert, hat einen eigenen Verlauf: wie es ihr gerade geht und ein Protokoll jeder Synchronisierung der letzten 90 Tage. Schauen Sie hier nach, wenn eine Zahl veraltet wirkt oder ein Webhook nicht zu funktionieren scheint.

Wo Sie ihn finden

  • Öffnen Sie in Einstellungen › Quellen das Menü "…" einer Quelle und wählen Sie Synchronisierungsverlauf.
  • Wählen Sie im Synchronisierungsstatus unten auf der Seite Synchronisierungsverlauf unter der Quelle.

Nur Quellen, die synchronisieren, haben einen, Beispieldaten also nicht.

Zustand

Diese Karte zeigt, wie es der Quelle gerade geht.

  • Status ist Aktuell, Synchronisierung läuft, Im Rückstand oder Fehlgeschlagen. Im Rückstand heißt, die letzte Synchronisierung ist über zwei Stunden her oder eine fehlgeschlagene wartet auf den nächsten Versuch. Fehlgeschlagen heißt, die Quelle hat einen Fehler, der unter diesen Feldern steht. Eine Synchronisierung mit Teilweise gelesen zählt auch dazu. Der Fehler bleibt, bis eine spätere Synchronisierung alles liest.
  • Letzte Synchronisierung ist der Zeitpunkt, zu dem RevGlance die Quelle zuletzt fertig gelesen hat. Eine durch einen Fehler gestoppte Synchronisierung ändert ihn nicht.
  • Neueste Daten ist das Datum der letzten Zahlung oder Abo-Änderung, die RevGlance von dieser Quelle hat.
  • Webhook sagt, ob die Aufrufe des Anbieters ankommen. Siehe Webhook-Status.

Wenn die Testphase beendet ist, steht das auf der Karte, und neue Synchronisierungen warten, bis Sie RevGlance kaufen.

Warum Neueste Daten älter sein kann als Letzte Synchronisierung

Letzte Synchronisierung sagt, wann RevGlance die Quelle gelesen hat. Neueste Daten sagt, wie aktuell die gefundenen Daten sind. Eine Synchronisierung kann einwandfrei laufen und trotzdem nichts Neueres finden:

  • App Store: Apples Berichte kommen etwa einen Tag verspätet an.
  • Google Play: Google veröffentlicht seine Berichte innerhalb von 3 bis 7 Tagen.
  • Jeder Anbieter: Es ist nichts passiert. Eine ruhige Phase ohne Zahlungen oder Abo-Änderungen lässt das Datum, wo es ist.

Was eine Synchronisierung startet

Jede Zeile im Synchronisierungsprotokoll sagt, was sie gestartet hat:

BezeichnungWas passiert ist
WebhookDer Anbieter hat RevGlance aufgerufen, weil sich etwas geändert hat.
GeplantDie reguläre Synchronisierung: stündlich, solange jemand das Unternehmen nutzt, sonst täglich.
Manuell gestartetJemand hat bei der Quelle Synchronisieren oder Jetzt synchronisieren gewählt oder den Privatmodus ausgeschaltet.
Erste SynchronisierungDie Quelle wurde gerade verbunden.
Zurück in der AppJemand ist nach 30 Tagen zurückgekommen, und die letzte Synchronisierung der Quelle war über eine Stunde her.
Vollständiges NeueinlesenRevGlance hat den gesamten Verlauf der Quelle neu gelesen, was wir tun, wenn sich eine Zählregel ändert. Sie können das nicht selbst starten.

Von einer Quelle wartet immer nur eine Synchronisierung in der Warteschlange. Ein Webhook-Aufruf, der währenddessen ankommt, schließt sich ihr an. Sie sehen also eventuell weniger Webhook-Zeilen als Aufrufe.

So lesen Sie das Protokoll

Die neueste Synchronisierung steht oben. Jede Zeile zeigt, wann sie begonnen hat, was sie gestartet hat und bei einer einzelnen Synchronisierung, wie lange sie gedauert hat.

Zähler

Jede Art von Datensatz, die eine Synchronisierung geändert hat, bekommt eigene Zähler: Zahlungen, Abo-Änderungen, Kunden, Testphasen und Kündigungen. Ein Zähler mit null wird weggelassen.

  • 3 neu: Datensätze, die diese Synchronisierung hinzugefügt hat.
  • 2 aktualisiert: Datensätze, die RevGlance schon hatte und die diese Synchronisierung geändert hat.
  • 4 entfernt: Datensätze, die nach dieser Synchronisierung weg sind.

Keine Änderungen heißt, die Synchronisierung hatte nichts zu tun. Aufeinanderfolgende Synchronisierungen ohne Änderungen, die gleich gestartet wurden, werden zu einer Zeile zusammengefasst. Sie sagt, wie viele es sind und wie weit sie zurückreichen. So verdeckt eine stündliche Synchronisierung nicht die wichtigen.

Wenn eine Synchronisierung Probleme hat

  • Läuft: Die Synchronisierung läuft noch. Die Seite aktualisiert sich von selbst.
  • Teilweise gelesen: Sie ist fertig geworden, aber ein Teil des Anbieters konnte nicht gelesen werden. Die Zeile zeigt den Fehler. Was gelesen wurde, ist gespeichert und gezählt, und die nächste Synchronisierung liest denselben Abschnitt noch einmal.
  • Fehlgeschlagen: Ein Fehler hat sie gestoppt. Die Zeile zeigt den Fehler, und was vorher gelesen wurde, ist gespeichert und gezählt. Vor dem Abschluss abgebrochen. heißt, die Synchronisierung wurde abgebrochen, ohne dass es einen Fehler anzuzeigen gibt.

RevGlance versucht eine fehlgeschlagene Synchronisierung von selbst erneut, und jeder Versuch bekommt eine eigene Zeile. Eine Zeile Fehlgeschlagen mit einer fehlerfreien Zeile darüber heißt, dass das Problem verschwunden ist. Sie müssen nichts tun. Steht bei Status weiterhin Fehlgeschlagen, sagt der Fehler, was schiefgelaufen ist.

Korrigierte Zahlen

Hier stehen erfasste Zahlen, die die Synchronisierung korrigiert hat, mit altem und neuem Wert. Eine Korrektur ist nichts, was ein Kunde getan hat.

  • Nach Vollständiges Neueinlesen: jede Summe, die sich bewegt hat, etwa MRR, Rückerstattungen oder Gebühren.
  • Der MRR eines Abos: Der erfasste Betrag eines Abos wurde korrigiert.
  • Ein Kündigungsdatum: Das Datum des Anbieters für eine Kündigung weicht vom erfassten ab.

Eine Zeile listet höchstens fünf auf, danach und 3 weitere.

Webhook-Status

Inhaber und Administratoren sehen den Zustand des Webhooks unter Zustand. Er zeigt eine von vier Meldungen:

  • Letzter Aufruf empfangen, mit der Zeit: Aufrufe kommen an. Sie müssen nichts tun.
  • Eingerichtet, aber es ist noch kein Aufruf eingegangen. Die Quelle ist bereit, aber der Anbieter hat noch nicht aufgerufen. Prüfen Sie, ob der Webhook beim Anbieter eingetragen ist. Aufrufe kommen nur, wenn sich etwas ändert, eine ruhige Quelle kann also eine Weile so bleiben.
  • Nicht eingerichtet, daher warten neue Daten auf die nächste geplante Synchronisierung. Es ist kein Secret gespeichert. Neue Daten kommen mit der stündlichen oder täglichen Synchronisierung, bis Sie den Webhook hinzufügen.
  • Aufrufe werden abgelehnt, mit der Zeit des letzten: Der Anbieter erreicht RevGlance, aber seine Aufrufe bestehen die Prüfung nicht und starten daher keine Synchronisierung.

In allen Zuständen außer dem ersten verweist die Karte auf die Schritt-für-Schritt-Anleitung für Ihren Anbieter.

Wenn Aufrufe abgelehnt werden

Die Warnung erscheint nach 3 abgelehnten Aufrufen in Folge, ein einzelner verirrter Aufruf löst sie also nicht aus. Webhook abgelehnt steht dann auch in der Zeile der Quelle unter Einstellungen › Quellen. Was Sie prüfen müssen, hängt davon ab, wie der Anbieter seine Aufrufe absichert:

  • Stripe, Polar, Lemon Squeezy, Paddle, Recurly: Kopieren Sie das Signing Secret erneut beim Anbieter und fügen Sie es im Bereich Webhook der Quelle unter Signing Secret ein.
  • Gumroad, App Store, Google Play, Chargebee: Prüfen Sie, ob das ?token= in der URL beim Anbieter zum unter Signing Secret gespeicherten Secret passt, oder speichern Sie ein neues und aktualisieren Sie die URL.
  • Braintree, Shopify: Es gibt kein Secret einzufügen. Prüfen Sie, ob der Webhook im selben Braintree-Konto oder in derselben Shopify-App eingetragen ist, mit der die Quelle verbunden ist.

Aufrufe an eine Quelle ohne gespeichertes Secret werden ebenfalls abgelehnt. Das Secret zu speichern behebt das.

Die Warnung verschwindet beim nächsten gültigen Aufruf oder wenn Sie ein neues Secret speichern. Ist das Secret weiterhin falsch, kommt sie nach 3 weiteren abgelehnten Aufrufen zurück. Sie verschwindet auch 7 Tage nach dem letzten abgelehnten Aufruf.

Wie lange er aufbewahrt wird

Jede Synchronisierung bleibt 90 Tage im Protokoll und wird dann gelöscht. Wenn Sie eine Quelle entfernen, wird auch ihr Synchronisierungsverlauf entfernt.

Wer was sieht

Alle im Unternehmen können den Synchronisierungsverlauf einer Quelle öffnen und Zustand und Synchronisierungsprotokoll lesen. Betrachter sehen den Zustand des Webhooks nicht: weder das Feld Webhook noch das Badge oder den Menüpunkt. Eine Synchronisierung starten und ein Secret speichern können nur Inhaber und Administratoren. Siehe Team und Rollen.