How Bottega matches Zoom attendance to registrants
The three ways attendance reaches Bottega, and exactly how each one decides which registrant showed up.
On this page6 sections
Zoom knows who was in the room. Bottega knows who registered. Attendance is the step that pairs the two, and how well it works depends on how the data reaches Bottega.
| Route | When it happens | How people are matched | Label on the cohort page |
|---|---|---|---|
| Automatic sync | With Zoom connected and a meeting ID on the date. Bottega starts checking 30 minutes into the live and fetches the report as soon as Zoom publishes it, usually within minutes of the host ending the meeting, even when the live finishes before its planned end. It fetches it again 6 hours and 24 hours after the planned end, and stops after 3 days. Each date shows on its own as soon as its report is in, so Night 1 appears before Night 2 has run. | Personal join link first, then email. | Zoom API · synced |
| CSV import | When an admin uploads the participant report exported from Zoom. | Email only. | CSV import |
| Live count | During the live, from Zoom's join and leave notifications. | Not matched. It counts everyone in the room. | In the room now |
Bottega goes through every row in Zoom's report and tries these in order.
By personal join link
With personal join links, each registrant gets their own Zoom link, and Zoom reports which link each person used. Bottega pairs that with the registrant directly, whatever name or email they typed into Zoom. This only works with automatic sync, and only for people who received a personal link for that date.
By registered email
Otherwise Bottega compares the email Zoom recorded with the emails registered for this run. Capital letters don't matter, but the address has to be the same. sarah@brightline.com and sarah.k@gmail.com don't match, and someone who joins from a phone without signing in to Zoom has no email to match.
Unmatched
Anyone left over is kept as an unmatched participant. They count towards peak viewers and the retention chart, and they are listed under Unmatched Zoom participants on the cohort page. They don't count towards show-up, because Bottega can't tell which registrant they are. You can't assign them to a registrant by hand.
Minutes are added up across rejoins, so someone who left for ten minutes and came back is credited with the time they were actually in. With automatic sync, overlapping rows for the same person (two devices at once) are merged so the time isn't counted twice. A CSV import adds the rows up as they are.
Sarah from Brightline registered as sarah@brightline.com. On the night she joins from her phone, where Zoom is signed in as sarah.k@gmail.com.
- With personal join links and automatic sync, she clicked her own link, so she is matched and counted as attended.
- With automatic sync but no personal links, Zoom only has sarah.k@gmail.com. She is unmatched, and her row shows Didn't join.
- With a CSV import, the result is the same as without personal links, even if personal links were on, because Zoom's CSV doesn't say which link someone used.
In the last two cases, the cohort page lists her under Unmatched Zoom participants as Likely Sarah Tan (sarah@brightline.com), joined with a different email, because the name in Zoom matches exactly one registrant.
Each date holds one set of attendance. Whatever arrives last replaces what was there.
- Importing a CSV replaces whatever the date had, including a Zoom API sync.
- Automatic sync never overwrites a CSV import. To swap a CSV for Zoom's data, click the date's label on the cohort page and choose Sync now.
- Removing a report deletes that date's attendance, and show-up goes back to a dash.
Once a date has ended, a Data source row appears under the page title with one label per date. Click a label to see By personal link, By email and Unmatched counts, when the data arrived, and a Sync now button if you are an admin and Zoom is connected.
The label reads Waiting for Zoom report between the end of the live and the first successful sync. Zoom usually publishes the report within 30 minutes to a few hours.
| What you see | Why | What to do |
|---|---|---|
| Few people matched, although personal links were on | The attendance came from a CSV, which can only match by email. | Click the date's label and choose Sync now. |
| Waiting for Zoom report for hours | Zoom hasn't published the participant report yet. | Wait for the 6-hour check, or click Sync now. After 3 days Bottega stops trying, so import the CSV instead. |
| Zoom sync failed with Add the Zoom meeting ID to this night first. | The date has no Zoom meeting ID. | Add it on the run's Setup tab, then Sync now. |
Zoom sync failed mentioning report:read:admin | The Zoom app can't read reports. | Fix the Zoom app's scopes |
| You (the host) are listed as unmatched | Zoom's meeting report includes the host. | Nothing. It doesn't affect show-up. |
| A registrant says they came but shows Didn't join | They joined with another email, or without signing in to Zoom. | Look for them under Unmatched Zoom participants. Turn on personal join links for the next run. |
Read next
Something here out of date? Tell us and we'll fix the guide.