- 8 Minutes to read
- Print
- DarkLight
Adobe Commerce Setup for a Store with Multiple Store Views
- 8 Minutes to read
- Print
- DarkLight
Purpose
Use this setup if you have one website with multiple store views, for example. if your store is available in different languages.
Store views only offer a way to change what the website looks like. The core store settings, such as the product catalog, remain the same across all store views within one website.
They can be changed in the scope settings in the Adobe Commerce Admin Panel.
Procedure
Setup in Mapp Engage
A) Create Groups
You must create sets of three groups for each of your store views for the purpose of data synchronization. You will need them later during the plugin setup.
On Mapp Engage, navigate to the Audience section and click on Groups > Create New and three groups:
one for customers called, for example, "magento_customer"
one for subscribers called, for example, "magento_subscriber"
one for guests called, for example, "magento_guest"
Create additional customer, subscriber, and guest groups for each store view, giving the groups recognizable names. For example, for the Italian store view, use "magento_customer_IT", "magento_subscriber_IT", and "magento_guest_IT".
B) Prepare messages
You can create messages in Mapp Engage or use the default message provided by Adobe Commerce ( Adobe Commerce Admin Panel > Marketing > Email Templates ). The plugin supports sending email messages described on this page.
To create the message in Engage, follow these steps:
Go to the Message section in Mapp Engage and choose Prepared Message.
Click on Email > New Email .
Compose the emails you want to send, one set for each store view/language variant. You will need them at a later stage of the configuration.
Once these messages are created, you can select them in Adobe Commerce by going to Stores > Configuration > Mapp Cloud > Mapp Engage (Connect) - Emails. See step I2 below.
For more information, see Prepared Messages.
C) Create integration between Engage and Adobe Commerce
Go to Data Management > Mapp Connect.
Click Add New Integration.
Select the integration type "Magento" from the drop-down list.
Enter the name of the connection and click Create.
The Integration Settings tab opens to the Overview tab. You can still change the name of the integration here and add a description.
(optional) Check the box if you want a Whiteboard triggered when the contact's mapping attributes change.
Copy the secret key and save it for future reference. You will need it to authenticate the connection between Mapp Engage and your plugin.
Click Save.
D) Configure Mapping
A mapping is a list of imported data objects from Adobe Commerce. The default types of import for Adobe Commerce, as well as standard attributes, are already added.
Default Magento Mapping
Mapping
Mapping Type | Description |
---|---|
Web Push Mapping | Allows you to send a push notification (prepared message) to the contact using email as an identifier. This requires adding the mobile app ID in the API call. |
Product Mapping | Adds products from the Adobe Commerce product catalog to the product catalog in Mapp Engage. |
Coupon Mapping | Imports coupons from your Adobe Commerce store in bulk. |
Customer Mapping | Adds users to Mapp Engage. By clicking Edit, users can add more Adobe Commerce attributes as add-on attributes. For more information about attributes, see Attributes. |
Newsletter Mapping | Adds users to newsletter mapping. Not editable. |
Transaction Mapping | Allows to:
The Edit button allows to:
|
Email Mapping | Here are all the default parameters that can be used as email placeholders. Editing and adding new parameters is allowed (remember to use the same name in email placeholders with parameters). |
Abandoned Cart Mapping | Allows you to map source data with the default structure of the Abandoned Cart Related Data Table. |
Wish List Mapping | Allows you to map source data with the default structure of the Wishlist Related Data Table. |
Any custom mapping needs to be added to the configuration. This can be done via an import or manually:
Go to Data Management > Mapp Connect.
Open the Adobe Commerce integration of your choice.
Click the Mapping tab.
Import your mapping, or add it manually.
For more information, see Mapping.
Setup in Adobe Commerce
E) General Configuration
Log in to the Adobe Commerce Admin Panel and go to Store > Configuration > Mapp Cloud > Mapp Engage (Connect) General. By default, this page opens to Scope: Default Config.
Configure the Adobe Commerce general settings, such as choosing the environment or adding specific preferences.
Setting
Details
Module Enable
Here, you can activate and deactivate the Mapp Engage module.
Mapp Connect API URL
EU L3: https://jamie .g.shortest-route.com/charon/api/v1/
EU EMC: https://jamie .h.shortest-route.com/charon/api/v1/
US L3: https://jamie .a.shortest-route.com/charon/api/v1/
US EMC: https://jamie .c.shortest-route.com/charon/api/v1/
Specified: This option opens the Mapp Connect custom API URL input field.
For more information, see Mapp Engage Clusters and Time Zones.
Mapp Connect custom API URL
You must select Specified in the Mapp Connect API URL field for this field to appear.
Example configuration
F) Integration Configuration
Enable the integration by selecting "Yes" in the Integration Enable field.
Enter the Integration ID and Integration Secret.
Click on the Save button.
Click on the Save Config button to save the configuration.
Setting
Details
Integration Enable
You can activate and deactivate the integration between Mapp Engage and Adobe Commerce.
Integration ID
Both are generated in Mapp Connect. See point C4 above.
For more information, see Create an Integration.
Integration Secret
Connection Status
Displays the connection status with Mapp Connect
Example configuration
G) Export Connection Configuration
Configure synchronization for products, customers, transactions, and newsletters.
Adobe Commerce Setup for a Store with One Store View
Setting | Details |
---|---|
Synchronization method |
|
Enable Product Synchronization | Allows you to define your synchronization preferences for products. If enabled, the products created on the Adobe Commerce admin page will show in the product catalog in Mapp Engage.
|
Add Cached Product URLs to Sync |
|
Generate Resized Product Images during Sync | This option appears when you set Add Cached Product URLs to Sync to Yes. Enabling this option ensures that all cached images are present during the product synchronization process.
|
Enable Customer Synchronization | This setting enables you to specify your synchronization preferences for contacts. If enabled, Engage will mirror contacts created in Adobe Commerce.
|
Enable Sales Transaction Synchronization | This setting enables you to specify your synchronization preferences for transactions. If enabled, Engage will mirror transactions registered in Adobe Commerce.
|
Newsletter Synchronization | Allows you to define your synchronization preferences for newsletters. If enabled, contacts who sign up for a newsletter with their email address will be added to the defined Mapp Engage group. |
Newsletter double opt-in | Allows you to Enable or Disable double opt-in for the newsletter. For more information, see Set up Double Opt-in with the Email Channel. |
Max Newsletter Request Retry Count | This option appears when the Synchronization Method: DB Trigger is used. The DB Trigger method allows for requests to be sent multiple times in case of a failure (for example, connection issues). The default number of retries is 10, but you can uncheck the Use system value checkbox and enter a custom number. |
Use system value | If checked, the plugin will use the Adobe Commerce system value even if another option is selected from the drop-down. |
Example configuration
H) Mapp Engage Groups
Select the groups created in Mapp Engage. They are the default groups used in Scope: Default Config .
You must create these groups for the purpose of data synchronization in Mapp Engage. The groups will only appear if the plugin is set up correctly and the connection is active.
Example configuration
Click the Save Config button to save the configuration.
To adjust the groups for other store views, change the Scope at the top of the page and select the required group.
You must only adjust the Customer Group. the Subscribers and Guests Groups remain the same in all store view setups.
Click the Save Config button to save the configuration.
I) Configure messagess
In the Adobe Commerce Admin account, go to Stores > Configuration > Mapp Cloud > Mapp Engage (Connect) - Emails.
For each transactional email, select the prepared messages you created in Engage (step B above) or check the Use system value checkbox if you want to use the Adobe Commerce email. See Transactional Emails for more information.