Magento 2 integration

Overview

Connecting your Magento 2 store view to Ortto allows you to access your customers' purchase, cart, order, and review data. This helps you create personalized messages throughout the customer journey and unlocks powerful data visualization and segmentation features.

Magento 2 prerequisites

To integrate Magento 2 with Ortto, you need an active Magento store with a store view and a Magento 2 access token. The integration must be initiated from Magento 2 by:

1. Creating a Magento 2 access token.
2. Connecting to Ortto from Magento 2.

Create your Magento 2 access token

In your Magento 2 account:

1. Go to System > Integrations.
2. Click Add New Integration.
3. In the setup, enter the name, email address, and your Magento 2 account password.
4. Under API, select Custom for Resource Access. Scroll down and check the Ortto box.
5. Click Save.

You’ll return to the Integrations page and see your Ortto integration. Click Activate next to your Ortto integration, then click Allow. Magento 2 will display your API credentials.

Connect to Ortto from Magento 2

1. In your Magento 2 account, go to Stores > Configuration.
2. Under Scope, select the store view you want to integrate with Ortto and click Confirm. Ortto will appear in the left-hand panel.
3. Click Ortto to expand the section, then click General.
4. Expand Authentication, then set Enabled to Yes.
5. Click Get API credentials. A pop-up will ask you to select the Ortto account to connect with (you may need to log in to Ortto first).
6. On the Connect to Magento 2 page, enter the access token you created earlier (from step 7 in Create your Magento 2 Access Token).
7. Under Data Retention, choose either:
   • Store only the last 90 days of activity, or
   • Select a custom time frame and specify which activities to store.
8. If needed, click Advanced options to:
   • Choose which CDP fields can be modified by Magento 2, or
   • Choose not to modify existing CDP fields.
9. On the Merge page, select your preferred strategy for merging customer data into Ortto’s CDP.
10. On the Enable page, Ortto will provide an API key for the Magento 2 data source. Copy and save this key for the final steps.
11. Click Done to close the pop-up. Magento 2 is now connected to Ortto.
12. To complete the integration, return to your Magento 2 account.
13. In Authentication settings on the Stores Configuration page, enter the API key you copied from Ortto (step 10).
14. Click Save Config.

Your Ortto and Magento 2 integration is now complete!

Connect from Ortto

While you can access Magento 2 from Data sources  New data source, connecting Ortto to Magento 2 is only performed from your Magento 2 account by:

1. Creating a Magento 2 access token.
2. Connecting to Ortto from Magento 2.

How is the data merged into Ortto?

Data is first merged from Magento 2 to Ortto during the initial connection and then whenever an event occurs in Magento 2.

When a new person is synced from Magento 2 and doesn’t already exist in your CDP, they are added as a new contact. New contacts are automatically subscribed to email communications, but are unsubscribed from SMS by default.

If a contact already exists in Ortto, their email and SMS preferences will remain unchanged, as set in Magento 2.

Initial data sync

During the initial sync, customer details from Magento 2, including customer fields, cart, order, review, and product view data, are merged into Ortto. The merge follows the strategy chosen during the connection setup. This sync also creates activities for store events like orders, price drops, reviews, product views, and stock updates.

Ongoing data sync

Magento 2 data syncs to Ortto shortly after (usually within minutes) when events like cart and checkout activities occur.

Resynchronizing data

When the data source is reconnected, Magento 2 data is synced from the point of the last sync. For example, if the source was disconnected for 24 hours, updates and events during that time will be synced once reconnected. If data retention settings are changed (e.g., extending the retention period), all data will be re-synced.

A resync may impact audiences and campaigns in the CDP by resetting person attributes and activities, potentially causing someone to re-enter an audience or campaign.

What does the data source add to my account?

The Magento 2 data source adds:

• Customer records and associated fields (referred to as people or contacts in Ortto) to your CDP.
• Magento 2 activities from the last 90 days, including cart activity, orders, reviews, and product views. You can opt to store activity data for longer if needed (available on selected plans). Learn more about data retention.
• The ability to create new Magento 2 coupons.
• A tracking code for session tracking and capturing widgets on your Magento 2 site.
• The ability to personalize campaign messages using Liquid syntax with merge tags for Magento 2 customer fields and activity attributes.
  • Learn more about personalizing content with Liquid.

View Magento fields in your CDP

To customize which Magento 2 fields are visible in your CDP, click the cog icon and select or deselect the fields you want to show or hide. Magento 2 fields are marked with a small Magento 2 icon.

Access the Magento 2 data source view

Once a data source is connected, you can view it on the Data Sources page by clicking on the source you want to manage.

In the data source view, you can:

• Manage the data source in the left-hand details panel.
• View the following on the right-hand side:
  • Overview of the data source
  • Activity feed
  • Audience table (shows the customers imported from Magento 2)

In the details panel, you can:

• Rename the data source (this won’t affect your Magento 2 account settings). Hover over the name, click the pencil icon, enter the new name, and click anywhere outside the box to save.
• Disconnect the data source, adjust merge options, update the data retention period, and access the API key and tracking code.

Learn more about managing data sources.

Using Magento 2

Learn how to maximize your Magento 2 integration with Ortto's filters, reports, dashboards, campaigns, and coupons for better insights and results.

Troubleshooting Magento 2

Learn more about troubleshooting Magento 2.