Google Content Extension

Transcription

1 Google Content Extension About Google has launched new Shopping APIs that replaced Google Base Data API for shopping use cases. Google Base Data API was be fully retired on June 1, 2011 and merchants using Base API to upload products to Google should migrate to new Content API. Google Shopping API consists of two parts: Content and Search; Content API allows insert, update, delete and retrieve product's info from Google; Search API allows search by uploaded items. This extension covers the new Content API logic and it is designed for managing merchant item being uploaded to Google Base - in Magento it will simply replace the current Google Base API logic. How to start Get Google Merchant Account Before you start any work with Google Shopping extension you need to get Google Account from Google Merchant Center: and verify your site in Google account (follow Google steps to verify the site). Install Google Shopping Extension Google Shopping was developed as Magento Core extension. To have it working in your Magento installation you need to download it using Magento Connect. In Magento Admin: 1. Go to System Magento Connect Magento Connect Manager 2. Search for Google Shopping extension 3. Paste extension key and «Install» If all data was entered correctly the Google Shopping extension will be installed and there will be new interfaces available in Magento back-end: System Configuration Google API Google Shopping Catalog Google Content Manage Attribute & Manage Items Configure Magento Once you have successfully installed Google Shopping extension, you need to configure your Magento store. Google Shopping extension allows to upload product feed to specified by Google target countries only. Your store configuration must meet Google product feed requirements for successful product upload. These product feed requirements can be found in Google Merchant Center Target Countries supported by Google and available in Magento: Australia China France Germany Italy Japan Netherlands Spain United Kingdom United States Add Google Merchant Center account

2 1. Go to System Configuration Google API Google Shopping tab 2. Enter Google credentials to following fields: - 'Account ID' - Google developer ID that get be fount in GMC - 'Account Login' - Google account - 'Account Password' - Google account password 3. Click «Save Config» button If all data was entered correctly your Google configuration will be saved and you will be able to authorize Magento API requests in Google. Set store target country Your product feed will be uploaded to specific Google target country, which can be set in Magento configuration. 1. Go to System Configuration Google API Google Shopping tab 2. In 'Target Country' field select a country of your Store 3. Click «Save Config» button If you have multistores installation and your stores countries are supported by Google, then set 'Target Country' for each store. A store country language and currency should match the 'Target Country' you products should be submitted to. Set Currency for Store View The currency code of your store view must mach Target County currency. For instance, for US Google Search (US target country) only USD price currency ban be submitted. 1. Go to System Configuration Currency Setup Currency Options 2. In 'Default Display Currency' field select a currency of your Store relevant to selected before Target Country 3. In 'Allowed Currencies' select your allowed currency 4. Click «Save Config» button Remember to define currency rate in System->Manage Currency Rates if you have different currencies per store view. Once you have Google account configured, Target County set and Currencies properly defined you are able to upload your products to Google. Product feed Destinations In System Configuration you can also change Google destination your products should be uploaded to. Available destinations are: Product Search, Product Ads, Commerce Search. Default - product feed will be submitted using Google default settings Required - product feed must be submitted to this destination, if it doesn't meet validation rules in Google, then it wont be inserted at all for any other destination and validation errors will be returned Excluded - product feed wont be submitted to this destination, but in can be still submitted to other destinations More information about destination options you will find in Update Google Shopping Item when Product is Updated You can also set in Magento configuration whether your product shall be updated in Google each time you update product attributes in admin edit product view (triggered on product_save action) Upload items with Default mapping You can upload your product feed using default Magento mapping. Default mapping contains all attributes required by Google (without these attributes your product feed cannot be successfully submitted).

3 Required attributes (also editable in custom mapping): <title> Product name <content> Product description <price unit="currency_code"> Product price with a store 'display' currency code is sent to Google. For no US target country it will be regular price OR sale price (always lower value) and including OR excluding tax (depending on configuration settings for Catalog Display Tax=Including/Excluding tax). For US there are other price attributes available and different tax options (see below) <condition> available values: [ new, used, refurbished]; by default Magento sends new value, but user is able to define custom mapping for this attribute and send [ used, refurbished] values too Required system attributes (these attributes cannot be edited in custom mapping): <id> auto-generated product Google ID (productid+categoryid) <content_language> language of you Target Country <target_country> Target country <link> Link to product view page of you store Default system attributes: <image_link> Product base image <quantity>product QTY Add items to Google Content 2. Upload items to Google for any Store and Target Country Items will be uploaded to Google with Default system mapping created for all target countries. Only required AND default attributes will be uploaded to Google when no custom mapping is created. *US target country includes a few exceptions explained below. Upload items with Custom mapping Google accepts following product attributes: General attributes (for ALL countries): <scp:author> <scp:availability> [in stock, out of stock, limited availability] <scp:brand> <sc:adult> [true, false] default is [false] <sc:expiration_date> default is 30 days <scp:color> <scp:edition> <scp:feature> <scp:featured_product> [true, false]featured products should be sent with 'y' value <scp:genre> <scp:manufacturer> <scp:mpn>manufacturer's Part Number is a unique code determined by the manufacturer for that product <scp:online_only> [true], if any item is not available in your store to purchase or [false] if a customer can buy the posted item at your physical location <scp:gtin> GTIN of the product (isbn/upc/ean) <scp:product_type> <scp:product_review_average> must be in between 1.0 and 5.0, can be mapped with any Magento attribute, example a 'Product Reviews Count' text attribute </scp:product_review_count> the total number of reviews for one of your products that can be mapped with any Magento attribute, example a 'Product Reviews Count' text attribute <scp:quantity> <scp:shipping_weight unit="pound"> Magento sends pound bu default. Unit parameter is not editable in back-end <scp:size> <scp:year> Expects four digits, example: 2011 Create custom mapping 1. Go to Catalog Google Content Manage Attribute 2. Click on «Add Attribute Mapping» button 3. Select 'Target Country' your products should be submitted to 4. Select 'Attribute Set' of your products

4 5. Click on «Add New Attribute» button 6. Select Magento 'Attribute' and its corresponding 'Google Content Attribute' 7. «Save Mapping» Now, you are able to upload your products with mapped attributes to Google. US country attributes There are a few attributes available only for US target country. Tax To US target country you can upload your store view tax rule sand information. Tax XML elements <scp:tax_rate> The tax rate as a percent of the item price, i.e., number, as a percentage. <scp:tax_country> The country an item is taxed in (as a two-letter ISO 3166 country code). <scp:tax_region> The geographic region that a tax rate applies to, e.g., in the US, the two-letter state abbreviation, ZIP code, or ZIP code range using * wildcard. <scp:tax_ship> Boolean value that specifies whether you charge tax on shipping. The default value is false. Upload Items with Tax Rates Preconditions: 1. Tax rules and rates are defined for US country 2. Products are Taxable Goods 3. Select Catalog Prices 3a. Excluding tax 3b. Excluding and Including tax In Magento Admin: 2. Select Store View with US target country 3. Add and Upload items to Google Products were uploaded to Google with Product Price excluding tax (the catalog price) and tax rates&regions for US country Sale Price Sale Price attribute is only available for US country. If any product has sale price defined (added as Sale Price in product edit view or discounted price defined by Magento catalog price rules), Magento will sen two price attributes: Regular Price and Sale Price. Sale Price effective date For US country user is able to define custom mapping for sale price from/to date and Google Sale Price Effective From/To Date. Upload items with Sale Price Effective date attribute NOT EMPTY 1. Create custom mapping for 'Sale Price From/To dates' 2. Create product with 'Sale price' and 'Sale Price From/To' attributes added 3. Submit Items to Google 'Sale Price From/To' attributes values were sent to Google and Sale Price Effective date is displayed in Google. Upload items with Sale Price Effective date attribute EMPTY 1. Create custom mapping for 'Sale Price From/To dates' 2. Create product with 'Sale price' and 'Sale Price From/To' attributes EMPTY 3. Submit Items to Google 'Sale Price From/To' attributes values were not sent to Google - system doesn't send these attributes if EMPTY. Sale Price Effective date is not displayed in Google. Mange Items

5 Synchronize Google items Synchronize action updates product attributes uploaded to Google. 2. Select Store View 3. Select products you want to upate 4. In Actions drop-down select 'Synchronize' option and click «Submit» button 5. In alert window Click OK Note: If current custom mapping attributes collection is different then at the time when item was last updated (uploaded, synchronized), system will first delete these products and upload them as new items. This is because Content API doesn't allow to delete attributes in Google that do not exist any more in mapping and at the other hand Google requires to keep product feed data consistent, Delete Google items You can delete you items uploaded to Google Merchant Center before at any time. 2. Select Store View 3. Select product(s) for delete 4. In Actions drop-down select 'Delete' option and click «Submit» button 5. In alert window Click OK Product Feed migration Migrate products from Google Base to Google Content data feed If you are using Google Base and there is a product data feed in your current Magento installation, it will be migrated (copy) to new Google Content tables after you instal Google Shopping extension.