Wie die Ansichtsverfolgung von Rechnungen Wirklich Funktioniert
In diesem Artikel
Die Anzeige "angesehen" neben einer Rechnung wirkt wie eine einzelne Tatsache, ist aber tatsächlich aus zwei verschiedenen Verfolgungsmechanismen zusammengesetzt, die gemeinsam entwickelt wurden und unterschiedliche Dinge erfassen. Der eine ist ein leichtgewichtiger Zähler, der am Freigabelink selbst hängt. Der andere ist ein detailliertes, nur anfügbares Ereignisprotokoll, das jede Öffnung über jeden Kanal erfasst, über den ein Kunde ein Dokument sehen kann. Zu verstehen, wie sich die beiden zueinander verhalten — und der eine Fall, in dem das Öffnen eines Links überhaupt nicht als Ansicht zählt — erklärt das meiste Verhalten, das Menschen an der Ansichtsverfolgung verwirrend finden.
Zwei Getrennte Verfolgungspfade: Freigabelinks und das Kundenportal
Ein Kunde kann eine Rechnung oder ein Angebot über zwei verschiedene Kanäle sehen, und jeder wird mit einem eigenen Codepfad verfolgt. Der erste ist ein Freigabelink — eine tokenbasierte URL, die Sie erzeugen und direkt versenden und die jeder mit dem Link öffnen kann, ohne sich anzumelden. Der zweite ist das Kundenportal, in dem ein Kunde mit einem dauerhaften Portallink eine Liste seiner Dokumente durchsucht und von dort eines öffnet. Beide Pfade rufen letztlich dieselbe zugrunde liegende Erfassungsfunktion auf, markieren das Ereignis jedoch mit einem unterschiedlichen source_type — "share" oder "portal" — und der Portalpfad hängt, weil er über die Portalsitzung bereits weiß, wer der Kunde ist, einen Namen und eine E-Mail-Adresse des Betrachters an das Ereignis an. Ein Freigabelink dagegen wird von wem auch immer geöffnet, der den Link besitzt, sodass es keine verlässliche Identität zum Anhängen gibt; diese Ereignisse erfassen nur die technischen Details des Besuchs.
Warum ein Passwortgeschützter Freigabelink Noch Nicht als Angesehen Zählt
Wenn Sie einem Freigabelink ein Passwort gegeben haben, liefert das erste Öffnen des Links gerade genug Informationen zurück, um die Passwortabfrage darzustellen — der Ansichtszähler wird nicht erhöht, und es wird kein Ansichtsereignis geschrieben. Die Ansicht wird erst erfasst, sobald das richtige Passwort eingegeben und gegen den gespeicherten Hash geprüft wurde. Das ist eine bewusste Reihenfolge: Einen Seitenaufruf als "Ansicht" zu zählen, bevor jemand tatsächlich nachgewiesen hat, dass er die Rechnung sehen darf, würde jemanden, der den Link versehentlich findet (eine weitergeleitete E-Mail, ein Browserverlaufseintrag), als jemanden registrieren lassen, der Ihre Rechnung angesehen hat, ohne je ihren Inhalt gesehen zu haben. Ein ungeschützter Freigabelink, der nichts zu prüfen hat, erfasst die Ansicht dagegen sofort beim ersten Laden.
Was Bei Jeder Ansicht Erfasst Wird
Jede erfasste Ansicht hält die Gruppen-ID der Rechnung oder des Angebots fest, über welchen Kanal sie einging, die anfragende IP-Adresse und die User-Agent-Zeichenfolge des Browsers, mit einem Zeitstempel des genauen Moments. Portalansichten tragen zusätzlich den Namen und die E-Mail-Adresse des Kunden, entnommen aus der Portalsitzung statt vom Betrachter eingegeben, sodass diese Daten nicht von der Person am anderen Ende des Links gefälscht werden können. Nichts davon wird nachträglich abgeleitet oder geschätzt — es wird synchron als Teil der Anfragebearbeitung geschrieben, die das Dokument ausliefert, unter Verwendung derselben IP-Auflösungslogik (zunächst ein Forwarded-For-Header prüfen, bevor auf die rohe Socket-Adresse zurückgegriffen wird), die der Rest der Plattform für alles IP-Sensible verwendet.
Auch der Prüfpfad Erhält Einen "Angesehen"-Eintrag
Die Erfassung einer Ansicht schreibt nicht nur in die dedizierte Ansichtsereignistabelle. Sie fügt außerdem dem Prüfpfad (Audit Trail) dieser Rechnung einen "angesehen"-Eintrag hinzu, wobei der Akteurstyp für Portalansichten auf "client" und für Ansichten über Freigabelinks auf "system" gesetzt wird — was widerspiegelt, dass ein Freigabelink im Gegensatz zum Portal keine authentifizierte Person hat, der die Öffnung zugeschrieben werden könnte. Deshalb kann die Prüfhistorie einer Rechnung eine "angesehen"-Zeile zeigen, obwohl niemand in Ihrem Team etwas getan hat: Es ist dasselbe Ereignis, an zwei Stellen gespiegelt — die eine Tabelle optimiert für "wie oft wurde dies angesehen und von wem", die andere optimiert für "hier ist die vollständige chronologische Geschichte dessen, was mit dieser Rechnung passiert ist".
Wie das Ansichten-Panel Diese Daten Zusammenführt
Das Ansichten-Panel einer einzelnen Rechnung fragt das detaillierte Ereignisprotokoll direkt ab, gefiltert nach der Gruppen-ID dieser Rechnung, und liefert jede erfasste Ansicht zurück — Anzahl, letzter Ansichtszeitpunkt und die vollständige Liste mit Kanal, Betrachterdetails, sofern verfügbar, und IP-Adresse — unabhängig davon, ob diese Ansichten über einen Freigabelink oder das Portal erfolgten. Es ist eine einzige zusammengeführte Zeitleiste statt getrennter Listen für Freigabe- und Portalansichten, denn was Sie von Ihrer Seite des Gesprächs eigentlich wissen wollen, ist einfach, ob — und wie oft — der Kunde das Dokument angesehen hat, nicht welche URL er dafür benutzt hat.
Warum der Freigabelink Auch Seinen Eigenen Zähler Führt
Getrennt vom detaillierten Ereignisprotokoll führt der Freigabelink selbst einen laufenden view_count und einen last_viewed_at-Zeitstempel, die innerhalb derselben Anfrage aktualisiert werden, die das detaillierte Ereignis schreibt. Das ist bewusste Redundanz, kein Versehen: Alle Freigabelinks eines Arbeitsbereichs mit ihren Ansichtszahlen aufzulisten, ist eine deutlich günstigere Abfrage gegen diesen laufenden Zähler, als jedes Mal, wenn die Liste geladen wird, zum Ereignisprotokoll zu verbinden und für jeden Link Zeilen zu zählen. Das Ereignisprotokoll ist da, wenn Sie die Details brauchen; der Zähler ist da, wenn Sie nur die Zahl brauchen.
Was Ansichtsverfolgung Ihnen Nicht Sagen Kann
Es lohnt sich, präzise zu sein, was dieses System tatsächlich misst: einen Seitenaufruf des Rechnungs- oder Angebotsdokuments, nicht mehr. Es hat keine Möglichkeit zu wissen, ob die Person, die es geöffnet hat, tatsächlich die Positionen gelesen hat, ob sie den Link an jemand anderen weitergeleitet hat, der ihn dann öffnete (diese zweite Öffnung erscheint als eine weitere anonyme Freigabeansicht, niemandem zugeordnet), oder ob eine Link-Scan-Sicherheitsfunktion eines E-Mail-Clients die Öffnung auslöste, bevor ein Mensch sie je sah. Behandeln Sie eine erfasste Ansicht als "das Dokument wurde zu diesem Zeitpunkt in einem Browser geladen", nicht als Beweis dafür, dass Ihr Kunde es durchgesehen und verstanden hat — nützlich als Signal, dass eine Erinnerung wahrscheinlich ihr Ziel erreicht hat, aber kein Ersatz für eine Antwort.
Ähnliche Artikel
Wie Externe Logos in Rechnungs-PDFs Geladen Werden
Ein PDF wird in Ihrem Browser erstellt, und Browser verhindern, dass die meisten Bilder von anderen Websites gezeichnet werden. Ist ein Logo ein Link zu einer anderen Website, lädt die App es daher über ihren eigenen Bild-Proxy, der prüft, ob es ein echtes Bild unter 2 MB ist.
Wie eine Rechnung Gespeichert Wird: Eine Zeile pro Position, Plus eine Vollständige Kopie
Eine gespeicherte Rechnung besteht aus einer Datenbankzeile pro Position, verbunden über eine gemeinsame Gruppen-ID, und jede Zeile enthält eine vollständige Kopie der Rechnung. Beim Speichern einer Änderung werden all diese Zeilen in einer Transaktion ersetzt.
Warum Anmeldeversuche Begrenzt Werden
Anmeldung, Registrierung, Zwei-Faktor-Prüfungen und das erneute Senden von Bestätigungs-E-Mails teilen sich ein Kontingent von 10 Versuchen pro Stunde und IP-Adresse. Das ist deutlich strenger als die Grenze für normale Anfragen in der App. Darum unterscheiden sich die Zahlen.
Wie Registrierung und E-Mail-Verifizierung Tatsächlich Funktionieren
Beim Anlegen eines Kontos wird in derselben Datenbanktransaktion ein persönlicher Arbeitsbereich eingerichtet. Der Bestätigungslink ist 24 Stunden gültig, und wer auf einen abgelaufenen Link klickt, bekommt automatisch einen neuen zugeschickt.
Wie Ihr Logo Beim Hochladen Gespeichert Wird
Ein als externe URL eingefügtes Logo wird serverseitig abgerufen, gegen eine 2-MB-Grenze und einen echten Bild-Inhaltstyp geprüft und vor dem Speichern in eine eigenständige Daten-URL umgewandelt.
Warum Sie Nach Einer Stunde Abgemeldet Werden
Jedes Sitzungstoken läuft exakt nach einer Stunde ab, und es gibt keinen versteckten Aktualisierungsmechanismus, der es still und heimlich verlängert — plus die eine bewusste Ausnahme für Anmeldungen mit Zwei-Faktor-Authentifizierung.