Save considerable time with Buy on Google by managing all your Google orders directly from your Magento back office.
Handle all Google orders from your Magento back office
All in one place — No need to switch from Magento to Google Merchant, manage all your orders in the same place.
Stocks — Automatically maintain the inventory of all your products.
Test orders — Create Google test orders from your Magento back-end.
Shipments — Send the shipments from your Magento back-end and automatically sync Google Merchant.
Connect Magento to Buy on Google with ease:
1. — Add your merchant ID
2. — Enter the secret key file
3. — You are done!
Import all your Google orders into Magento 2 in a breath
Orders import — Import your orders manually, by cron, or using the CLI.
Bulk import — Quickly import all new orders in bulk from your back-office.
Notification — Be notified in real-time when importing your orders.
Content
The Buy on Google program
In order to use the Buy on Google extension, you should be aware of some basic knowledge about Google Shopping and data feed management.
What is Buy on Google?
Buy on Google allows merchants to display and sell their products on all Google platforms, offering a fast and secure user experience. The program makes it very easy for customers to place an order thanks to:
In order to submit your products to Google Shopping, you need to create a Google Merchant Account. Click on the following link for further information on creating an account: https://support.google.com/merchants/answer/188924?hl=en
Once account is created, you'll have access to the Google Merchant interface. There you can manage all your product data feeds and plan any daily, weekly, or monthly updating tasks.
How to use the Buy on Google extension?
Configure Buy on Google
You can configure Google Shopping Actions in a general way from: Stores › Settings › Configuration › Wyomind › Buy on Google
Google Shopping API Settings
It is important to configure the following section to connect your Magento to your Google Shopping account.
Google API (Json key) Merchant Center can create a Google API key for you. Check the documentation of Google to know how to get your JSON key.
Verify the connection You can check the connection between your Magento back-office and Google Merchant. For that, click on Save config. and then click on Verify the connection. A pop-up will open and notify that the connection succeeded.
Sandbox mode The sandbox mode can be enabled on your staging domain to test your workflow and to make sure everything works as expected.
Test orders settings
When the Sandbox mode is enabled, you have the possibility to create test orders. The below settings are made to simulate real orders.
Minimum transit time
Maximum transit time
The ship by date Here select or fill in the ship by date in ISO 8601 format as below:
2020-02-19
The delivery by date Here select or fill in the ship by date in ISO 8601 format as below:
2020-02-23
How many days later the item can be returned
15
Product attribute for the brand name Map this attribute to your attribute for the brand.
Product attribute for the MPN Map this attribute to your attribute for the MPN.
Product attribute for the GTIN Map this attribute to your attribute for the GTIN.
Product condition Define the condition for the products.
Order import settings
The extension allows you to import all your previous Google Merchant Center orders into Magento.
Import all orders in bulk You can enable the bulk import. In that case, you will need to confirm if you want to import all the orders of your Google account from: Sales › Orders
Batch size Define the number of imported orders when running the import manually.
10
Customer group You have the possibility to choose to which customer group the imported customers will be assigned.
Google Shopping
Order Status Mapping
In order to meet Google Shopping requirements, you need to map your order status to Google ones:
In Progress
Pending Shipment
Partially Shipped
Shipped
Delivered
Partially Delivered
Canceled
Returned
US Orders
You can associate a store view and a source to the orders made from the US.
Store view Choose the store view to which the US orders will be associated. The store view must use the USD currency.
Stock Source The orders will be deducted from the source
Additional tools
The Buy on Google extension allows you to import orders manually from Google Merchant Center into your Magento back-office.
Add the Google Shopping Order Id in the Import one order from Google Merchant Center field and click on Import now.
If you are importing several orders, the Google Shopping order Ids must be separated with commas.
Cron job reporting
You have the possibility to enable cron job reporting. When enabled, an email will be sent when new orders are imported or if any error arises.
Email settings
You can configure the following email settings:
Sender Email The email of the sender
Sender Name The name of the sender
Send the report to The email(s) to which you want the report to be sent. Note that the emails must be separated with a comma.
Email subject The subject of the email.
Import your orders
The extension gives you the possibility to import your orders into your Magento back-office using different methods.
Manually
To import orders manually from Google Merchant Center into your Magento back-office, you can simply add the Google Shopping Order Id in the Import one order from Google Merchant Center field and click on Import now from: Stores › Settings › Configuration › Wyomind › Buy on Google › Additionnal Tools
In bulk
You can import all the orders into your Magento back-office in bulk. For that, you first need to enable the Import all orders in bulk option from: Stores › Settings › Configuration › Wyomind › Buy on Google › Order Import Settings
After that, you can go to: Sales › Orders
A pop-up will open. You will need to confirm if you want to import all the orders of your Google account.
After having confirmed, the import process will start.
Via the command lines
The below command lines can be used to import orders in bulk.
To import your orders:
wyomind:googleshoppingaction:import [options]
You can use the below options:
-o=ORDER-IDS or --order-ids=ORDER-IDS You need to use Google order ids. To leave empty for all pending (not acknowledged) orders. Multiple values are allowed.
-f or --force-import To delete the order if it already exists. Not suitable in production mode.
-d or --deduct-stock To deduct the qty from the source.
To initialize your orders:
wyomind:googleshoppingaction:initialize [options]
You can use the below option:
-f or --force-import To delete the order if it already exists. Not suitable in production mode.
Via the cron task
Your orders will be automatically imported via the cron task. For that, you need to make sure that the Magento cron task is enabled on your server and configured correctly.
The Buy on Google extension adds the below task:
googleshoppingaction_importorders * * * * *
Manage your orders
You have the possibility to create test orders from your Magento back-office. They will be synchronized with your Google Merchant account.
Create test orders
To create test orders including the products of your catalog, go to:
Sales › OrdersClick on Create a test order in Google Merchant Center.
When creating test orders, you can select one of the test customers.
Note that the Buy on Google extension adds payment and shipping methods for Google Shopping.
Synchronize the orders
Sometimes, if a modification has been made from your Google Merchant Center account, you"ll have to synchronize the orders from your Magento back-office in: Sales › OrdersFor that, you can simply select Update from Google Merchant from the Action dropdown.
Synchronize your shipments with Google Merchant Center
Your shipments will be automatically synchronized with your Google Merchant Center account when a shipment is created from your Magento back-office.
You can also synchronize your shipments via the Update action of the orders grid or via the cron task.
Via the Update action
In the case where the shipments have been created from Google Merchant Center, you can synchronize them by selecting Update from Google Merchant from the Action dropdown in the orders grid.
Via the cron task
Your shipments will be automatically exported via the cron task in the case where the orders are imported via a third-party tool.
The Buy on Google extension adds the below task:
googleshoppingaction_exportshipments * * * * *
FAQ
Pre-sales informations
Magento versions supported by Buy on Google
This extension works with Magento Community Edition and also Magento Enterprise Edition. To know if Buy on Google is compatible with your Magento version, please check the Compatibility tab.
Magento Open Source vs Magento Commerce vs Magento Commerce Cloud
Magento offers three variations of its product.
As their names have changed over the past few years, here is a recap:
Magento Open Source: previously Magento Community Edition (CE), is a free and non-hosted e-commerce platform.
Magento Commerce: previously Magento Enterprise (EE), is the paid version of Magento and offers support services.
Magento Commerce Cloud: is the paid version of Magento and offers support and hosting services.
License and domains
License validity
A license is valid for an unlimited period of time on one single installation
If you're using more than one installation, you will have to buy a separate license for each instance.
if you're running several domains on a same installation, you will need only one license for all of them.
Although your license doesn’t have a limited period of validity, your Support & Upgrade period does. By purchasing a module, you’ll be granted a 12-month support period for free. Passed this period, you will have to pay for a new one (see FAQ: Extend your Support period)
Domains pre-registration
You can pre-register your live domain to your license in advance.
Thanks to this option, you'll be able to get the module ready to use on your domain before it goes live.
To pre-register your production domain:
Go to: mY account › Licenses & DOwnloads
Click on the Settings icon next to the module you want your domain to pre-register on.
Click on the link at the bottom of the page saying: Do you want to pre-register your domain in order to be ready to go live?
Finally, enter your domain name and click on pre-register now .
Testing environments
One license is valid for an unlimited period of time on one installation only. However, it is possible to extend or transfer your license in 2 cases:
If you would like to add your testing environments to your license. In that case, it is possible to extend your license to an unlimited number of domains for free. For mywebsite-staging.com or mywebsite-dev.com
If you want to transfer your license to another live domain. In that case, the Support & Upgrade period for your license must still be active.
To be able to use Buy on Google on both your production and testing environments, follow the instructions below:
Install Buy on Google on your environment. (see FAQ: Modules installation in Magento or in WooCommerce)
Activate the license. (see FAQ: Licenses activation in Magento or in WooCommerce)
Also, if you are managing a large amount of domains, please contact us so that we can automatically whitelist these domains.
Modules versioning and download
Extensions download
In order to download Buy on Google, log into your Wyomind account:
Go to: my account › Licenses & downloads
Click on the settings icon next to Buy on Google.
A new window opens.
Click on the download icon.
Only the latest extension version released within your Support & Upgrade period is available. In order to get the very latest extension version make sure your Support & Upgrade plan is up to date.
Modules upgrade
When purchasing a module from wyomind.com, you benefit from 12 months of upgrade. Within this period you can at any time download the latest version of the module directly from your account.
To upgrade Buy on Google, follow the steps below:
Go to: my account › Licenses & Downloads
Click on the settings icon next to Buy on Google.
Click on the download icon.
Install the new version of Buy on Google in your Magento admin or your WooCommerce back-office.
Modules Installation/Uninstallation
Extensions installation via Composer
You can install Buy on Google using Composer software in two cases:
if you purchased Buy on Google on Magento Marketplace.
if you purchased Buy on Google on Wyomind.com AND requested access to our repository: repo.wyomind.com
Add to your composer configuration our repository:
Then, you have 2 ways to uninstall the extension depending on how the extension has been previously installed:
Manual installation
Run the googleshoppingaction-uninstall.sh file (you can find it in the extension zip folder) from your Magento root directory:
sh googleshoppingaction-uninstall.sh
Installation via Composer
Run the below command line:
composer remove wyomind/googleshoppingaction
Once the uninstallation is over, refresh your cache and enable the compiler back again (if you use it).
Extensions manual installation
You can install Buy on Google manually.
Download Buy on Google (zip file) on: mon compte › Licenses & Downloads Refer to the FAQ: Extensions download
Once Buy on Google is downloaded, open the folder and unzip it.
Copy the content of the unzipped folder and paste all files and directories in your Magento 2 root directory.
In your Command Line Interface, execute:
composer require google/apiclient:^2.0
Then, run:
bin/magento setup:upgrade
If you are using a production mode, execute also:
bin/magento setup:static-content:deploy
bin/magento setup:di:compile
Modules activation
Extensions activation from the back-office of Magento
Once Buy on Google is installed, you have to activate the license. For previous versions, you can activate the license from your back-office:
Go to your Magento admin panel. A message pops up at the top of the page.
If the message doesn't appear then you must check that:
1. The Adminhtml_Notifications and Wyomind_Core modules are well enabled. 2. The HTML output of the Adminhtml_Notifications and Wyomind_Core modules are not disabled in: storesconfigurationadvanced advanced 3. The encryption key well exists in app/etc/env.php:
Copy your activation key in: Stores › Configuration › Wyomind › Your extension
You can find your activation key in 2 different places: - In the confirmation email that you received after purchasing Buy on Google. - In your Wyomind account: My account › Licenses & downloads Select Buy on Google and click on .
A new page opens where you'll find your activation key (see below).
In your Magento admin go to: Stores › Configuration › Wyomind › Your extension
Paste the activation key in the Activation Key field and choose between the automatic (yes) or the manual (no) activation method: - By choosing Yes, the connection to Wyomind license server will be automatic. - By choosing No, you will have to log on to Wyomind license server yourself.
Click on Save config .
A message appears at the top of your admin panel. Click on that link: Activate it now!
Copy and paste the license code in theLicense code field from your admin or simply click on Activate now!
Finally, refresh your cache, log out and log in back straight after, to complete the installation.
Add another domain to your license
To activate the license on another domain (test, staging...):
Once the extension is installed on the new domain, copy your activation key in: Stores › Configuration › Wyomind › Your extension
After having saved the configuration, a notification appears. Click on Add this domain to my license.
A transfer request will then be sent to our team within an hour. Once the request is taken care of, you will receive a confirmation email. If your transfer request is accepted, you can use Buy on Google on both environments at the same time.
Note that the order in which you activate your license on your domains does not matter. You can start with your staging/dev/local environment or with your live domain, the process will be the same.
Also, if you have loads of staging domains, or if you are an agency managing load of domains for your customers, please contact us so that we can automatically whitelist these domains.
Extensions activation from the CLI
Once Buy on Google is installed, you have to activate the license.
For this, you can use the below command line (change the Activation key with the corresponding value):
If a notification as below is displayed on top of your Magento admin and indicates that it is impossible to connect to Google Merchant, you should check that you have added your Merchant id as well as the JSON file required for the Google API. How to find your Merchant id?
The JSON file as well as your Merchand id must be added in the Google Shopping API Settings from: Stores › Settings › Configuration › Wyomind › Google Shopping Actions
Cannot access orders of account
You get a message in your Magento admin when trying to import orders that says it is impossible to access orders of the account.
In that case, you should check the permissions for the API user in the Google Merchant Account from Tools and settings > Settings > Content API > Authentication.
The user should have access to "Order manager" as below:
Find your Google Merchant ID
You can find your ID in your Google Merchant Center account next to your company's name (Company: ID) as displayed below:
User's reviews
S
Steven
Merchant · United States · User for 6 years
★★★★★
google shopping orders come in instantly, works like a charm!
Very easy to install. Setup in just a couple minutes, first create an content API key inside your merchant center, upload the api key into the extension settings area, enter your merchant center id [numerical id number located at top right of your merchant center login] and connect. Orders synced instantly from google merchant center to my Magento 2.3.5 Amazing support by Jean-Paul, he responds immediately to all my questions. Definitely someone you can reply on. I use several extensions from wyomind and they never had any issues with my other theme and other extensions. clean high quality code. And the extensions are always up to date.
Magento 2 Compatibility
Supported by our master extension versions
2.4.8
2.4.7
2.4.6
2.4.5
2.4.4
2.4.3
2.4.2
2.4.1
2.4
2.3.7
2.3.6
2.3.5
2.3.4
2.3.3
2.3.2
2.3.1
2.3
Use cases
How merchants put Buy on Google to work, step by step.
Fixed a fatal error when loading the module with PHP 8: the execute() method of the Import and Initialize console commands is now compatible with Symfony Command::execute(): int
4.0.5
4.0.4
4.0.3
Bug fix
"area code is not set" upon installation
4.0.2
Compatibility
Compatibility with Magento 2.4.6
4.0.1
Compatibility
Compatibility with Magento 2.4.6
4.0.0
Initial release for the master version
3.0.0 legacy
Initial release for the legacy version
2.0.0
Compatibility
Compatibility with Magento v2.4.6 + PHP v8.2
1.4.3
Compatibility
Compatibility with PHP 8.1
Improvement
When importing an order, the delivery address is used as the billing address if there is no billing address
1.4.2
Fix for the address field when importing orders
1.4.1
Fix for the installation of samples data
1.4.0
Improvement
InProgress status added in the list of the order statuses to map
1.3.0
Compatibility
Compatibility with Magento 2.4
1.2.2
Fix for the module setup
1.2.1
Fix on an exception when installing sample data
1.2.0
Improvement
Improved license management system (Clear code)
1.1.7
Improvement
License system improved
1.1.6
Fix for a notice when shipments are not made from Google Shopping Actions
1.1.5
Permissions for the demo
1.1.4
Magento Marketplace version
1.1.0
Improvement
New framework
Improved notifications
1.0.0
First release
Feature request
Specific needs or any ideas of enhancements and new features to add to the extension? Tell us more, we'll get back to you shortly!