Pugpig Analytics Specification
Written by Lois Mortimer
Updated at May 6th, 2025
Table of Contents
Welcome to the Pugpig Analytics Specification – a comprehensive guide to all of the events, screens and dimensions that we track in our Bolt apps and web readers.
The document is broken down into three sections:
- Events - measure specific user interactions with your product
- Dimensions and properties - describe details about the event or the user who performed the event. They are the attributes of your data.
- Screens - the screen from which an event was triggered
Scope
Tying them together is their scope. We've assigned a scope to each event, screen and dimension to indicate how the three relate to each other. The scope indicates the depth of your analytics and is split into three categories:
- Page - captures all interactions in the content view
- Collection - captures all interactions at the collection level (edition or timeline)
- Global - found globally. These dimensions send with all events
Events
Events measure specific user interactions with your Bolt app and web reader.
Lifecycle events
BoltAppFirstOpen
Tracks the first time the user opens the app.
Scope: GLOBAL
Platform: App
BoltAppUpdated
Tracks when a user updates the app from a previous version.
Scope: GLOBAL
Platform: App
BoltLaunchedWithURL
Tracks when the app is opened from a URL. Tracked from Bolt version 4.3
Key dimensions:
| GA4 Dimension | Description | Values |
|---|---|---|
| pugpigURL / KGURL | The URL that started the app | e.g. app.pugpig.com/t/storefront/storefront |
Scope: GLOBAL
Platform: App
BoltLogin
Tracks when a subscriber login is successful.
Scope: GLOBAL
Platform: App + Web
In GA4, you can use Page Title and Screen Name to determine where the BoltLogin event took place.
BoltLoginDismissed
Tracks when a user dismisses the login modal
Scope: GLOBAL
Platform: App
BoltLoginFailed
Tracks when a subscriber login is unsuccessful.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigError / KGError | Details the reason for the failure | e.g. KGAuthErrorSignIn |
Scope: GLOBAL
Platform: App + Web
BoltLoginSelected
Tracks when a user taps a button that opens the sign in modal.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigSource / KGLabel | The screen type where the sign in tap takes place |
Deeplink Paywall Subscription Settings |
Scope: GLOBAL
Platform: App + Web
BoltLogout
Tracks when a subscriber logs out
Scope: GLOBAL
Platform: App + Web
BoltOnboardingActionTapped
Tracks when a user taps the call to action button from a Bolt welcome screen.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigScreenName / KGLabel | The screen name where the tap takes place | e.g. screen1 |
Scope: GLOBAL
Platform: App
BoltOnboardingCompleted
Tracks when a user reaches the last Bolt welcome screen and taps the button to dismiss it.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigScreenName / KGLabel | The screen name where the skip takes place | e.g. screen6 |
Scope: GLOBAL
Platform: App
BoltOnboardingSkipped
Tracks when a user taps the skip button from a Bolt welcome screen.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigScreenName / KGLabel | The screen name where the skip takes place | e.g. screen1 |
Scope: GLOBAL
Platform: App
BoltParentalGateFail
Tracks when the parental gate bypass fails
Scope: GLOBAL
Platform: App
BoltParentalGatePass
Tracks when the parental gate bypass succeeds
Scope: GLOBAL
Platform: App
BoltTextResize
Tracks users' interaction with the text resize slider settings item. Tracked from Bolt version 4.3.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTextResize / KGLabel | The font size value chosen by the user | e.g. 1.5 |
Scope: GLOBAL
Platform: App
BoltTrackingToggled
Tracks when a user turns analytics tracking on or off, if an analytics content screen is configured.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigToggleState / KGLabel | Details the tracking status | YES NO |
Scope: GLOBAL
Platform: App
Purchase and paywall events
BoltMeterDisplayShown
Tracks when the meter is shown.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigLimitCount / KGLabel | The number of free articles the user has remaining | e.g. 9 |
| pugpigPageName / KGPageName | The page name where the meter was shown | e.g. Today's News |
Scope: PAGE
Platform: App
BoltMeterDisplayTapped
Tracks when the meter display is tapped.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The page name where the meter was tapped | e.g. Today's News |
Scope: PAGE
Platform: App
BoltPaywallDismissed
Tracks when a user taps to dismiss the paywall.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The page name where the paywall was dismissed | e.g. Today's News |
Scope: PAGE
Platform: App + Web
BoltPaywallDisplayed
Tracks when a user sees the paywall. This happens primarily while viewing article content but can also can be happen when a user taps on cards that don't have an associated content view (i.e. audio cards).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The page name where the paywall was displayed | e.g. Today's News |
Scope: PAGE
Platform: App + Web
BoltRestorePurchases
Tracks when a purchase is restored on iOS. Restoration is automatic on Android.
Scope: GLOBAL
Platform: App
BoltSinglePurchase
Tracks when a single issue has been purchased via the store
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigProductSKU / KGLabel | The product SKU (stock keeping unit) | e.g. 101300 |
Scope: GLOBAL
Platform: App
BoltSinglePurchaseSelected
Tracks when an app store (iTunes, Google Play, Amazon) purchase is selected via the paywall.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigProductSKU / KGLabel | The product SKU (stock keeping unit) | e.g. 101300 |
Scope: PAGE
Platform: App
BoltStorefrontFilterTapped
Tracks when an item in the filter bar is tapped.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigFilter / KGLabel | The collection path (iOS) or the user-facing name of the filter (Android) |
e.g. /t/storefront/magazines (iOS) or Magazines (Android) |
Scope: GLOBAL
Platform: App
BoltStorefrontSubscribeTapped
Tracks when the subscribe button on the storefront is tapped.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigEditionID / KGLabel | Indicates the edition on which the subscribe button was tapped | e.g magazine.issue.010124 |
Scope: GLOBAL
Platform: App
BoltSubscriptionChosen
Tracks when subscription duration is selected on the subscribe panel (eg. one year).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigSubscriptionID / KGLabel | The subscription ID | e.g. com.news.magazine.1year |
Scope: GLOBAL
Platform: App
BoltSubscriptionClicked
Tracks when the subscribe button is tapped to display a choice panel of one or many subscription durations which leads to a BoltSubscriptionChosen event.
Scope: GLOBAL depending on where the user is when they tap
Platform: App
In GA4, you can use Page Title and Screen Name to determine where the BoltSubscriptionClicked event took place.
BoltSubscriptionDismissed
Tracks when the user dismisses the subscription modal.
Scope: GLOBAL
Platform: App
BoltSubscriptionLinked
Tracks when a user links their app store subscription via receipt postback.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigError / KGError | Sends an error string in the event that the subscription link fails | e.g. The operation couldn’t be completed. (HTTP error 401.) |
Scope: GLOBAL
Platform: App
BoltSubscriptionPurchase
Tracks when a subscription has been purchased via the store. On iOS both renewals and purchases are currently being tracked by this event (pending a fix).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigSubscriptionID / KGLabel | The subscription ID | e.g. com.news.magazine.1year |
Scope: GLOBAL
Platform: App
BoltVoucherRedemptionFail
Tracks when a subscriber voucher code redemption is unsuccessful.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigVoucherCode / KGLabel | The code of the voucher the user has attempted to redeem | e.g. news10 |
| pugpigError / KGError | The reason that the redemption was unsuccessful | e.g. too many concurrent devices |
Scope: GLOBAL
Platform: App + Web
BoltVoucherRedemptionSuccess
Tracks when a subscriber voucher code is successfully redeemed.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigVoucherCode / KGLabel | The code of the voucher that has been redeemed | e.g. news10 |
Scope: GLOBAL
Platform: App + Web
Audio events
BoltAudioAddToQueue
Tracks when a user adds a track to the audio player queue.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTrackName / KGLabel | The track name | e.g. Today's Podcast |
Scope: PAGE
Platform: App
BoltAudioClear
Tracks when the clear queue button is tapped.
Scope: GLOBAL
Platform: App
BoltAudioDismiss
Tracks when the user closes the audio player.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTrackName / KGLabel | The track name | e.g. Today's Podcast |
| pugpigAudioElapsedSeconds / KGAudioElapsedSeconds | The time that elapsed in the audio track before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigAudioTotalSeconds / KGAudioTotalSeconds | The total duration of the audio track (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App
BoltAudioOfflineToggle
Tracks when the “available offline” toggle is tapped.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigToggleState / KGLabel | The toggle state |
YES NO |
Scope: GLOBAL
Platform: App
BoltAudioPause
Tracks when a user pauses a piece of audio.
Key dimensions
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTrackName / KGLabel | The track name | e.g. Today's Podcast |
| pugpigAudioElapsedSeconds / KGAudioElapsedSeconds | The time that elapsed in the audio track before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigAudioTotalSeconds / KGAudioTotalSeconds | The total duration of the audio track (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App + Web
BoltAudioPlay
Tracks when a user begins playing a piece of audio through actively tapping the play button. This is a subset of BoltAudioStartedPlaying.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTrackName / KGLabel | The track name | e.g. Today's Podcast |
| pugpigAudioElapsedSeconds / KGAudioElapsedSeconds | The time that elapsed in the audio track before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigAudioTotalSeconds / KGAudioTotalSeconds | The total duration of the audio track (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App + Web
BoltAudioSeekBack15
Tracks when seek back by 15 seconds icon is tapped.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTrackName / KGLabel | The track name | e.g. Today's Podcast |
| pugpigAudioElapsedSeconds / KGAudioElapsedSeconds | The time that elapsed in the audio track before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigAudioTotalSeconds / KGAudioTotalSeconds | The total duration of the audio track (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App
BoltAudioSeekForward15
Tracks when seek forward by 15 seconds icon is tapped.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTrackName / KGLabel | The track name | e.g. Today's Podcast |
| pugpigAudioElapsedSeconds / KGAudioElapsedSeconds | The time that elapsed in the audio track before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigAudioTotalSeconds / KGAudioTotalSeconds | The total duration of the audio track (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App
BoltAudioSkipBack
Tracks when the previous track button is tapped.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTrackName / KGLabel | The track name | e.g. Today's Podcast |
| pugpigAudioElapsedSeconds / KGAudioElapsedSeconds | The time that elapsed in the audio track before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigAudioTotalSeconds / KGAudioTotalSeconds | The total duration of the audio track (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App
BoltAudioSkipForward
Tracks when skip forward icon is tapped.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTrackName / KGLabel | The track name | e.g. Today's Podcast |
| pugpigAudioElapsedSeconds / KGAudioElapsedSeconds | The time that elapsed in the audio track before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigAudioTotalSeconds / KGAudioTotalSeconds | The total duration of the audio track (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App
BoltAudioSpeedChanged
Tracks when a users interacts with the playback speed button in the audio player
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigAudioSpeed / KGLabel | The user's chosen playback speed | 0.5, 1 , 1.25, 1.5, 2 |
| pugpigTrackName / KGTrackName | The track name | e.g. Today's podcast |
| pugpigAudioElapsedSeconds / KGAudioElapsedSeconds | The time that elapsed in the audio track before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigAudioTotalSeconds / KGAudioTotalSeconds | The total duration of the audio track (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App + Web
BoltAudioStartedPlaying
Tracks when a piece of audio begins playing (e.g. from the queue or when a user presses play).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTrackName / KGLabel | The track name | e.g. Today's Podcast |
| pugpigAudioElapsedSeconds / KGAudioElapsedSeconds | The time that elapsed in the audio track before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigAudioTotalSeconds / KGAudioTotalSeconds | The total duration of the audio track (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App
BoltAudioTapped
Tracks when a user taps to play audio from a collection (timeline or edition) or article page. Currently only tracks from collections (content tracking coming soon)
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigWidgetTitle / KGLabel | The name of the widget on which the user pressed play | e.g. Edition Cover |
| pugpigPageName / KGPageName | The name of the page housing the audio track that is played | e.g. New Podcast |
Scope: PAGE
Platform: App
BoltAudioTrackComplete
Tracks when a track that is being played reaches the end.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTrackName / KGLabel | The track name | e.g. Today's Podcast |
| pugpigAudioElapsedSeconds / KGAudioElapsedSeconds | The time that elapsed in the audio track before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigAudioTotalSeconds / KGAudioTotalSeconds | The total duration of the audio track (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App + Web
Video events
Currently in-content YouTube videos are not sending analytics tracking. A fix for this is scheduled.
BoltVideoBuffer
Tracks when a video buffers.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the video that has buffered | e.g. breaking news |
| pugpigVideoElapsedSeconds / KGVideoElapsedSeconds | The time that elapsed in the video before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigVideoTotalSeconds / KGVideoTotalSeconds | The total duration of the video (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App + Web
BoltVideoComplete
Tracks when a video finishes.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the video that has completed | e.g. breaking news |
| pugpigVideoElapsedSeconds / KGVideoElapsedSeconds | The time that elapsed in the video before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigVideoTotalSeconds / KGVideoTotalSeconds | The total duration of the video (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App + Web
BoltVideoPause
Tracks when pause is tapped on a video (you can therefore have multiple video playing events tracked for one video if a user is pausing it and then restarting it).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the video that the user has paused | e.g. breaking news |
| pugpigVideoElapsedSeconds / KGVideoElapsedSeconds | The time that elapsed in the video before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigVideoTotalSeconds / KGVideoTotalSeconds | The total duration of the video (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App + Web
BoltVideoPlay
Tracks when play is tapped on a video (you can therefore have multiple video playing events tracked for one video if a user is pausing it and then restarting it).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the video that the user has played | e.g. breaking news |
| pugpigVideoElapsedSeconds / KGVideoElapsedSeconds | The time that elapsed in the video before the event took place (seconds) | e.g. 1, 10, 50 |
| pugpigVideoTotalSeconds / KGVideoTotalSeconds | The total duration of the video (seconds) | e.g 1, 10, 50 |
Scope: PAGE
Platform: App + Web
Content interaction events
BoltCarouselTap
Tracks when a user taps on an item within a carousel.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigCarouselTitle / KGLabel | The title of the carousel | e.g. latest_news |
Scope: PAGE
Platform: App + Web
BoltClipClicked
Tracks when a user clicks the clip button from the print menu (web only).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName/KGPageName | The name of the page the user selected to print | e.g. Page 2 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
| pugpigEditionName / KGEditionName | The name of an collection, sent from the JSON feed | e.g. Issue 1 |
Scope: COLLECTION
Platform: Web
BoltDeleteAllEditions
Tracks when all editions are marked for deletion.
Scope: GLOBAL
Platform: App
BoltDownloadMenuClosed
Tracks when a user clicks to close the download menu (web only).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName/KGPageName | The name of the page the user is on | e.g. Page 2 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
| pugpigEditionName / KGEditionName | The name of an collection, sent from the JSON feed | e.g. Issue 1 |
Scope: PAGE
Platform: Web
BoltDownloadMenuOpened
Tracks when a user clicks to open the download menu (web only).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName/KGPageName | The name of the page the user is on | e.g. Page 2 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
| pugpigEditionName / KGEditionName | The name of an collection, sent from the JSON feed | e.g. Issue 1 |
Scope: PAGE
Platform: Web
BoltDownloadPageClicked
Tracks when a user clicks the download edition button from the download menu (web only).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName/KGPageName | The name of the page the user is on | e.g. Page 2 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
| pugpigEditionName / KGEditionName | The name of an collection, sent from the JSON feed | e.g. Issue 1 |
Scope: PAGE
Platform: Web
BoltDownloadEditionClicked
Tracks when a user clicks to open the download menu (web only).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName/KGPageName | The name of the page the user is on | e.g. Page 2 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
| pugpigEditionName / KGEditionName | The name of an collection, sent from the JSON feed | e.g. Issue 1 |
Scope: PAGE
Platform: Web
BoltEditionDeleted
Tracks whenever an edition is marked for deletion from the storefront.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigEditionName / KGEditionName | The name of a collection, sent from the JSON feed | e.g. Issue 01 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
Scope: COLLECTION
Platform: App
BoltEditionOpened
Tracks when a user opens an edition.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigEditionName / KGEditionName | The name of an collection, sent from the JSON feed | e.g. Issue 01 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
Scope: COLLECTION
Platform: App + Web
BoltPrintClicked
Tracks when a user clicks the print button from the print menu (web only).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName/KGPageName | The name of the page the user selected to print | e.g. Page 2 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
| pugpigEditionName / KGEditionName | The name of an collection, sent from the JSON feed | e.g. Issue 1 |
Scope: PAGE
Platform: Web
BoltPrintMenuClosed
Tracks when a user clicks to close the print menu (web only).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName/KGPageName | The name of the page the user is on | e.g. Page 2 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
| pugpigEditionName / KGEditionName | The name of an collection, sent from the JSON feed | e.g. Issue 1 |
Scope: PAGE
Platform: Web
BoltPrintMenuOpened
Tracks when a user clicks to open the print menu (web only).
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName/KGPageName | The name of the page the user is on | e.g. Page 2 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
| pugpigEditionName / KGEditionName | The name of an collection, sent from the JSON feed | e.g. Issue 1 |
Scope: COLLECTION
Platform: Web
BoltSave
Tracks when you save a card to the saved timeline.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the card the user is saving | e.g. World news |
Scope: PAGE
Platform: App + Web
BoltScroll
Tracks when a users scrolls on an article. Only fires once per page (upon the user navigating away from the article). It requires configuration.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigScrollDepth / KGScrollDepth | How far the user navigated through the page | Recommended parameters: 25%, 50%, 75%, 90% and 100% |
Scope: PAGE
Platform: App
BoltScrubberClose
Tracks when a user closes the edition scrubber
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigEditionName / KGEditionName | The name of a collection, sent from the JSON feed | e.g. Issue 01 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
Scope: COLLECTION
Platform: App + Web
BoltScrubberItemSelected
Tracks when a user taps on a page within the edition scrubber.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the page selected from the scrubber | e.g. Breaking news |
| pugpigEditionName / KGEditionName | The name of a collection, sent from the JSON feed | e.g. Issue 01 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
Scope: PAGE
Platform: App + Web
BoltScrubberOpen
Tracks when a user opens the edition scrubber.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigEditionName / KGEditionName | The name of a collection, sent from the JSON feed | e.g. Issue 01 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
Scope: COLLECTION
Platform: App + Web
BoltShare
Tracks when card content or an article is shared.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigShareType / KGLabel | The platform that the user has chosen to share via (iOS only) | e.g. net.whatsapp.WhatsApp.ShareExtension |
| pugpigPageName / KGPageName | The name of the page the user is sharing | e.g. World news |
Scope: PAGE
Platform: App + Web
BoltShareOpened
Tracks when the share dialogue is opened from a card. This takes place in both the timeline and article views.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the card the user is removing | e.g. World news |
Scope: PAGE
Platform: App + Web
BoltScrubberSectionSelected
Tracks when a user selects a section to navigate to from the scrubber.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigEditionName / KGEditionName | The name of a collection, sent from the JSON feed | e.g. Issue 01 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
Scope: COLLECTION
Platform: App + Web
BoltUnsave
Tracks when a user removes an article or card from the saved timeline.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the card the user is removing | e.g. World news |
Scope: PAGE
Platform: App + Web
BoxoutOpen
Tracks when a user expands a boxout to read the contents.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the article where the user has expanded the boxout | e.g. Breaking News |
Scope: PAGE
Platform: App
RecirculationModuleClick
Tracks when a user clicks on the recirculation module to view a recommended piece of content.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigDestinationPageName / KGLabel | The name of the page the recirculation module click takes the user to | e.g. The top 10 places to visit this summer |
| pugpigDestinationURL | The URL of the page the recirculation module click takes the user to | e.g. https://app.pugpig.com/article/123456/content.html |
| pugpigPageName | The name of the page the user is on when they interact with the recirculation module | e.g. Today's top stories |
| pugpigPageURL | The URL of the page the user is on when they interact with the recirculation module | e.g. https://app.pugpig.com/article/789101/content.html |
Scope: PAGE
Platform: App + Web
Product interaction events
BoltAddToCalendar
Tracks when add to calendar is pressed & event is not subscribed.
Scope: PAGE
BoltDarkModeToggle
Tracks when a user updates their dark mode preferences.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigToggleState / KGLabel | Indicates the state the user has updated to |
System Dark Light |
Scope: GLOBAL
BoltExternalLinkOpened
Tracks when an external link is launched.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigDestinationURL / KGLabel | The destination URL | e.g. https://x.com/pugpig |
Scope: PAGE
BoltIconChanged
Tracks when a user changes the app icon
Scope: GLOBAL
BoltNotificationOpen
Tracks when a user opens a push notification
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigCampaign / KGLabel | The PPCampaign value from the push data. In some providers you will need to declare this for every notification campaign | e.g. NewEditionPush |
Scope: GLOBAL
BoltNotificationStatusChange
Tracks when a user updates their notification opt-in status.
iOS: sent as soon as notification permissions are changed. Android: sent upon force killing and relaunching the app.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigNotificationAllowedStatus / KGNotificationsAllowedStatus | The user-level notification status that the user has been updated to |
Authorised Denied Provisional (iOS-only) Unknown |
| pugpigNotificationStatus / KGLabel | The notification status that has been selected by the user |
Authorised Denied Provisional (iOS-only) Unknown |
Scope: GLOBAL
BoltSettingsSelected
Tracks when a user selects an item on the settings screen.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigItemSelected / KGLabel | The item the user has selected | e.g. Sign out |
| pugpigPageName / KGPageName | The text in the settings that the user clicked on |
Scope: GLOBAL
BoltSpreadModeToggle
Tracks when a user interacts with the landscape spread mode toggle in their app settings.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigSpreadMode / KGLabel | Details the spread mode that the user has selected when reading an edition in landscape. | Single, Double |
Scope: GLOBAL
BoltSwipeBackward
Tracks when a page is swiped backward.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
|
pugpigScreenName / Page title and screen name |
The page the user swiped from | e.g. /t/news/latest |
| pugpigDesinationURL / KGLabel | The page the user swiped to | e.g. /t/news/sport |
Scope: PAGE
BoltSwipeForward
Tracks when a page is swiped forward.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
|
pugpigScreenName / Page title and screen name |
The page the user swiped from | e.g. /t/news/latest |
| pugpigDesinationURL / KGLabel | The page the user swiped to | e.g. /t/news/sport |
Scope: PAGE
BoltTap
Tracks when a card is tapped or clicked. Including external link, tapping on the find out more link in event card, tapping to view tweet on the Twitter/X card.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the card the user has tapped | e.g. World news |
Scope: PAGE
BoltTabTapped
Tracks when a tab is tapped from the tab menu.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTabKey / KGLabel | The tab key the user tapped on | e.g. news, storefront |
Scope: GLOBAL
BoltTimelinePickerTapped
Tracks when a timeline is tapped on from the timeline picker.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTimelineName / KGLabel | The timeline name the user tapped on | e.g. /t/home/latest |
Scope: COLLECTION
BoltTimelinePullToRefresh
Tracks when a user initiates pull to refresh on the timeline.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigEditionName / KGEditionName | Indicates the name of the edition or timeline that the user is refreshing | e.g. Issue 01, news |
Scope: COLLECTION
BoltToolbarIconTapped
Tracks when the toolbar icon is tapped.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigURL / KGLabel | Indicates the URL of the icon the user tapped on | e.g. https://app.pugpig.com/t/settings |
In GA4, you can use Page Title and Screen Name to determine where the BoltToolbarIconTapped event took place.
Scope: GLOBAL
BoltTwitterLike
Tracks when a tweet is liked from the collection.
Scope: PAGE
BoltViewEvent
Tracks when add to calendar is pressed & event is subscribed (this is iOS only).
Scope: PAGE
BreakWidgetClicked
Tracks when a user selects the button to load more content on the timeline break widget.
Scope: COLLECTION
BoltTimelineSetChosen
Tracks when a collection set is selected.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigCollectionSet / KGCollectionSet | The collection set that the user chose | e.g. north america, international |
Scope: GLOBAL
SetScreen
Tracks when a user views a screen.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigScreenName | The name of the screen | e.g. latest news |
Scope: PAGE
Search events
SearchAttempt
Tracks when a user hits enter in the search panel.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigSearchTerm / KGLabel | The search term the user entered | e.g. News |
Scope: GLOBAL
SearchSortToggle
Tracks when a user taps on the search toggle
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigToggleState / KGLabel | Indicates what the user toggled to |
Most recent Most relevant |
Scope: GLOBAL
SearchTermClicked
Tracks when a user taps on a search result
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigURL / KGLabel | The URL of the result the user tapped on | |
| pugpigSearchResultCount / KGSearchResultCount | The number of results returned in the search query | e.g. 1, 5, 100 |
Scope: GLOBAL
Puzzle events
MorePuzzleInfo
Tracks when a user taps the ? button on a puzzler screen
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the puzzle the user tapped the button on | e.g. crossword |
Scope: PAGE
PuzzleCompleted
Tracks when a user successfully completes a puzzler game
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the puzzle the user completed | e.g. crossword |
Scope: PAGE
PuzzleExited
Tracks when a user exits a puzzler game
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the puzzle the user completed | e.g. crossword |
Scope: PAGE
PuzzleHintUsed
Tracks when a user taps the puzzle hint button
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the puzzle the user asked for a hint for | e.g. crossword |
Scope: PAGE
PuzzleLoaded
Tracks when a user loads a puzzle
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the puzzle the user loaded | e.g. crossword |
Scope: PAGE
PuzzleReset
Tracks when a user resets a puzzle
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigPageName / KGPageName | The name of the puzzle the user reset | e.g. crossword |
Scope: PAGE
Diagnostic events
BoltDownloadStarted
Tracks when a collection (edition or timeline) download is initiated
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTriggerMethod / KGLabel | Indicates how the download was triggered |
Heuristic Push User |
Scope: COLLECTION
BoltDownloadCompleted
Tracks when a collection (edition or timeline) download is completed
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTriggerMethod / KGLabel | Indicates how the download was triggered |
Heuristic Push User |
| pugpigDownloadAssetsCount / KGDownloadAssetsCount | Total number of assets | |
| pugpigDownloadAssetsNotModified / KGDownloadAssetsNotModified | Total number of 304s | |
| pugpigDownloadSize / KGDownloadSize | Total number of bytes downloaded |
Scope: COLLECTION
BoltDownloadFailed
Tracks when a collection (edition or timeline) download partially or fully fails
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigTriggerMethod / KGLabel | Indicates how the download was triggered |
Heuristic Push User |
| pugpigError / KGError | Indicates the reason for the failure | e.g. The request timed out |
Scope: COLLECTION
BoltEditionAutoArchived
Tracks whenever an edition is automatically archived from the storefront.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigEditionName / KGEditionName | The name of a collection, sent from the JSON feed | e.g. Issue 01 |
| pugpigEditionID / KGEditionID | The unique ID of a collection, sent from the JSON feed | e.g. issue01 |
Scope: COLLECTION
BoltDiagnosticCacheEmpty
Tracks iOS' cache clearing behaviour.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigCacheDirCount / KGCacheDirCount | Last estimate count of directories before OS cleared the cache | e.g. 10 |
| pugpigCacheFileCount / KGCacheFileCount | Last estimate count of files before OS cleared the cache | e.g. 10 |
| pugpigCacheSize / KGCacheSize | Last estimate number of bytes before OS cleared the cache | e.g. 1000000 |
Scope: GLOBAL
BoltRenewStarted
Tracks when the app requests a refresh token from the auth server.
Scope: GLOBAL
BoltRenewCompleted
Tracks when the app receives a valid refresh token from the auth server and the user's access (or lack thereof) is renewed.
Scope: GLOBAL
BoltRenewFailed
Tracks when OAuth renewal fails.
Key dimensions:
| Property / GA4 Dimension | Description | Values |
|---|---|---|
| pugpigError / KGError | Details the reason for the failure | e.g. PermanentError |
Scope: GLOBAL
Dimensions / Properties
Dimensions describe details about the event or the user who performed the event. They are the attributes of your data. In the table below is a list of all of our productised dimensions that we track out-of-the-box.
In Firebase and Google Analytics the dimension names below are prefixed with KG e.g. KGPageName. In all other providers the prefix is pugpig e.g. pugpigPageName.
Note that dimensions follow camel case, i.e. spaces are removed
| Name | Scope | Dimension scope | Description | Possible values |
|---|---|---|---|---|
Custom dimensions
If our out-of-the-box analytics tracking doesn't cover every user or event attribute you would like to monitor in your analytics provider, you can send addition custom analytics dimensions / properties too.
To send content-related custom dimensions, for example publish date or article tags, you'll need to ensure that the all dimensions you wish to track are included in your RSS feeds.
If you would like to send customer user attributes, for example more granular subscription information or a user ID, you need to include the information in your auth response. Our DUTA model details how data should be sent in the auth response.
Note: there are a number of property names that are reserved by Firebase / GA4 that cannot be used for custom dimensions. This list can be found in this Google doc.
Screens
Bolt fires a screen view event every time a user views a page within the app. Below is a list of the most common screens that our customers use to understand how users are engaging with the app. These are attributes within the Page title and screen name dimension on GA4 and pugpigScreenName property in Mixpanel.
| Name | Scope | Screen | Aggregate | Description |
| Audio Player | Global | /AudioPlayer | No | Views of the Audio Player queue UI |
| Collection | Collection | /t/ | Yes |
Format: /t/<timeline_id> Tracked when a user views a collection |
| Collection Article View | Page | /Timeline/ArticleView/ | Yes |
Format: /Timeline/ArticleView/<timeline_id>/<article_id> Tracked when a user opens an article from any collection |
| Custom Webview | Global | /Custom/ | Yes |
Format: /Custom/<name> Tracked when a user clicks through to a custom webview |
| DeepLink Article View | Page | /Deeplink/ArticleView/ | Yes |
Format: /Deeplink/ArticleView/unknown/<article_id> Tracked when a user opens an article from a Deep Link |
| Dynamic Timelines | Collection | /t/Dynamic/ | Yes |
Format: /t/Dynamic/<feed id> Tracked when a user views a dynamic timeline |
| Launcher Screen | Page | /Launcher | No | Tracked when the launcher screen is viewed to assist with deep links into the correct place |
| Onboarding Screen | Global | /Onboarding/<name> | No | Tracked when an Onboarding screen is displayed |
| Saved Article View | Page | /SavedTimeline/ArticleView/ | Yes |
Format: /SavedTimeline/ArticleView/<timeline_id>/<article_id> Tracked when a user opens an article from the saved timeline |
| Saved Timeline | Collection | /t/SavedTimeline | No | Tracked when a user enters the saved timeline |
| Search | Global | /Search | No | Tracks when a user view the search results screen |
| Settings Edit Timelines | Global | /Settings/EditTimelines | No | Tracked when the user goes to edit their timelines |
| Settings Home | Global | /Settings | No | Tracked when the user goes to settings |
| Settings Pages | Global | /Settings/General | No |
Format: /Settings/<key> Tracked when any page in the settings is viewed. The <key> value sent is the localised name shown in the menu so will differ by locales for now |
| Sign In Page | Global | /Account/SignIn | No | Tracked when the user views the sign in page |
| Storefront | Global | /t/ | Yes |
Format: /t/<tab name>/ OR /t/<tab name>/<filter group> Tracked when a user views a storefront, or a filter within that storefront |
| Store Subscribe | Global | /Account/Subscribe | No | Tracked when the user views the native store (iTunes/Google Play/etc) subscribe page |
| Voucher Code Page | Global | /VoucherCode | No | Tracked when the user views the voucher code page |
| Web Sign In Page | Global | /Account/WebSignIn | No | Tracked when the user views the web auth sign in page |