Building a Netlify Analytics Email Digest

tldr; using Netlify Analytics and Functions combined with iOS shortcuts, I built a script that sends me a daily email detailing the last 24 hours of traffic on my blog.

The email is comprised of “Top Sources” and “Top Pages” (as defined by Netlify Analytics) which lets me keep a pulse on A) what sites are linking to my blog, and B) what posts are seeing lots of current traffic.

The Problem

First, some background on why I built this thing.

Here’s a common scenario for me: I feel the whim to log in to Netlify. I glance at my analytics and see a huge spike in pageviews, often from days or weeks ago (but not more than 30 days ago, as Netlify doesn’t track analytics beyond that).

“Hot damn! What happened there?” I wonder. I scroll down to see where the traffic is coming. “Oh hey, looks like something I wrote ended up on ye olde orange website and some subreddits.”

Now I know where the traffic is coming from. But what blog post is the culprit? A glance at Netlify’s “Top Pages” reveals a blog post whose pageviews far surpass any others.

And with that, my detective work is done.

I’m using an extreme example here. Most of the time what I see is a minor bump in traffic—double digit referrals from some domain on the web—and I wonder, “oh hey, what’s this website that linked to my blog?” I go check it out and see somebody found my writing useful: a few nice words and a link. To be honest, reading people linking to something from their personal site is a much better way of getting reader feedback than “the comments section” of the web. It’s also a good way to discover personal blogs of people I don’t know and add them to my RSS feed.

Anyhow, the problem is: I’m not interested in logging in to Netlify’s dashboard every day to do this assessment.

So how to make this information more readily accessible?

The Solution

As I knew from a prior experiment, Netlify has an (unofficial) API for accessing analytics data. “What if I wrote a script that runs every 24 hours, gathers the latest analytics data, and sends me a daily report?” That sounds like fun!

Some JavaScript and a Netlify Function later, I have a URL returning HTML of the last 24 hours of analytics activity from Netlify.

Now I need to get that HTML into an automated email every 24 hours. That’s a two part problem: I need a server that 1) schedules doing something, and 2) sends emails. Then I thought: I already have a “server” with 24-hour access to the internet that can send emails—my iPhone. Could iOS shortcuts be the automation solution here?

Turns out, it can be! Using shortcuts, you can take the contents of a URL (the output of my Netlify Function) and send it to an email address (an email to myself).

I’ve had this going for a couple months now and it’s been pretty neat to receive this little daily digest. It keeps me abreast of inbound traffic in a daily, lightweight, and ephemeral way.

Technical Details

After inspecting the network calls for my blog in Netlify Analytics, I was able to reformulate my own set of API calls in order to render my daily email. View the API calls and corresponding code for the Netlify Function in this gist.

You might have noticed the little search icon 🔍? That’s a quick <a> link to do a Google site search using query parameters for the source domain—a shorthand to searching the site myself and finding the link to my blog.

Oh, and lastly: Netlify now offers the ability (in beta) to run scheduled functions. While that solves the problem of running my function every 24 hours, it wouldn’t solve my problem of sending emails. I’d have to use a service like SendGrid for that. So for now, I’ll continue with my iOS shortcut.