The Magento 2 Integration enables you to automatically sync Magento 2 data, execute personalised e-commerce marketing campaigns and analyse them.
This guide demonstrates how to integrate and successfully gather data from Magento.
As a first step of the integration, the Xtremepush extension needs to be installed in Magento 2.
Technical support required
The Xtremepush extension can be installed via composer. It requires IT Support with SSH access to the server where Magento 2 hosted.
In order to install the Xtremepush extension, four main steps need to be taken:
Log in to your Magento 2 server and navigate to the root directory of your Magento app from your command line tool. This guide shows example outputs for Terminal, but these steps can be modified for any command line tool of your choice.
The module is installed via Composer. First make sure that your existing dependencies are up-to-date:
- Then run this command to add the Xtremepush module to your Magento environment:
composer require xtremepush/magento2-plugin
- After the update, you should perform code regeneration and restart the services:
sudo php -d memory_limit=-1 bin/magento setup:upgrade sudo php -d memory_limit=-1 bin/magento setup:di:compile sudo php -d memory_limit=-1 bin/magento setup:static-content:deploy -f
After deploying the static content, restart the services.
Log in to your Magento account and navigate to System > Integrations > Add New Integration.
Fill in the integration details by entering a descriptive name and password , then navigate to API (under Basic Settings) to assign the relevant level permissions.
You will need to grant the following user permissions:
- System > System Extensions > System Integrations
- Marketing > Communications > Newsletter Subscribers
- Sales > Operations > Orders > Actions > View
Click on Save after setting the permissions. At this stage, Magento will generate your Access Token that you will need to use in the Xtremepush platform in order to complete your integration. You can find it under Integration details.
Once you complete the steps above in Magento 2, open a new tab in your browser and log in to your Xtremepush account. Navigate to Integrations > Marketplace, select the Magento card in the Integrations Marketplace tab and click Connect.
Fill in the Connection and Data Mapping sections to complete the integration.
In this page, you need to enter basic settings and connection details.
Give your connection a Name that helps you easily identify it.
- Access Token: Found in Magento by navigating to System > Integrations > Xtremepush integration in a section called Access Token.
- Shop URL: Such as
After completing the connection details, click the Fetch Magento Attributes button. It will automatically bring a data mapping section for attributes once the integration credentials get confirmed.
This section lists your automatically mapped system attributes. It allows you to select which standard attribute you want to import. You can also map your Magento custom attributes to your custom attributes in Xtremepush.
Xtremepush's system attributes such as
You can set Magento's standard attributes to Import or Don't Import under the Map to fields. If you select Import, these will be automatically created in Xtremepush.
Finally, you will also see Magento's custom attributes (listed in the Column fields) such as
default_shipping. You can map these attributes to your predefined Xtremepush custom attributes.
System attributes and standard attributes are automatically created on Xtremepush. However, in order to map custom attributes you need to create these attributes on the Xtremepush first. Review our Attributes & tags guide to see how to do so.
Email subscription data
In order to gather email subscription data, you need to map Magento's
is_subscribedattribute to Xtremepush's
Once you've completed the data mapping, click Connect to complete the integration.
Once you complete the steps above in Xtremepush, from your Magento dashboard, navigate to Xtremepush > Settings > General, check your integration settings and then enable the integration.
After successfully enabling your integration, navigate to General > Webhooks and enable webhooks to fetch realtime events from Magento into Xtremepush. You can enable checkout (quotes), customer, and order related events. When you enable a webhook, you will be able to use its events in your campaigns as they will be automatically created as a custom events on the Xtremepush platform when that event is triggered from Magento.
Events will use their naming from Magento 2. For example;
customer/customer/registeredetc. You can check available event naming from this page.
Once you have selected the required webhooks, click Save Config. Once the connections are made and confirmed, your Magento integration will be listed under the Configured Integrations tab within the Marketplace and you are presented with the Integration Details page.
Finally, in order to start the synchronisation, click the Actions drop-down menu and select Sync. Your options will be Full sync, Sync profiles and Sync purchases. A full sync includes synchronisation of users (which will be created in Xtremepush) and purchase data. Once complete, each profile attribute is displayed along with a timestamp and status of Completed. If there is any other status, click the More menu and choose Details for extended information.
Purchase data synchronization
Once you synchronise purchase data, you do not need to sync this data again. The system automatically updates purchase data based on received order details from real-time events.
Navigate to Settings > Integrations > Marketplace > Configured integrations and click on Magento to review the integration details (Overview). The Information section shows the token and endpoint. This information is automatically passed to Magento but also can be confirmed from this page for security headlines. The Sync History section provides an overview of the sync history with Magento.
Select the integration you want to update at Settings > Integrations > Marketplace > Configured Integrations. Go to the Settings tab and update any necessary setting, click Save to confirm. If you need to delete or deactivate the connection, click on the Actions button. You will be presented with the option to either Deactivate or Delete the integration. Clicking either of them opens a confirmation dialog.
Updated 7 months ago