Adobe Commerce (Magento 2): Set up and map products between platforms

This article is for Marketplacer customers who use Adobe Commerce (Magento) as their e-commerce platform. If you are a seller who uses Adobe Magento to provide products to Marketplacer customers, see Adobe Commerce (Magento 2) for Sellers.

After you connected Adobe Commerce and Marketplacer, you must set up and map products so that the data sync works properly. We recommend you work with Marketplacer to help with this process. 

Why mapping?

Marketplacer and Adobe Commerce use different terms to refer to the same entities. In particular, categories in Adobe Commerce are known as taxons in Marketplacer and need to be mapped so the data sync works correctly. 

Example product

Practice using the following example for a cotton tee shirt, where the definition in Marketplacer is:

• 1 Variant - Black / Small
• 1 Variant - Black / Medium
• Prototype - Clothing
• Taxon - Tees

To create this product in Adobe Commerce, you must map it as follows.

With all these mapped, the product can be created in Adobe Commerce.

Mapping entities

It is helpful to do ID mapping in a spreadsheet, to clearly show the required mappings.

The Marketplacer team will assist with manually mapping the Adobe Commerce category ID to the Marketplacer Taxon ID. Once mapped, these entities are linked.

For mapping to work, Marketplacer needs established prototypes, taxons, optiontypes and optionvalues.

Example code for creating a VerticalLevelMapping

option_value_entity = MarketplacerEntity.find_or_create_by!(

vertical: vertical,

source_type: "OptionValue",

source_id: "T3B0aW9uVmFsdWUtMg=="

 )
 Magento2Connector::PlatformLevelMapping.find_or_create_by!(

vertical: vertical,

entity_type: "Option",

name: "Green",

magento_id: "53",

marketplacer_entity: option_value_entity

 )

Proceed to the next steps in this article.