docs(clay-ads): explain 95%+ match rate display for Meta, Reddit Ads, Bing Ads

[george-dilthey]

What changed

Updated docs/clay-ads.md: replaced the closing sentence of the FAQ "Why is my matched count higher than the number of contacts I sent?" with two sentences that also explain that when this behavior drives the match rate to 95% or higher, Clay displays the rate as 95%+ rather than an exact percentage on the professional network, Meta, Reddit Ads, Bing Ads, and Vibe, and that a tooltip on the 95%+ display confirms the behavior.

Why

Commit e6017f3 (deploy e0b7a81...e6017f3 — https://github.com/clay-run/clay-base/actions/runs/33689435705) extended the 95%+ match-rate display cap from the professional network and Vibe to also cover Meta, Reddit, and Bing Ads. Customers using Meta (the most common platform) will now see "95%+" in the Sync History and provider card when their match rate is very high — triggered by Enhanced Matching sending up to 3 hashed emails per contact, which can push the platform's matched count above the contacts-sent count, driving the raw rate above 100%.

The existing FAQ explained why matched count can exceed contacts sent, but never mentioned that the match rate itself also displays as "95%+" in that situation. Fin and customers searching "why does my match rate show 95%+" had no targeted answer in the docs.

Source link(s)

• Deploy diff: https://github.com/clay-run/clay-base/compare/e0b7a811ca4420b21ed66104a57098356ba78e44...e6017f3dbd9c0a4558a9f965ebc3718089fd6bb5
• Slack thread (Rachel Chen requesting the fix): https://clay-hq.slack.com/archives/C0B9EEU69EK/p1788369583577359
• Verifier verdict: PASS — isMatchRateCapped at run-history.utils.ts:116–129 confirms the professional network, Vibe, Meta, Reddit, Bing; display constant '95%+' at line 110; tooltip text at lines 112–113. Feature is GA for Growth and Enterprise plans (confirmed via #proj-ads Aug 4 GA post).

Uncertainties

None. The changed line is directly verified against the deployed code.

Related observations

• docs/audiences.md:589 has a table row: "Professional network ≤ 95%, Meta ≤ 65%" under expected Enhanced Matching match rates. That row describes typical expected rates, not the display cap, so it is not contradicted by this change — but it may benefit from a future review pass to clarify the distinction.
• PR docs(clay-ads): add intent-based Director+ ad targeting workflow #2406 is open on this file but adds a Director-level targeting workflow — materially different from this 95%+ rate display note.
• PR docs(clay-ads): add FAQ for sending a Find People workbook list to an ad platform #2363 is open on this file but adds a "how do I send a people list to ads" FAQ — materially different from this change.

Confidence: high

Closes DOC-2291

[linear-code]

DOC-2291