Magento 2

Buy on Google

Manage all Google Shopping orders directly from your Magento 2 back-office. Synchronize Magento 2 and your Google Merchant account.

marketplace approved
new
275,00€excl. VAT

5.0/5 rated 1 reviews

  • Lifetime license
  • 12 months support & upgrade
  • 60 days money-back guarantee
  • Extensible source code
  • Unlimited test domains
  • Free composer access
Demo Store

Effortlessly connect Magento 2 with Buy on Google

  • 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:

    • a smooth navigation
    • a shareable list
    • a universal shopping cart
    • instant checkout

    How to participate in the Buy on Google program?

    Buy on Google is only available in the USA.

    To participate in Buy on Google, you’ll need to sell your products directly on Google everywhere people shop: See the participation criteria for Buy on Google US

    How to integrate Buy on Google?

    Once you have reviewed the participation criteria to ensure your business is eligible for the program, you can start with the integration process.

    You first need to create a Merchant Center account (See how to create your Google Merchant Account).

    Take a look at the documentation of Google for more information.

    How to create your Google Merchant Account?

    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. 

    • Merchant Id
      Add your merchant id in that field.
      Check how to find your merchant id.
    • 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 › Orders
    Click 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 › Orders
    For 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: 

    1. Go to:
      mY account › Licenses & DOwnloads
    2. Click on the Settings icon next to the module you want your domain to pre-register on.
    3. 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?
    4. 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:

    1. Download Buy on Google.
      (see FAQ: Extensions download)
    2. Install Buy on Google on your environment.
      (see FAQ: Modules installation in Magento or in WooCommerce)
    3. 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:

      1. Go to:
        my account › Licenses & downloads 
      2. Click on the settings icon next to Buy on Google.

        A new window opens.

      3. 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:

    1. Go to:
      my account › Licenses & Downloads
    2. Click on the settings icon next to Buy on Google.
    3. Click on the download icon.
    4. 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
    1. Add to your composer configuration our repository:
      composer config repositories.wyomind composer https://repo.wyomind.com 

    2. Execute Composer command:
      composer require wyomind/googleshoppingaction
    3. Then go in your Command Line Interface and execute:
      bin/magento setup:upgrade ​
    4. If you are using a production mode, also execute:
      bin/magento setup:static-content:deploy  ​
      bin/magento setup:di:compile​
    Extensions uninstallation

    To uninstall Buy on Google, start with disabling the extension running the following command:

    bin/magento module:disable Wyomind_GoogleShoppingAction

    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.

    1. Download Buy on Google (zip file) on:
      mon compte › Licenses & Downloads 
      Refer to the FAQ: Extensions download
    2. Once Buy on Google is downloaded, open the folder and unzip it.
    3. Copy the content of the unzipped folder and paste all files and directories in your Magento 2 root directory.
    4. In your Command Line Interface, execute:
      composer require google/apiclient:^2.0​​​
        
    5. 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:

      1. 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:
        <?php
         return array(
         'backend' => array(
         'frontName' => 'admin'
         ),
         'crypt' => array(
         'key' => '1e8f3c6772b7a6a6689c3c8cefa4ccf0'
         ),
         /* ... */
         )
        ?>​
      2. 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).
      3. 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.
      4. Click on Save config .
      5. A message appears at the top of your admin panel. Click on that link: 
        Activate it now!
      6. Copy and paste the license code in the License code field from your admin or simply click on  Activate now! 

      7. 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...):

    1. Once the extension is installed on the new domain, copy your activation key in:
      Stores › Configuration › Wyomind › Your extension
    2. After having saved the configuration, a notification appears. Click on Add this domain to my license.

    3. 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):

    bin/magento wyomind:license:activate Wyomind_GoogleShoppingAction <YOUR_ACTIVATION_KEY>

    To retrieve the list of all the available modules as well as the licenses status, please use:

    bin/magento wyomind:license:status

     Among the different status, you can find: 

    • registered = your license is registered
    • pending = you need to run the activation command line
    • invalidated = the license has been invalidated due to a wrong activation key or a license infringement

    To activate several licenses at the same time, use:

    bin/magento wyomind:license:activate \
    Wyomind_Extension1,Wyomind_Extension2 \
    ACTIVATION_KEY_1,ACTIVATION_KEY_2

    or:

    bin/magento wyomind:license:activate \
    Extension1,Extension2 \
    ACTIVATION_KEY_1,ACTIVATION_KEY_2

    Check how to add another domain to your license.

    Troubleshooting

    Unable to connect to Google Merchant

    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

    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.

    July 31, 2020Magento 2

    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

    Changelog

    4.0.6

    Bug fix

    • 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!

    Thank you

    That’s a wrap.

    We will get back to you as soon as possible.

    You may also like