Awesome
<p> <a href="https://www.tinybird.co/join-our-slack-community"><img alt="Slack Status" src="https://img.shields.io/badge/slack-chat-1FCC83?style=flat&logo=slack"></a> </p>Tinybird Web Analytics Starter Kit
Build your own web analytics platform using Tinybird's Events API and Endpoints. Built with privacy and speed as top priorities, this Starter Kit lets you get real-time metrics in a pre-built dashboard in just a few minutes without any knowledge about Tinybird. Our free accounts serve up to 1000 requests per day and unlimited processed GB, more than enough to get started.
<!-- You can look at the [Web Analytics Starter Kit](https://www.tinybird.co/starter-kits) site to get a better glimpse of the final result. -->Once you've finished the basic setup, expand your analytics with custom events tailored to your specific use cases (eCommerce, marketing, etc.), keeping the same real-time performance. If you need to be GDPR compliant, check out the GDPR best practices section.
1. Set up the data project
Click this button to deploy the data project to Tinybird š
Follow the guided process, and your Tinybird workspace is now ready to start receiving events. All your Data Sources, Materialized Views (to make the queries blazing fast), and API Endpoints should be installed and ready. If you go to the Data Flow tab in your browser you should see something like this:
<!-- maybe add some explanations on top of the flow? --> <details id='manual-install'> <summary><h4>Manual installation (alternative)</h4></summary>- Create a Tinybird account.
- Create a Workspace and go to Manage Auth tokens to copy your admin token.
- Clone this repository:
git clone https://github.com/tinybirdco/web-analytics-starter-kit
cd web-analytics-starter-kit
cd tinybird
-
Install the Tinybird CLI using
pip install tinybird-cli
. Detailed instructions here. -
Authenticate on the CLI using
tb auth
and paste the token you just copied. -
Push the project using
tb push
.
2. Send events to your data source
Copy the snippet from the banner, and paste it on your site <head>
:
If everything is working correctly, you should start seeing rows in your Data Source as visitors view and interact with your website
And you're done! š
<details id='manual-install'> <summary><h4>More details on the snippet</h4></summary>The banner generates a snippet like this one, including the tracking script:
<script
defer
src="https://unpkg.com/@tinybirdco/flock.js"
data-token="YOUR_TRACKER_TOKEN"
></script>
Script parameters:
Parameter | Mandatory | Description |
---|---|---|
data-token | Yes | Your tracker token. It's already created for you, you can find it on the Tinybird UI under "Manage Auth Tokens" |
data-proxy | No | Your domain URL to proxy the request, if you follow the optional steps for "GDPR Best Practices" |
data-host | No | Tinybird host URL. Ddefaults to https://api.tinybird.co/ , but could be https://api.us-east.tinybird.co or a dedicated cluster. The banner already generates the snippet with the proper host. |
data-datasource | No | If you iterate the landing data source, or you just want to ingest the event in a different one, you can specify the landing data source name. |
3. Visualize the metrics on a readymade dashboard
Now you'll see a banner with a link to the dashboard. Click to open it:
Alternatively, you can always navigate to https://analytics.tinybird.co/ and paste your dashboard
token.
You'll find this dashboard
token already created for you on the Tinybird UI, under "Manage Auth Tokens".
Warning<br> > GDPR: Don't track any personal (PII), ids, codes, or any other information that may lead to identify an individual (not even fingerprinting). Track only the essential events when needed, and use aggregated metrics.
The script also provides you with a function to send custom events. You can simply add this to your application at any point:
Tinybird.trackEvent('add_to_cart', {
partnumber: 'A1708 (EMC 3164)',
quantity: 1,
})
You can also fork the dashboard project in this repository and create custom components for your new events. It's a Next.js project, so you can deploy it easily on Vercel.
</details> <details> <summary><h2>Custom attributes (optional)</h2></summary>Custom Ecommerce events examples coming soon!
You can include custom attributes in the import library snippet. Attributes name must have tb_ prefix. Every attribute included with this requirement would be saved in the payload column of your analytics_events datasource and will be included in every event. For example:
<script
src="https://unpkg.com/@tinybirdco/flock.js"
data-token="TOKEN-ID"
tb_customer_id="CUSTOMER_ID"
></script>
Would append customer_id:CUSTOMER_ID to the rest of variables saved in payload column.
</details> <details id='gdpr'> <summary><h2>GDPR best practices (optional)</h2></summary>Warning<br> > GDPR: These are some tips to follow the GDPR guidelines, but compliance is not guaranteed. Follow these instructions and assess with your legal team. For more details on how to implement a privacy-first tracker for compliance, read this.
Requirements:
- Create your Tinybird Workspace in EU region.
- Don't track any personal (PII), ids, codes, or any other information that may lead to identify an individual (not even fingerprinting).
- Track only the essential events when needed.
- Use aggregated metrics, never at individual level (session).
- Your visitors should be able to opt out at ANY time.
Instructions to make it a first-party solution
To make this a first-party solution end-to-end, you'll need to send the events to the data pipeline using your own domain. You'll own the data, and Tinybird won't analyze it in any way.
You will need to set up:
- A tracking script delivery under <!-- this seems incomplete? -->
- A proxy to Tinybird Events API
-
Deploy the middleware to Vercel.
-
Fill in the
TINYBIRD_TOKEN
environment variable with the ingestion token you created in the basic setup. -
Add a subdomain to your site, for example
events.example.com
. Most ad-blockers won't block a subdomain on your root domain, but just to be sure, avoidanalytics.example.com
,tracking.example.com
or similar so anti-trackers don't block your requests. -
Update the snippet from the basic setup to this, using your configured subdomain:
<script
defer
src="https://events.example.com/index.js"
data-proxy="https://events.example.com"
></script>
</details>
<details id='next'>
<summary><h2>What's next?</h2></summary>
- Need more inspiration? Check out our upcoming live coding session.
- The big picture: How an eCommerce giant replaced Google Analytics for privacy and scale
Deploying the dashboard to Vercel
If you want to customize & host your own dashboard, you can easily deploy the project to Vercel using the button below:
Authors
- Rafa Moreno
- Raquel Yuste
- Alasdair Brown
- Kike Alonso
- Cameron Archer
- Javier Ćlvarez
- Sergio Ćlvarez
- Jorge Gomez
- Alejandro Martin
Need help?: Community Slack ā¢ Tinybird Docs ā¢ Email