setono/google-analytics-events

A library that eases the generation of Google Analytics events

v1.0.0-rc 2023-09-12 09:23 UTC

Requires

• php: >=7.4
• ext-json: *

Requires (Dev)

• infection/infection: ^0.26
• nyholm/psr7: ^1.5
• phpspec/prophecy-phpunit: ^2.0
• phpunit/phpunit: ^9.5
• psalm/plugin-phpunit: ^0.18
• setono/code-quality-pack: ^2.4

MIT

• Joachim Løvgaard

README

Easily build Google Analytics 4 Events.

Installation

composer require setono/google-analytics-events

Usage

use Setono\GoogleAnalyticsEvents\Event\PurchaseEvent;
use Setono\GoogleAnalyticsEvents\Writer\GtagWriter;

$event = PurchaseEvent::create('TRANS_1234')
    ->setCurrency('USD')
    ->setValue(123.45)
    ->setTax(10.45)
    ->setShipping(3.32)
    ->addItem(Item::create()->setId('SKU1234')->setName('Blue t-shirt'))
;

$writer = new GtagWriter();
echo $writer->write($event); // output: gtag("event", "purchase", {"currency":"USD","transaction_id":"TRANS_1234","value":123.45,"shipping":3.32,"tax":10.45,"items":[{"item_id":"SKU1234","item_name":"Blue t-shirt","quantity":1}]});

References

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