ezoterik/yii2-google-tag-manager

Google Tag Manager extension for the Yii2 framework

2.1.1 2024-03-21 13:13 UTC

Requires

• yiisoft/yii2: ~2.0.13

Suggests

• yiisoft/yii2-coding-standards: you can use this package to check for code style issues when contributing to repository

MIT

• Oleg Balykin
• Carlos Malavé

• analytics
• extension
• google
• yii2
• tag manager
• Google Tag Manager

README

Integration Google Tag Manager in your application

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist ezoterik/yii2-google-tag-manager "*"

or add

"ezoterik/yii2-google-tag-manager": "*"

to the require section of your composer.json file.

Setup

Add this code in your @app/config/main.php config file with the other previous config:

'bootstrap' => ['googleTagManager'],
'components' => [
    'googleTagManager' => [
        'class' => 'ezoterik\googleTagManager\GoogleTagManager',
        'tagManagerId' => 'GOOGLE_TAG_MANAGER_ID', //Your Google Tag Manager ID without "GTM-" prefix
    ],
],

Usage

You can generate events:

Yii::$app->googleTagManager->dataLayerPushItemDelay('event', 'example_event');

Or push event as object:

Yii::$app->googleTagManager->dataLayerPushItem(null, (object)[
    'event' => 'view_item',
    'ecommerce' => (object)[
        'currency' => 'UAH',
        'value' => '500',
        'items' => [
            (object)[
                'item_name' => 'Product name',
                'item_id' => '12345',
                'price' => '500',
                'item_brand' => 'Analytics',
                'item_category' => 'Very Good Category',
                'item_category2' => 'Very Good Category 2',
                'item_category3' => 'Very Good Category 3',
                'item_category4' => 'Very Good Category 4',
                'item_variant' => 'full',
                'item_list_name' => 'sales',
                'item_list_id' => 'sales2022',
            ],
        ],
    ],
]);