3d – SmartContent – Shopware 6 (EN)

1. Introduction

SmartContent is a dynamic content feature from Maileon that allows you to automatically or manually integrate content from external sources (including RSS feeds, CMS systems, or shop systems) into your email campaigns. After a few simple settings, placeholders in the emailing template are automatically filled with content from external data, such as articles, images, texts, or product information.

Maileon includes several SmartContent functions for different source types such as RSS feeds, WordPress, YouTube, Magento, Shopware, or Typo3. These are activated in the user roles as view/usage rights. Please find further details about it at the Help Center.

This documentation describes how to insert the Shopware6 webshop into the Maileon emailing editor within your account.

2. Connecting Your Maileon Account and Shopware 6 Webshop

Note: A certain level of knowledge of the webshop is essential to start the process. The documentation on connecting your account and Shopware6 webshop in the Maileon Help Center provides detailed instructions for this process.

To retrieve your articles from Shopware, we need the access key from the sales channel you want to use. In Shopware, this key is stored in the sales channel settings under API access. Shopware also notes that each sales channel has its own access key.

When configuring the shop connections, you need to configure:

• the access key of the correct sales channel
• the ID of the language that shall be used

If you have several sales channels, it is important to choose the right one, because the key belongs to that specific sales channel.

 

2.1. Accessing Shopware 6 Data via API for Content Integration

To integrate Shopware6 content, you first need the API to access data from your Shopware administration.

Where to find the key in Shopware:

• Step 1: Log in to Shopware – Open your Shopware administration and sign in with your usual access data.
• Step 2: Open the sales channels – In the menu, click Sales Channels (fig. 1).

• Step 3: Select the correct sales channel – Choose the shop or storefront whose articles should be connected to Maileon. Note: If you don’t have a sales channel yet, you can create one here by clicking Add Sales Channel (fig. 2).

• Step 4: Copy the API access key – Click on the sales channel you want to use and scroll down to API access.
• In Shopware, this section allows you to view or generate the access key for the sales channel (please refer to the Shopware documentation for further information) (fig. 3).

Note: Do not create a backend integration for this purpose anymore. For retrieving articles or product data from the shop, Shopware points to the access key from the sales channel. If you generate a new key, the previously used key will no longer work.

3. Insert SmartContent Placeholders In The Editor

The process for embedding SmartContent into an emailing is always similar and involves just a few steps.

Note: This instruction supports you to link to webshops in CMS2 and save it in your favorites.

Go to Campaings → Newsletters and open or create a certain emailing you would like to pull articles from the webshop. SmartContent functions are shown in the menu or as a plugin in the editor (fig. 4).

Select or create an article, then prepare and structure the content for your mailing.

Insert SmartContent placeholders (e.g., title, text, image) by clicking on Insert placeholder icon (fig. 5).

Select the Shopware placeholders that will contain the main data of the product, such as Name, Description, Price, Image, etc. Numerous possibilities are available (fig. 6).

The parameterised placeholders will appear in the text box. These placeholders can be linked to external content by clicking on the Shopware SmartContent icon (fig. 7). An easy-to-follow, multi-step process appears, starting with a basic setup.

Here are a few examples of parameterized placeholder articles to be filled in (fig. 8, fig. 9):

Select a source by choosing an existing content block in the emailing or by dragging and dropping one of the available templates from the options (fig. 10). Click Next.

Setup the connection by selecting a ‘favourite’ webshop or configure it by adding the relevant data (fig. 11). In the case of webshops, the required basic data are the

• Version,
• Base URI,
• Access key,
• Locale (For a detailed explanation please see below)

Note: Values marked with an asterisk are mandatory.

The Version field should always contain the version number of the webshop you are using, e.g. Shopware6.

The Base URI field must contain the official (frontend) website of the webshop.

Verify the Access key and the Locale ID in the webshop’s Settings -> System -> Integrations (fig. 12).

Click on the relevant integration to view the Access Key ID, which corresponds to the Access key in the editor interface (fig. 13). Click Create new API key.

To complete the integration, click Save integration in the pop-up window, which contains the Access Key ID and Secret access key (fig. 14).

Note: Access key ID and Secret access key are only activate after saving the integration. After saving the integration, the key will no longer be visible, due to safety concerns.

Copy the Access Key ID into the appropriate field in the email editor (fig. 15).

 

To set Locale, return to Settings → Languages in the webshop (fig. 16). Click Languages.

Select and click the language you want to use from the list (fig. 17).

Copy the final segment of the URL of the chosen language (fig. 18). This sequence of letters and numbers defines the Locale code.

Paste the code into the appropriate field in the email editor (fig. 19).

At this step, you have the option to save the information by clicking Save to favorites (fig. 20).

 

Enter the name of the webshop in the window that appears and click Save to add it to your favorites (fig. 21).

 

After entering the data, click Next.

Select the product’s IDs/SKUs that you can retrieve from the webshop’s Catalogue -> Products section (fig. 22). The Product number in the webshop corresponds to the product IDs/SKUs in the editor interface.

Insert the appropriate product IDs/SKUs into the editing interface (fig. 23).

Note: Separate product IDs using commas only (no spaces).

Click Next.

As a final step, click on Preview and apply, which will display the selected webshop content in the article. Select the product or products you would like to display in the emailing and click Apply (fig. 24).

Save the process and review the emailing in Preview mode at the end of editing (fig. 25).

Requirements & Permissions

To use SmartContent options in Maileon, the corresponding permission must be activated in XACT (e.g., “RSS SmartContent,” “Magento SmartContent,” etc.).
The user role settings in the admin area determine whether a user can see and use these feature options.

In case of questions regarding SmartContents, please contact us at support@xqueue.com.