Table of contents
Introduction
Google Shopping Ads by Squarefeed is the easiest way for you to advertise your products using Google Shopping Ads.
It creates your product feed, submits it to Google Merchant, then publishes your Google Shopping Campaign to Adwords.
After your campaign is live, the module will show view the statistics right in your Magento admin panel and will update your product information on a daily or weekly basis.
In order for Squarefeed to work you need to install the Magento extension. During the installation process there will be an integration added to your store which will allow for communication between your store and our servers. If the integration is not active or doesn’t have the necessary permissions you will not be able to use the extension.
Installation
There are 3 ways to install the extension. the first two options (1 and 2) rely on Magento’s Setup Wizard and the third option is installation via the command line. If you’re getting errors during the installation process please email us at support@squarefeed.io and indicate your website URL and screenshots of the errors you are seeing.
1. Installation via Setup Wizard
The extension can be installed via Magento Setup Wizard in 2 ways. In both cases you should go to the System -> Web Setup Wizard -> Component Manager.
1.1. Setup Wizard via FTP upload
- Download the extension code from the Magento Marketplace
- Using a FTP client such as FileZilla, connect to your server and go to the
magento_root_folder
. - Navigate to the
/app/code
directory (if/code
folder doesn’t exist, create it) - Create the following directory structure inside the
/code
folder:Adfix/Squarefeed/
- Unzip the module and copy the contents to the above mentioned folder
- Then go to the Setup Wizard interface, refresh the page and you will see the needed component.
Watch a screencast: https://cl.ly/0E1P0Z1Y251p
Click on the ‘Select’ dropdown and click ‘Enable’
Click on ‘Start Readiness Check’ and if all is ok, ‘Next’ button is output. You can make a backups on the next step.
This option is important (especially ‘Code’ and ‘Database’ backups) to make rollbacks, if something goes wrong (if you get errors during installation but you made code and database backups, you just can click ‘Rollback’ button on the last step and magento should return the previous state of store).
Note that this process can take 20 minutes or more.
Then you have the ability to enable extension and magento will deploy the code.
1.2. Setup Wizard via Magento Marketplace
You need to create an account on Magento Marketplace to use this option. If you don’t already have a Marketplace account, you can open one here.
Get the Squarefeed extension from the Marketplace, then in the account settings you should copy access keys to your account.
And put these keys in the Configuration tab on the Setup Web Wizard page. This should be done only one time to synchronize your account with Magento instance. When you add the keys into Magento, all purchases will be accessible in Magento.
Go to install link and you will see purchased extension
When you click install the extension, you will get the same steps as in option 1. [it will still take about 20 minutes]
2. Installation via Command Line
- Download the extension code from the Magento Marketplace or from our GitHub
- Using a FTP client such as FileZilla, connect to your server and go to the
magento_root_folder
. - Navigate to the
/app/code
directory (if/code
folder doesn’t exist, create it) - Create the following directory structure inside the /code folder:
Adfix/Squarefeed/
- Unzip the module and copy the contents to the above mentioned folder
- (Optional) Make a backup
php bin/magento setup:backup --code --db
- Set maintenance mode
php bin/magento maintenance:enable
- (Optional) Hard clean Magento deploy data. In this case you avoid Magento system error
rm -rf var/generation/*
rm -rf var/cache/*
rm -rf var/page_cache/*
rm -rf var/view_preprocessed/*
rm -rf var/di/*
rm -rf pub/static/*
- Upgrade data
php bin/magento setup:upgrade
- Deploy code
php bin/magento setup:di:compile
- Deploy static files
php bin/magento setup:static-content:deploy
- Need to check
/var
and/pub/static
directories. These folders and files which they contain should have write permission. - Disable maintenance mode
php bin/magento maintenance:disable
3. Installation via Composer
- (Optional) Make a backup
php bin/magento setup:backup --code --db
- Set maintenance mode
php bin/magento maintenance:enable
- Run the next composer command to install extension from Magento marketplace
composer require adfix/squarefeed
- (Optional) Hard clean Magento deploy data. In this case you avoid Magento system error
rm -rf var/generation/*
rm -rf var/cache/*
rm -rf var/page_cache/*
rm -rf var/view_preprocessed/*
rm -rf var/di/*
rm -rf pub/static/*
- Upgrade data
php bin/magento setup:upgrade
- Deploy code
php bin/magento setup:di:compile
- Deploy static files
php bin/magento setup:static-content:deploy
- Need to check
/var
and/pub/static
directories. These folders and files which they contain should have write permission. - Disable maintenance mode
php bin/magento maintenance:disable
Installation FAQ
Errors during installation
If you are getting errors during installation, please ask your developer to check if cron job is enabled.
I installed the extension but the configuration screen is not loading
After installation if you click on the Squarefeed icon in the Magento admin menu and nothing happens or you’re experiencing errors please follow these debugging steps:
- Tokens should be generated during installation and set in the integrations. If tokens are missing then the Magento instance cannot communicate with our servers. Therefore you have to check Admin Panel -> System -> Integrations. You should see an entry for Squarefeed in there and the status of the integration should be active.
- The extension doesn’t work if Magento (backend and/or frontend) is under http password protection. Please remove any password protection and try again.
- If there are any errors from our extension, it creates error logs on your server. magento_root/var/log/squarefeed.log should contain the info. In this case please contact our support <support@squarefeed.io>.
- Our extension makes a request to our servers to process the product data and display the configuration screen. If you have a firewall or are using an ad-blocker this can interrupt the communication between your Magento store and our server. Ensure that you deactivate your firewall and/or any ad-blocking extensions you may have installed on your browser.