@financial-times/n-tracking
Advanced tools
This package provides client-side tracking initialisation for FT.com. On the client-side it configures o-tracking (which is used to capture and send tracking events to Spoor) and can be used on the server-side to embed fallback tracking pixels.
This package is for client-side and server-side use and is distributed on npm.
npm install -S @financial-times/n-tracking
After installing the package you can import the tracking component into your code:
On the client-side this package can be used to configure o-tracking, setup click tracking, and send a page view event.
import * as tracking from '@financial-times/n-tracking';
const oTracking = tracking.init(options);
To initialise the component you'll need to provide it with several configuration options.
On the server-side a JSX component embeds tracking pixels into the page which send page view events for any visitors which do not support JS or fail to cut the mustard.
const { CoreTracking } = require('@financial-times/n-tracking');
<CoreTracking options={options} />
To initialise the component you'll need to provide it with several configuration options.
init(options)Configures o-tracking with the given options, triggers a page view event, initialises click tracking, and returns the instance of o-tracking.
broadcast(name, data)Creates a CustomEvent with the given name and data and dispatches it from the document <body> element. It is intended to be used to trigger oTracking.event events.
trackers.customTrackerName()TODO: custom tracking events to be used across FT.com
<CoreTracking options={} />Renders a <noscript> and inline <script> element to embed fallback tracking pixels into the page which are used when the client-side JS fails to run. It accepts the same options as the client-side code.
| Property | Type | Required | Description |
|---|---|---|---|
appContext | Object | Yes | FT.com App Context data describing the current page which will be appended to all captured events. |
extraContext | Object | No | Additional data describing the current page which will be appended to all captured events. |
pageViewContext | Object | No | Additional data to append to the page view event only |
FAQs
Client-side tracking initialisation for FT.com apps
The npm package @financial-times/n-tracking receives a total of 415 weekly downloads. As such, @financial-times/n-tracking popularity was classified as not popular.
We found that @financial-times/n-tracking demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 10 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket researchers uncover a malicious npm package posing as a tool for detecting vulnerabilities in Etherium smart contracts.
Security News
Research
A supply chain attack on Rspack's npm packages injected cryptomining malware, potentially impacting thousands of developers.
Research
Security News
Socket researchers discovered a malware campaign on npm delivering the Skuld infostealer via typosquatted packages, exposing sensitive data.