How to install DC Merchant Centre Plugin

This documentation supports V1.0 and V1.1

Setting up accounts

Google Developer Console

The Google Developer Console is used to create an OAuth key to securely link your website and your Google Merchant Centre together, allowing your website to submit data to your Merchant Centre.

Follow the steps with the images below:

Step 1

Navigate to https://console.developers.google.com/ and sign up with an account. You will be greeted with a dashboard type page

Google Merchant Center

These steps only need to be followed if you haven't yet created a Google Merchant Account.

Navigate to https://merchants.google.com/

Sign in with the same account that you used to sign up to the developer account.

Follow the steps on the images below

Step 1

Once you have logged in, there will be a number in the top right corner of the screen. You will need to write this down.

Installing the DC Merchant Centre Plugin

Upload the plugin to the /plugins folder in your nopCommerce directory.

Restart your application (or click 'Reload list of plugins' button).

Scroll down through the list of plugins to find the newly installed plugin.

Click on the 'Install' link to install the plugin.

Note: If you're running nopCommerce in medium trust, then it's recommended to clear your \Plugins\bin\ directory

 

Configuring the DC Merchant Centre Plugin

Firstly you will need to do some code changes in the Web.Config. Only a small change.

You only need to do this change for nopCommerce versions 3.6 and below

In the Web.Config find where the dependant assemblies are written.

There will be an assembly called Newtonsoft.Json.

Replace that with the following code:

<dependentAssembly>
   <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
   <bindingRedirect oldVersion="0.0.0.0-7.0.0.0" newVersion="6.0.0.0" />
</dependentAssembly>

Save the file.

Our plugin requires a higher version of Newtonsoft.Json but nopCommerce, 3.6 and below, uses v6. This peice of code gives us v6 but fakes it as being v7, allowing our plugin to run.

Go to the backend of the website and navigate to the plugins list.

Click the configure button on the plugin.

Follow the steps on the images below

Step 1

You will come to the configuration page. Your Merchant ID is the number you got from Google Merchant. Client ID is the ID you received from Google Developer Console. Client Secret is the ID you also got from Google Developer Console. Fill these in and click the request access button.

How to use the DC Merchant Centre Plugin

Categories

Configuring the Category level is reccomended to enable the Merchant Center to categorize your products.

Categories for a product can be set at a category level as well as product level.

To set a category at category level, navigate to Catalog > Categories > List and select a category.

Then navigate to the Google Shopping Category tab.

Here you can set the category of the product categories.

Products

Categories can also be set on products. This will overwrite its parent category for this product.

To set a category at product level, navigate to Catalog > Products > Manage Products and edit a product.

Then navigate to the Google Shopping Category tab.

Here you can set the category of the product.

Required Fields

For a product to successfully upload to Google Merchant Center, you need the following fields to be set per product:

  • Title
  • Description
  • Price
  • GTIN
  • MPN

You may run into issues if any of these are not set, you can view the system log to find out which fields are missing from a product.

Scheduled Task

A scheduled task will run every 5 minutes that will upload any products that have changed to the google merchant center.

It will also check to see if any products have been changed since it last uploaded and reupload them if they have changed.

The Scheduled Task will also upload products that have not changed in 20 days to prevent Google from removing valid products from the Merchant Center.

Google Merchant Center

When using the Google Merchant Center shipping charges should be defined in Google Merchant Center. This is so that Google can compare shipping prices between products.

Follow the steps on the images below

Step 1

Shipping settings are country specific, so there needs to be shipping settings for each country you ship to.

FAQ

Common Error Messages

This error message is usually due to non-matching URL's, The website url must be the same as what you set in the Merchant Center

 

You can read more here : https://support.google.com/merchants/answer/160050?hl=en

This error is shown when shipping settings are not set in the Merchant Center.

They can be set here : https://merchants.google.com/Home?a=109531656#shippingsettings.services.GB

You can read more here : https://support.google.com/merchants/answer/6069284?hl=en

This error usually happens when the country you are shipping to does not have any shipping settings in the Merchant Center

You can read more here : https://support.google.com/merchants/answer/188494?hl=en

This error usually happens when the currency that is submitted isn't the same as what is on your website.

You can read more here : https://support.google.com/merchants/answer/188494?hl=en

Scroll to top