Google Analytics tracker for Apple tvOS
by Adswerve
About
Google Analytics tracker for Apple tvOS provides an easy integration of Google Analytics’ measurement protocol for Apple TV. This library enables sending screenviews, events, exceptions and any other hit type to Google Analytics. Implementation of the library and sending an initial hit to Google Analytics takes only a few minutes.
Implementation
All code for this tracker is located inside a single file “GATracker.swift”. The first step of the implementation is associating this library file with your application project.
This library creates an object (a tracker) that holds persistent values such as client id, property id, and more. The tracker is created with the following command:
GATracker.setup("UA-1234567-89")
This code should run in the AppDelegate method applicationDidFinishLaunchingWithOptions.
Hit Examples
Once the tracker is set up you can start sending Google Analytics hits from your Apple TV application.
Screenview
When sending the screenview hit type, the screenname parameter is a required field.
GATracker.sharedInstance.screenView("FirstScreen", customParameters: nil)
Event
When sending the event hit type, the event category and action a required fields
GATracker.sharedInstance.event("category", action: "action", label: nil, customParameters: nil)
Exception
When sending the exception hit, the exception description and exception “fatality” are both required parameters
GATracker.sharedInstance.exception("This test failed", isFatal: true, customParameters: nil)
Sending Additional Parameters
With each hit you are also able to send additional parameters as specified in the Measurement Protocol reference. Examples include: “non interactive hit”, “event value”, “custom dimensions”, “custom metrics” etc.
In the following example we will add custom metric values and set this event hit as non interactive. The example shows how to send a video progress hit that includes video name as custom dimension 1, video author as custom dimension 2 and sets the event as non interactive (since this event is not a result of user interaction).
GATracker.sharedInstance.event("Video", action: "Progress", label:"50%", customParameters: ["cd1":"Incredible Video", "cd2":"Amazing A. Uthor", "ni":1])
As mentioned before you are able to use any measurement protocol parameters inside the customParameters dictionary. https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters?hl=en
Sending Other Hit Types to Google Analytics
Screenview, event and exception are not the only hit types available in Google Analytics, to send a different hit such as a transaction, item, social or timing hit use the send function.
In the following example we will send a transaction hit with transaction id 10001 and transaction revenue of $425,00.
GATracker.sharedInstance.send("transaction", params: ["tid":"10001", "tr":"425,00", "cu":"USD"])
For additional information email [email protected] or visit our website http://www.analyticspros.com
Sample App
When running the sample app make sure ot update the property id in the app delegate.
GATracker.setup("[insert your GA property id]")
1 Oct 18, 2021
0 Dec 15, 2021
171 Nov 22, 2022
3 Dec 2, 2022
2 Jul 11, 2022
211 Dec 6, 2022
16 Jul 22, 2021
8 Jan 25, 2022
189 Dec 16, 2022
3 Jul 26, 2022
3.2k Dec 30, 2022
53 Dec 16, 2022
2k Jan 2, 2023
82 Oct 5, 2022
367 Dec 17, 2022
71 Nov 2, 2022
2.9k Dec 21, 2022
466 Nov 13, 2022
45 Oct 27, 2022
56 Oct 27, 2022
102 Oct 5, 2022
0 Feb 1, 2022
145 Apr 14, 2022