Security News
Maven Central Adds Sigstore Signature Validation
Maven Central now validates Sigstore signatures, making it easier for developers to verify the provenance of Java packages.
gatsby-plugin-amplitude-analytics
Advanced tools
Plugin to add Amplitude analytics to a Gatsby site
Easily add Amplitude Analytics to your Gatsby site. Automatically tracks page views and outbound link clicks.
yarn add gatsby-plugin-amplitude-analytics
or
npm install --save gatsby-plugin-amplitude-analytics
// In your gatsby-config.js
module.exports = {
plugins: [
{
resolve: `gatsby-plugin-amplitude-analytics`,
options: {
// Specify the API key for your Amplitude Project (required)
apiKey: "YOUR_AMPLITUDE_ANALYTICS_API_KEY",
// Puts tracking script in the head instead of the body (optional)
head: false,
// Prevents loading Amplitude and logging events if visitors have "Do Not Track" enabled (optional)
respectDNT: true,
// Avoids sending pageview hits from custom paths (optional)
exclude: ["/preview/**", "/do-not-track/me/too/"],
// Override the default event types (optional)
eventTypes: {
outboundLinkClick: 'OUTBOUND_LINK_CLICK',
pageView: 'PAGE_VIEW',
},
// Amplitude JS SDK configuration options (optional)
amplitudeConfig: {
saveEvents: true,
includeUtm: true,
includeReferrer: true
},
// Specify NODE_ENVs in which the plugin should be loaded (optional)
environments: ["production"],
},
},
],
}
<OutboundLink>
componentTo make it easy to track clicks on outbound links in Amplitude Analytics, the plugin provides a component.
To use it, simply import it and use it like you would the <a>
element. For example:
import React;
import { OutboundLink } from 'gatsby-plugin-amplitude-analytics';
export default () => {
<div>
<OutboundLink
href="https://www.gatsbyjs.org/packages/gatsby-plugin-amplitude-analytics/"
>
Visit the Amplitude Analytics plugin page!
</OutboundLink>
</div>
};
If you enable this optional option, Amplitude Analytics will not be loaded at all for visitors that have "Do Not Track" enabled. While using Amplitude Analytics does not necessarily constitute Tracking, you might still want to do this to cater to more privacy oriented users.
If you need to exclude any path from the tracking system, you can add it (one or more) to this optional array as glob expressions.
To override the default event types that are used for page event and outbound link clicks, include this option. The value should be a map with two keys: "outboundLinkClick", and "pageView". For example:
The default values for these events are "outbound link click" and "page view".
Configuration settings passed to the amplitude.getInstance().init()
call. This option allows you to enable automatic collection of UTM params and referrer info and change persistence and upload behavior. See https://developers.amplitude.com/#platform-specific-settings for a full list of available options.
3.2.0
FAQs
Plugin to add Amplitude analytics to a Gatsby site
The npm package gatsby-plugin-amplitude-analytics receives a total of 2,044 weekly downloads. As such, gatsby-plugin-amplitude-analytics popularity was classified as popular.
We found that gatsby-plugin-amplitude-analytics demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer 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.
Security News
Maven Central now validates Sigstore signatures, making it easier for developers to verify the provenance of Java packages.
Security News
CISOs are racing to adopt AI for cybersecurity, but hurdles in budgets and governance may leave some falling behind in the fight against cyber threats.
Research
Security News
Socket researchers uncovered a backdoored typosquat of BoltDB in the Go ecosystem, exploiting Go Module Proxy caching to persist undetected for years.