Scarf's project Documentation Insights offers insights into:
- Which businesses are looking at your project's documentation.
- Aggregated location information associated with this web traffic.
- Which parts of your documentation are looked at most.
How it works
Scarf gathers web traffic insights via a simple transparent tracking pixel. You copy an
<img> tag from Scarf into your project's README, docs, or any other web property, and any time a user loads the image from us, Scarf will look up any business metadata associated with the address and surface that information to you (and only you) via your free Scarf account. Scarf does not store the IP address itself, so no personally identifiable information is collected.
Head to your Scarf dashboard and locate the
Documentation Insights Management section. Give your pixel(s) a name, and optionally attach it to a package you manage on Scarf. Click the "copy" button to copy the
<img> tag to your clipboard, and then paste the tag into your project's README, docs, and any other web properties where you want to gather insights into who is using your documentation pages.
View counts from Documentation Insights data should be considered as approximate and not exact. Page loads are a noisy signal, and Scarf's infrastructure that serves your tracking pixel is optimized to always load quickly and never get in the way, rather than having an exact page load count.
Pixel-based telemetry will work on standard webpages, rendered markdown documentation on package registry sites like
PyPi, and anywhere an image can be embedded, with a notable exception being GitHub. When GitHub renders markdown, it rewrites URLs from their original web address to https://camo.githubusercontent.com/