• No results found

Google Content Extension

N/A
N/A
Protected

Academic year: 2021

Share "Google Content Extension"

Copied!
5
0
0

Loading.... (view fulltext now)

Full text

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

http://www.google.com/merchants

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

http://google.com/merchants/newfeed

Target Countries supported by Google and available in Magento:

Australia China France Germany Italy Japan Netherlands Spain

United Kingdom United States

(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 e-mail

- '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

- 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 Required

other destination and validation errors will be returned

- product feed wont be submitted to this destination, but in can be still submitted to other destinations Excluded

More information about destination options you will find in

http://code.google.com/apis/shopping/content/getting-started/requirements-products.html#destinations

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

Product name <title>

Product description <content>

Product price with a store 'display' currency code is sent to Google. For no US target country it will be <price unit="currency_code">

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)

available values: [ ]; by default Magento sends value, but user is able to define custom

<condition> new, used, refurbished new

mapping for this attribute and send [used, refurbished] values too

Required system attributes (these attributes cannot be edited in custom mapping):

auto-generated product Google ID (productId+categoryId) <id>

language of you Target Country <content_language>

Target country <target_country>

Link to product view page of you store <link>

Default system attributes:

Product base image <image_link>

Product QTY <quantity>

Add items to Google Content

1. Go to Catalog Google Content Manage Items

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>

default is <sc:adult> [true, false] [false]

default is 30 days <sc:expiration_date>

<scp:color> <scp:edition> <scp:feature>

Featured products should be sent with 'y' value <scp:featured_product> [true, false]

<scp:genre> <scp:manufacturer>

Manufacturer's Part Number is a unique code determined by the manufacturer for that product <scp:mpn>

if any item is not available in your store to purchase or [false] if a customer can buy the posted item at your <scp:online_only>[true],

physical location

GTIN of the product (isbn/upc/ean) <scp:gtin>

<scp:product_type>

must be in between 1.0 and 5.0, can be mapped with any Magento attribute, example a 'Product <scp:product_review_average>

Reviews Count' text attribute

the total number of reviews for one of your products that can be mapped with any Magento attribute, </scp:product_review_count>

example a 'Product Reviews Count' text attribute <scp:quantity>

Magento sends pound bu default. Unit parameter is not editable in back-end <scp:shipping_weight unit="pound">

<scp:size>

Expects four digits, example: 2011 <scp:year>

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

The tax rate as a percent of the item price, i.e., number, as a percentage.

<scp:tax_rate>

The country an item is taxed in (as a two-letter ISO 3166 country code).

<scp:tax_country>

The geographic region that a tax rate applies to, e.g., in the US, the two-letter state abbreviation, ZIP code, or

<scp:tax_region>

ZIP code range using * wildcard.

Boolean value that specifies whether you charge tax on shipping. The default value is false.

<scp:tax_ship>

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:

1. Go to Catalog Google Content Manage Items 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.

(5)

Synchronize Google items

Synchronize action updates product attributes uploaded to Google. 1. Go to Catalog Google Content Manage Items

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. 1. Go to Catalog Google Content Manage Items

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.

References

Related documents

The service also includes Google Docs, Google Slides, Google Drawings, Google Forms, Google Sites, and Google Keep!. Full content visible, double tap to read

You can export sheets as separate files, you have to enter your data, you can simply download the Google Chrome extension and it will automatically be added as an extension to

Important: You must sign in to a Google Account to use Gmail, Google Talk, Google Calendar, and other Google Apps; to download applications from Google Play; to back up your

You must sign in to a Google Account to use Gmail, Hangouts, Google Calendar, and other Google Apps; to download applications from Google Play; to back up your settings to

● Customize the access level (such as require people to request an invitation to join the group) ● Require message moderation—that is, your approval for all messages sent to the

The most people into an exemplary google sheets lessons build your learning styles google doc spreadsheet, use google docs or you may serve as dental, using google classroom makes

• Google content policy.  Google sets some very strict guidelines 

If you want to have Google Drive automatically convert your files to Google format (e.g. Microsoft Word to Google Docs), you can change a setting in Google Drive by clicking on the