By now, you should have access to your own Dashboard project, and the API key pair for the Dashboard collector.
The process that the JavaScript SDK uses for logging events is as follows:
- A new collector object is initialised, with the API key pair values and Analytics URL passed into it
- Your custom event objects are formatted to your choosing
- using the logEvent() Method, your single event is sent via your custom collector to the Simple Analytics Collector
- using the logEvents() Method, your multiple events are sent via your custom collector to the Simple Analytics Collector
Collectors
The SDK makes use of two seperate collectors, which we'll reference individually throughout this guide. These are:
- Simple Analytics Collector - Configured by Blink for your Dashboard Project, this collector talks directly to the analytics database to store your data. This collector is communicated with via your custom events collector, using it's unique API key pair.
- Custom Events Collector - Configured by the user within your code, this will take the API key pair from your Dashboard Collector, allowing you to communicate and send your events directly to it.
First off, we'll start by setting up some basic configuration and walking you through how to initialise your custom collector in your code.
Afterwards, we'll show you how to format and start logging your own custom events.