Nutty Penguin Music


    1.0.1 • Public • Published

    Strapi Measurement Protocol

    Send data to Google Analytics with Measurement Protocol.

    Strapi Discord NPM Version Monthly download on NPM

    Table of Contents

    🚦 Current Status

    This package is currently under development and should be consider ALPHA in terms of state. I/We are currently accepting contributions and/or dedicated contributors to help develop and maintain this package.

    For more information on contributing please see the contrib message below.


    The Google Analytics Measurement Protocol for Google Analytics 4 allows developers to make HTTP requests to send events directly to Google Analytics servers. This allows developers to measure how users interact with their business from any HTTP-enabled environment. Notably, this makes it easy to measure interactions that happen server-to-server.


    🖐 Installation

    Add plugin dependency

    yarn add strapi-plugin-measurement-protocol

    Configure the plugin

    // file: config/plugins.js
    module.exports = ({ env }) => ({
      // ...
      "measurement-protocol": {
        config: {
          apiSecret: '',
          measurementId: '',
          useValidationServer: false,
      // ...
    • apiSecret - Required. An API SECRET generated in the Google Analytics UI. To create a new secret, navigate to:

    Admin > Data Streams > choose your stream > Measurement Protocol > Create

    • measurementId - Required. The measurement ID associated with a stream. Found in the Google Analytics UI under:

    Admin > Data Streams > choose your stream > Measurement ID

    🚚 Usage

    Full event list:

    Frontend usage

    gtag('event', 'add_payment_info');
    gtag('get', 'G-XXXXXXXXX', 'client_id', (clientId) => {
      fetch('', {
        method: 'POST',
        body: JSON.stringify({
          client_id: clientId, 
          events: [{name: "add_payment_info"}]

    The /api/measurement-protocol/collect endpoint will bind the client_id with the connected strapi user id more info:

    Backend usage

        // payload

    full event reference:


    I/We are actively looking for contributors, maintainers, and others to help shape this package. As this plugins sole purpose within the Strapi community is to be used by other developers and plugin maintainers to get fast responses time.

    If interested please feel free to email the lead maintainer Sacha at: or ping stf#3254 on Discord.


    See the LICENSE file for licensing information.


    npm i strapi-plugin-measurement-protocol

    DownloadsWeekly Downloads






    Unpacked Size

    9.75 kB

    Total Files


    Last publish


    • comfortablycoding
    • derrickmehaffy
    • eventyret
    • lith0x
    • boazpoolman
    • patrixr
    • stafyniaksacha