setono/google-analytics-measurement-protocol

A library that eases the generation of measurement protocol payloads

v2.0.0-beta.2 2023-09-12 09:27 UTC

Requires

• php: >=7.4
• ext-json: *
• php-http/discovery: ^1.18
• psr/http-client: ^1.0
• psr/http-client-implementation: ^1
• psr/http-factory: ^1.0
• psr/http-factory-implementation: ^1
• psr/http-message: ^1.0 || ^2.0
• psr/log: ^1.0 || ^2.0 || ^3.0
• setono/google-analytics-events: ^1.0@rc
• symfony/polyfill-php80: ^1.27

Requires (Dev)

• infection/infection: ^0.26
• nyholm/psr7: ^1.8
• phpspec/prophecy-phpunit: ^2.0
• phpunit/phpunit: ^9.6
• psalm/plugin-phpunit: ^0.18
• setono/code-quality-pack: ^2.4
• symfony/http-client: ^5.4 || ^6.0

MIT

• Joachim Løvgaard

README

Easily build payloads for the Google Analytics measurement protocol.

Installation

composer require setono/google-analytics-measurement-protocol

Usage

<?php

require_once '../vendor/autoload.php';

use Setono\GoogleAnalyticsEvents\Event\AddToCartEvent;
use Setono\GoogleAnalyticsEvents\Event\Item\Item;
use Setono\GoogleAnalyticsMeasurementProtocol\Client\Client;
use Setono\GoogleAnalyticsMeasurementProtocol\Request\Body;
use Setono\GoogleAnalyticsMeasurementProtocol\Request\Request;

$client = new Client();
$request = (new Request(
    'YOUR_SECRET',
    'G-12341234',
    'CLIENT_ID'
))
    ->addEvent(
        AddToCartEvent::create()
            ->setCurrency('USD')
            ->setValue(123.45)
            ->addItem(Item::create()->setId('SKU1234')->setName('Blue t-shirt')),
    )
    ->setTimestamp(1668509674013800)
;

$client->sendRequest($request);

References

• https://developers.google.com/analytics/devguides/collection/protocol/ga4
• https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events
• https://support.google.com/analytics/answer/9234069
• https://support.google.com/analytics/answer/9216061