/measurement

Elm package for working with Google Analytics Measurement Protocol

Primary LanguageElmBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Measurement Protocol

This package helps you to work with Google Analytics Measurement protocol.

Here you can see online demo.

Sending Required Values

POST request

Let's send page view event to the Google Analytics:

import Measurement as GA
import Parameter
import Http

GA.post
    { hitType = HitType.Pageview
    , trackingId = "UA-123456-1"
    , clientId = "555"
    , payload = [ Parameter.DocumentPath "/pageA" ]
    }
    |> Http.post

This will construct Measurement Protocol hit and send it to the POST /collect endpoint. You can check your request with Hit Builder.

GET request

For environments where you can not send POST data, you can also send HTTP GET requests.

import Measurement as GA
import Parameter
import Http

GA.get
    { hitType = HitType.Event
    , trackingId = "UA-XXXXX-Y"
    , clientId = "555"
    , payload =
        [ Parameter.CacheBuster "289372387623"
        , Parameter.EventCategory "video"
        , Parameter.EventAction "play"
        , Parameter.EventLabel "holiday"
        , Parameter.EventValue 300
        ]
    }
    |> Http.get

Batch requests

To send multiple hits in a single request, use batch mode.

import Measurement as GA
import Parameter
import Http

GA.batch
    [ { hitType = HitType.Event
      , trackingId = "UA-XXXXX-Y"
      , clientId = "555"
      , payload =
            [ Parameter.CacheBuster "289372387623"
            , Parameter.EventCategory "video"
            , Parameter.EventAction "play"
            , Parameter.EventLabel "holiday"
            , Parameter.EventValue 300
            ]
      }
    , { hitType = HitType.Pageview
      , trackingId = "UA-123456-1"
      , clientId = "5555"
      , payload = [ Parameter.DocumentPath "/pageA" ]
      }
    ]
    |> Http.post