> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hocdoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics

> What HocDoc shows about how your offers are read and closed: overview, offer detail with timeline and the Analytics page.

HocDoc records what recipients do with a sent offer: open, read, calculate, request the code, accept. You see this in three places: in the **Overview**, in the **offer detail** and on the **Analytics** page. All three are readable for every role, including viewers (see [Team and roles](https://docs.hocdoc.com/en/guides/team-and-roles.md)).

All days, weeks and months follow your workspace's time zone (see [Settings](https://docs.hocdoc.com/en/guides/settings.md)).

## Overview

The overview is the app's start page (menu item **Overview**). At the top is "Welcome back" with your name, on the right the **Period** and, with write access and as soon as there are offers, **New offer**. If someone is reading an offer right now, next to it is "1 reading now" or "3 reading now" with a green dot. This means an event in the last 10 minutes.

### Period

The period applies to the whole page and to the Analytics page. You choose:

| Entry | Period |
| - | - |
| **Last 7 days**, **Last 30 days**, **Last 90 days** | The last 7, 30 or 90 days up to today. The default is 30 days. |
| **This month** | The current calendar month up to today. |
| **This year** | The current calendar year up to today. |
| **Last 12 months** | Twelve months up to today. |
| **Custom period** | A from date and a to date, at most 730 days long. |

The choice is in the page's address (`zeitraum=30d`, with a custom period plus `von` and `bis`) and in a cookie. So it is kept when you switch from the overview to the analytics and back, also via the sidebar. The charts show one value per day up to 45 days in length, per week up to 120 days, per month above that. The change on the tiles compares with the period of the same length directly before.

### The five tiles

Every tile shows a number, the change vs. the previous period (with an arrow) and a small trend.

| Tile | What it counts |
| - | - |
| **Open** | Sum of the offer value of the offers that are open at the end of the period: first send lies before it, and the offer had by then been neither accepted, declined, withdrawn nor expired. Below it is the count ("3 open offers"). For offers with a choice, the preselection counts until the choice is fixed (see [Recipient's choice](https://docs.hocdoc.com/en/guides/acceptance-and-certificate.md#recipients-choice)). Several currencies are not added: the largest sum comes first, the other amounts in the same tile. |
| **Sent** | Offers whose first send falls into the period. A resend does not count again. |
| **Won** | Value of the offers that were accepted electronically in the period, below it their count ("2 offers accepted"). With several currencies as for "Open". |
| **Close rate** | Accepted divided by accepted plus declined plus expired offers in the period. Without closed offers a dash appears. The change shows percentage points ("pp"). |
| **Time to accept** | The median of the time from the first send to acceptance, for the acceptances in the period ("Median from send"). It is shown in minutes, hours or days. |

Three rules apply:

* A sent offer whose expiry date has been reached counts as expired immediately.
* Withdrawn offers and drafts do not go into the close rate.
* The offer page has no way to decline an offer. Accepted and expired offers therefore go into the rate.

### Closing funnel

The funnel shows the offers whose **first send** falls into the period, and how far they got. It has four stages:

| Stage | Meaning |
| - | - |
| **Sent** | The offer was sent for the first time in the period. |
| **Opened** | The offer or its summary was opened. |
| **Acceptance started** | The recipient requested a code in the acceptance step. |
| **Accepted** | The offer was accepted electronically. |

The stages contain one another: whoever has accepted also counts as opened and as started, even if an event is missing. The percentages refer to **Sent**. That is not the close rate, which only counts decided offers. HocDoc follows the offers up to today, not only to the end of the period. Without a send in the period it says "No offers sent yet". On the Analytics page the funnel has a footer (see below).

### Follow up now

The **Follow up now** card ("Worth a call or an email") replaces the former Deal coach card. It names open offers where a call or an email is worthwhile, and works with fixed rules on the recorded events, without AI. For each offer there is at most one line, with the strongest applicable rule. The card shows as many entries as fit, the most recently active offer first. **All** leads to the offer list. If there is nothing to do, it says "Nothing to follow up on right now."

There are four rules. They are listed in the order in which HocDoc prefers them if several apply:

| Rule | When it applies | Line | Button |
| - | - | - | - |
| Opened several times | The offer was opened at least 3 times and is not yet accepted. | "3× opened, last" and the time | **Draft email** |
| Calculator used | The recipient entered their own numbers in the ROI calculator. | "Calculator: … added value entered", otherwise "Calculator: own numbers entered" | **Draft email** |
| New person | The offer was sent to more than one email address, that is, sent again to a different address. | "Forwarded to a new person" | **View** |
| Unopened | The first send was at least 5 days ago and neither the offer nor the summary was opened. | "Unopened for 6 days" | **Remind** |

**Draft email** and **Remind** lead to the **Deal coach** card on the offer's detail page, **View** to the detail page. There you generate the recommendation and the email draft with AI on request (see [Deal coach](https://docs.hocdoc.com/en/guides/deal-coach.md)). The whole entry is a link to the offer. Hints only exist for open offers: drafts, accepted, expired and withdrawn ones get none.

> [!NOTE]
>
> The rule "New person" only evaluates your sends. Whether a recipient passed on the link themselves is visible in the timeline from "Opened (new reader)" and "Code requested from a different address".
>
> The summary for co-decision makers (see [Sending](https://docs.hocdoc.com/en/guides/sending.md)) is known to the card: if the summary was viewed, the hint about the unopened offer is dropped. The summary does not count as an opening for the rule "Opened several times".

### Opens and acceptances

The card shows the sum of the opens and the acceptances in the chosen period, below it the opens as bars per day, week or month. The acceptances appear in the tooltip for each bar. Without activity it says "No activity yet".

### Last activity

The **Last activity** card ("Summarized per offer") shows the latest events, one entry per offer, with the steps that belong together. An example is "Opened", then a section with its time spent ("Pricing 1:20 min"), then "Calculator used". Further steps are "Summary viewed", "Sent", "Sent again", "Accepted", "Signed", "Declined", "Withdrawn" and "Onboarding form submitted". Whoever is reading right now (event in the last 10 minutes) is at the top with "Reading now" and a green dot. An event that is at most 10 minutes old shows as "now". The event "Expired" does not appear in this card. The card shows at most 8 offers.

### Offers

Below that, the **Offers** card lists the latest 10 offers with value, status and last activity. You can search them by title ("Search by title") and filter by status via **Filters**. Search and filters only affect these 10 offers. **All offers** leads to the full list.

## Offer detail

All cards and actions of the page are described in the [Offer detail page](https://docs.hocdoc.com/en/guides/offer-detail.md). Open an offer via the list or the overview. Besides the recipient details, the link and the acceptance (see [Acceptance and certificate](https://docs.hocdoc.com/en/guides/acceptance-and-certificate.md)), the page has two cards for evaluation. For a sent, open offer the **Deal coach** card is added (see [Deal coach](https://docs.hocdoc.com/en/guides/deal-coach.md)). As soon as the choice is saved (with acceptance, for several signers with the first signature), the **Recipient's choice** card shows what was chosen (see [Acceptance and certificate](https://docs.hocdoc.com/en/guides/acceptance-and-certificate.md#recipients-choice)).

### Evaluation: reading depth and time spent

The **Evaluation** card has a **View** switch at the top with **Reading depth** (the default) and **Time spent**. Both show every visible section of the offer in the order of the document.

**Reading depth** ("How far recipients read, section by section."): For each section there is a bar, the number of visitors and their share in percent, measured against the visitors of the first section. On the section with the biggest drop, red text says how many visitors are missing here compared to the section before ("−3 dropped out here"). If no section loses visitors, there is no marker.

**Time spent:**

* the time spent as a bar,
* the number of views,
* the number of visitors.

Above it is the total time spent. Without data it says "No evaluation yet". On a resend, a section's reading data is kept as long as the section still exists in the offer.

This is how it is measured: A section counts as seen as long as at least 40 percent of it is visible in the recipient's window. The time is collected and sent when the recipient leaves the page or switches tabs. HocDoc counts visitors per browser, via a cookie of the offer page. For older visits the visitor count is an approximation based on IP address and browser.

### Timeline

The **Timeline** card lists all events for this offer, newest first, with date and time. If an offer has no events yet, it says "No events yet".

| Entry | Meaning |
| - | - |
| Offer created | The offer was created. |
| Sent | The offer was sent. Every resend creates another entry. |
| Opened | The offer page was visited. |
| Opened (new reader) | Like "Opened", but this browser has never seen the offer. |
| Section "…" viewed (12 s) | The recipient spent this long on this section. The duration is in seconds or as "1 min 8 s". |
| Calculator used (baseline …, improvement …, period …, added value …) | The recipient left a new state in the ROI calculator. If a value is missing, it is dropped from the line. |
| Calculator used 3 times (last: …) | Several calculator entries of the same section directly in a row, combined with the last state. |
| Summary viewed | Someone opened the summary. With the suffix "(new reader)" if this browser knew neither the offer nor the summary. |
| PDF downloaded | The recipient downloaded the offer as a PDF. At most one entry per offer in 10 minutes. |
| Confirmation code requested | The recipient requested a code in the acceptance step. |
| Code requested from a different address | The code was requested for an email address other than the recipient's. |
| Wrong code entered (attempt 2/5) | A wrong code with the number of attempts. |
| Code confirmed | The code was right. |
| Accepted | The offer was accepted electronically. |
| Withdrawn | The offer was withdrawn. |
| Reminder sent (not opened) | An automatic reminder went out. The parentheses name the rule: "not opened", "not yet accepted" or "validity is about to end". For a signer it says "Reminder sent to signer". |
| Follow-ups stopped | You stopped follow-ups for this offer. |
| Recipient turned off reminders | The recipient turned off reminders via the link in the email. |
| Onboarding form submitted | The recipient submitted the onboarding form. The answers are not in the timeline but in the **Onboarding form** card (see [Acceptance and certificate](https://docs.hocdoc.com/en/guides/acceptance-and-certificate.md)). |
| Expired (valid until …) | The expiry date was reached and appears in the parentheses. The entry itself carries the time at which HocDoc recorded the expiry. This happens up to 15 minutes after expiry. |

## Analytics page

The **Analytics** page (menu item **Analytics**) shows how offers are read and closed, over a period.

### Period

At the top right you choose the period, with the same entries as in the overview (see [Period](#period)): **Last 7 days**, **Last 30 days**, **Last 90 days**, **This month**, **This year**, **Last 12 months** or **Custom period**. The default is 30 days. The choice applies to both pages. The charts show one value per day up to 45 days, per week up to 120 days, per month above that. The change next to the figures compares with the period of the same length directly before.

### Team reporting and Member filter

On the Team plan, the Analytics page shows the **Team** section with a table "Figures per member". Columns: Member, Sent, Open rate, Close rate, Won and Time to accept (median). You sort the table, and arrows compare with the previous period. An offer belongs to the member who created it. "Unassigned" combines former members. The info icon explains what is counted.

The **Member** filter is in the overview and in analytics. You choose "All members", "Only me" or a single member. It affects tiles, funnel, charts and lists. The choice is in the page's address (`mitglied`). Owners and admins see all members. Members only see their own offers. On other plans, a note about the Team plan appears instead of the table and filter. If you are alone in the workspace, neither exists.

### Figures

Every figure has an info icon that explains what is counted. **Sent**, **Opened** and **Accepted** also show a small trend.

| Figure | What it counts |
| - | - |
| **Sent** | Offers whose first send falls into the period. A resend does not count again. |
| **Opened** | Opens of offers in the period. Repeated opens by the same person in quick succession count once. |
| **Accepted** | Offers accepted electronically in the period. |
| **Close rate** | Accepted divided by accepted plus declined plus expired offers. The change shows percentage points. |

### Charts and table

* **Opens and sends:** Opens as bars, the sends appear in the tooltip of each bar.
* **Closing funnel:** how far the offers first sent in the period get: Sent, Opened, Acceptance started, Accepted (see [Closing funnel](#closing-funnel)). Unlike in the overview, the card has a footer here: **Accepted of sent** (the share in percent), **Dropped out** (Sent minus Accepted) and **Biggest drop** with the two stages and the number of offers lost there, for example "Opened → Acceptance started (4)".
* **Close rate over time:** the rate across all offers that have been accepted, declined or expired since the start of the period, cumulative. It only begins with the first decided case.
* **Time spent per section:** the total time per section type across all offers in the period, with the average per offer and the number of views.
* **Offers:** the most frequently opened offers in the period (at most 25) with status, opens, time spent and last open. A click leads to the offer's evaluation.

### Comparison with the figure before HocDoc

The **Comparison with the figure before HocDoc** card comes after the close rate over time. It sets two values against each other:

* **Figure before HocDoc:** how many out of 10 offers were accepted earlier, from the settings (see [Settings](https://docs.hocdoc.com/en/guides/settings.md)).
* **Close rate:** the rate since the workspace was created, from the last 24 months at most. It does not depend on the chosen period and counts as in the figures.

Next to it is the **Difference**: close rate minus figure, in percentage points.

With fewer than 10 decided offers (accepted, declined, expired), the card only shows the figure and the **Progress** ("x of 10"). The difference only appears there from 10 decided offers.

If the card cannot be loaded, it shows the message "Couldn't be loaded" with "Please reload the page or try again later." instead of being missing.

Without a figure, a note appears on the card. The **Enter figure** button only appears for owners and admins. All other roles read that owners and admins enter the figure in the settings in the "Workspace" tab.

## What is measured and what is not

* An open occurs when the link is visited. Per browser at most one open counts per 30 minutes. Link previews also produce an open.
* HocDoc does not distinguish who visits the link. Your own visit to the public link also counts as an open. The preview in the app does not count.
* Per offer, HocDoc stores at most 180 reading events in 10 minutes (opens, sections, calculators, summary), of which at most 20 calculator entries. Anything above that is dropped.
* The first visit to the offer page after a send triggers an email once ("Your offer was opened for the first time"). It goes to the person who created the offer. If they are no longer in the workspace, it goes to the owners.
* The inputs in the ROI calculator are stored as an event. The inputs in a custom calculator are not stored.
* Calculator entries do not count as an open and not in the time spent.
* Playing a video is not recorded.
* PDF downloads do not appear in the timeline.
* The summary has no time spent. The analytics show it separately ("Summary" column in the offers table). The Deal coach does not count it as an open, but evaluates it: if the summary was viewed, the offer no longer counts as unopened.
* A draft has no public link yet. Reading data only arises after sending.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.