Installation instructions
The Converge Website installation for a Magento store consists of:1
Create a new Client Source in Converge
- In Converge, click on Create a new source
- Pick Client-side from the modal
- Name your pixel: e.g.
{Storename} Storefront
2
Install the Magento Plugin
-
Add the Converge repository to your Magento 2 project’s
composer.jsonfile:bash -
Run the following command to install the Converge Magento 2 module:
bash
-
Enable the Converge module using the Magento CLI:
bash
-
Upgrade your Magento setup to ensure the Converge module is integrated properly:
bash
-
Deploy static content to your Magento store for the Converge module:
bash
3
Configure the Converge Magento Plugin with your public token
- In the Converge web app, click on the source you created in Step 1 and copy the Public Token. The code consists of 6 characters and can be retrieved from the HTML snippet. If your script
srclooks likehttps://static.runconverge.com/pixels/AYU51m.js, then your public token isAYU51m. - Go to
Stores>Settings>Configuration>Converge>Convergeand add the public token you just retrieved.
4
Verify that the integration is working correctly
- Check that the plugin is working correctly by generating some
$page_load,Added To Cart, andStarted Checkoutevents by visiting the store and seeing that these events arrive in the Source Log.
Set up a Pixel Monitor to automatically verify your pixel stays installed.
Event spec
This integration auto-tracks the following events on the browser with all properties available according to the Converge event spec.| Event Name | Event Description | Integration |
|---|---|---|
| PageView | When a customer views a page. | Storefront |
| Viewed Product | When a customer views a product. | Storefront |
| Added To Cart | When a customer adds an item to cart | Checkout |
| Started Checkout | When a customer initiates the checkout process. | Checkout |