README

Beyonk

Svelte Google Analytics

Supports Google Analytics v4!

Install the package

npm i --save-dev @beyonk/svelte-google-analytics

Usage

In App.svelte

import { GoogleAnalytics } from '@beyonk/svelte-google-analytics'

<GoogleAnalytics properties={[ 'google property id A', ...'google property id X' ]} />

Component accepts two additional properties: enabled and configurations.

The `configurations` property (optional)

configurations props which accepts an object type with configurations for the properties. The key in this object is the id of the property.
Example on disabling automatic pageviews for the id-1 property:

<GoogleAnalytics 
    properties={[ 'id-1' ]} 
    configurations={{ 'id-1': { 'send_page_view': false } }} />

The `enabled` property (optional)

The enabled prop set to true by default. Logic can be added here to disable/enable analytics.

If you disable tracking by default, for instance, due to GDPR, then you can enable it later by calling init() on your component:

<GoogleAnalytics 
    bind:this={ga}
    properties={[ 'id-1' ]} 
    enabled={false} />

<script>
  function enableAnalytics () {
    ga.init()
  }
</script>

Page Tracking

With Google Analytics v4, most basic events are automatic. See the docs

(see Google Analytics offical docs - Pageviews) for more info

Event Tracking

All events specified in the documentation are implemeneted (generated automatically from scraping the docs pages and building the project!)

<script>
  import { ga } from '@beyonk/svelte-google-analytics'

  function handleClick () {
    ga.earnVirtualCurrency('SvelteBucks', 50)
  }
</script>

<main>
  <button on:click={handleClick}>Get 50 SvelteBucks</button>
</main>

Custom Events

Custom events can be tracked with addEvent:

<script>
  import { ga } from '@beyonk/svelte-google-analytics'

  function handleClick () {
    ga.addEvent('event_name', {
      foo: 'bar',
      baz: 'qux'
    })
  }
</script>

Multiple Properties

To send an event to a different property, specify the property id as the last parameter to the event: send_to.

ga.earnVirtualCurrency('SvelteBucks', 50, 'Property Id B')

Usage no npm install needed!