This plugin adds Google Analytics tracking to your store. You can choose between a gtag and tag manager integration.
The gtag integration will output the traditional gtag() functions when tracking events, while the tag manager integration
will populate the dataLayer with event data.
This plugin uses the TagBagBundle to inject scripts onto your page. Please read and follow the installation instructions for that bundle before installing this plugin.
composer require setono/sylius-analytics-plugin:"^4.0@alpha"NOTICE that the v4 of this plugin is still in alpha and hence breaking changes can occur.
Then, enable the plugin by adding it to the list of registered plugins/bundles
in config/bundles.php file of your project before (!) SyliusGridBundle:
<?php
$bundles = [
Setono\SyliusAnalyticsPlugin\SetonoSyliusAnalyticsPlugin::class => ['all' => true],
Sylius\Bundle\GridBundle\SyliusGridBundle::class => ['all' => true],
];# config/packages/setono_sylius_analytics.yaml
imports:
- { resource: "@SetonoSyliusAnalyticsPlugin/Resources/config/app/config.yaml" }
setono_google_analytics:
gtag: ~
# If you want to use tag manager instead of gtag, just comment the line above and remove the comment below
# tag_manager: ~# config/routes/setono_sylius_analytics.yaml
setono_sylius_analytics:
resource: "@SetonoSyliusAnalyticsPlugin/Resources/config/routes.yaml"php bin/console doctrine:migrations:diff
php bin/console doctrine:migrations:migrateClick the Google Analytics link in your backend and create a new property/container.
Your Sylius store will start tracking now!
The events that are available are:
- add_payment_info
- add_shipping_info
- add_to_cart
- begin_checkout
- purchase
- view_cart
- view_item_list
- view_item
and can be found in the EventSubscriber folder.
Read on if you want to enrich events with more data.
When we want to track an event inside the Sylius application the Setono\GoogleAnalyticsBundle\Event\ClientSideEvent is fired.
That event holds the actual Google Analytics event, e.g. Setono\GoogleAnalyticsMeasurementProtocol\Request\Body\Event\PurchaseEvent.
This way, if you subscribe to the ClientSideEvent, you can manipulate everything about the event before it's rendered (and sent to Google).
But there are other ways to change the data enrichment. This can be done via resolvers. The plugin uses resolvers to resolve a brand from a product, a category from a product etc. Read on to figure out how to use this functionality.
An item has a brand property (item_brand), but the plugin doesn't know how you have chosen to
add brand data in your application. Therefore, you need to implement your own BrandResolver. Here is an example:
<?php
use Setono\SyliusAnalyticsPlugin\Resolver\Brand\BrandResolverInterface;
use Sylius\Component\Core\Model\ProductInterface;
use Sylius\Component\Core\Model\ProductVariantInterface;
final class BrandResolver implements BrandResolverInterface
{
public function resolveFromProduct(ProductInterface $product): ?string
{
return $product->getBrand(); // here we assume the getBrand() method will return a brand name or null (if not set)
}
public function resolveFromProductVariant(ProductVariantInterface $productVariant): ?string
{
return $this->resolveFromProduct($productVariant->getProduct());
}
}When you implement the BrandResolverInterface and register your class as a service it will automatically
be tagged with setono_sylius_analytics.brand_resolver and used when tracking.
An item has category properties (item_category, item_category2, etc.) and by default the plugin will resolve these
properties based on either a product's main taxon or (if no main taxon is set) the first taxon in the collection of taxons.
You can see the implementation inside the
Setono\SyliusAnalyticsPlugin\Resolver\Category\CategoryResolver class.
The job of the item resolver is to return an Setono\GoogleAnalyticsMeasurementProtocol\Request\Body\Event\Item\Item
either from an order item or a product. This resolver also has a default implementation which you can see in the class
Setono\SyliusAnalyticsPlugin\Resolver\Item\ItemResolver.
The items resolver must return an array of items given an order as input. The default implementation is found in the class
Setono\SyliusAnalyticsPlugin\Resolver\Items\ItemsResolver.
An item has a variant property (item_variant). How you want to view your variant data inside the Analytics
user interface is up to you, however, the plugin provides two default resolvers, namely the
Setono\SyliusAnalyticsPlugin\Resolver\Variant\NameBasedVariantResolver
and the Setono\SyliusAnalyticsPlugin\Resolver\Variant\OptionBasedVariantResolver.
The option based version has the highest priority of the two and will therefore be tried first. It tries to create a variant string based on the options on the variant (if any).
The name based version returns the \Sylius\Component\Product\Model\ProductVariantInterface::getName().
To implement your own resolver just implement the Setono\SyliusAnalyticsPlugin\Resolver\Variant\VariantResolverInterface.
Here is an example:
<?php
use Setono\SyliusAnalyticsPlugin\Resolver\Variant\VariantResolverInterface;
use Sylius\Component\Core\Model\ProductVariantInterface;
final class ProductNameBasedVariantResolver implements VariantResolverInterface
{
public function resolve(ProductVariantInterface $productVariant): ?string
{
return $productVariant->getProduct()->getName();
}
}When you implement the VariantResolverInterface and register your class as a service it will automatically
be tagged with setono_sylius_analytics.variant_resolver and used when tracking. Notice that the two existing
variant resolver will remain as fallbacks.
Ways you can contribute:
- Translate messages and validators into your mother tongue
- Create new event subscribers that handle Analytics events which are not implemented
Thank you!
![dependabot-preview[bot] avatar](https://avatars.githubusercontent.com/in/2141?v=4 "dependabot-preview[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent