Contact Google or your Lengow account manager to know if you are eligible to sell your products on Google Actions. This service access has to be validated by Google first.

To distribute your products on Google, check that your products catalogue contains the data normally required.

Note: you don't have these values in your product catalogue? Contact the Lengow Support Team to find an alternative.

Preamble

We chose to indicate in this guide fields technical names given by Google, for two reasons:

  • They are titles, which Google will communicate to you
  • These titles are common to all languages in Lengow. Whatever version of this channel you use (English, French, Spanish, Italian, ...), this guide will refer to the fields mentioned on the structure.

In Lengow, you will find the title of these fields under the name indicated by Lengow in the language of the structure:

Capture_d__cran_2019-04-05___11.30.26.png

Add a channel catalogue

Add a Google channel catalogue in your Lengow account and select the service.s you want to activate:

Multi-countries display

  • Google Shopping and Display Ads services: If you display your products in multiple countries, you'll have as many Google Shopping feeds in Lengow as you need to distribute your products. Each Google Shopping feed is independent of the others and although there are similarities, requires a specific country settings.
  • Google Shopping Actions service: It is only available in France for instance.

Will some products in your catalog be displayed on Google Shopping and others on Google Shopping Actions?

Only one Google channel is required in Lengow! Many fields are common to these services. The structure made available in your account will automatically adapt to your selection.

Unless specified, following settings are for all Google services.

Match Categories

Match your categories with Google's through "Categories Matching".

Complete Attributes Matching

Match your products catalogue fields with the fields requested by the channel, based on field definition. If necessary, enter hard values, use functions and/or adapt the values by creating rules. For fields with valid values, select the suggested values or match with your products catalogue values.

Some fields are mandatory and must be completed for your products to be created or updated. Other fields are optional but Google recommends you fill them in to improve your products visibility.

Some special features for Google :

1. Set up your special offers/sales

To set up special offers, fill in the following fields:

  • salePrice.value: discounted price of your on sale product
  • price.value: strikethrough price of your product (original price)

If you prepare your sales or promotions in advance, fill in this field so that your reduced prices won't be displayed immediately:

  • salePriceEffectiveDate: time period during which sales will apply. You have to follow this exact formula when you fill this in: “2018-06-27T08:00-0200/2018-08-07T23:00-0200” for all your on sale products. If you use this field, Google recommends you to optimise your feed at least 7 days before the first day of the sales period to make sure changes are taken into account.

Please make sure you use the right time zone in this formula according to your location (for example: 0100 matchs the French time zone for the winter sales and 0200 matchs to the summer time in France).

Click here to read Google's documentation.

2. Delivery methods and costs

Here are the fields that are linked yo delivery method and costs. Please check the structure's definition for more details and to know whether it is a required or an optional field.

  • shippingLabel : Shipping method. Find more information about it in the Google HelpCenter. This refers to the label you defined while creating a shipping method in your Google Merchant Center. In Lengow, you’ll indicate the shipping method label you want to apply to your product·s.
    • For Google Shopping service: you can either fill in this field or shipping fields (shipping.price.value, shipping.price.currency, shipping.country at the least and optionnaly: shipping.region, shipping.service, shipping.locationId, shipping.locationGroupName, shipping.postalCode).
      It is possible to fill only one shippingLabel per product.
    • For Google Shopping Actions service: These shipping costs are considered at basket level (whatever the number of units of product added in the basket). They have to be set up in your Google Merchant Center > “Shipping” tab > “Shipping Services”.
      It is possible to fill only one shippingLabel per product.

3. Add Custom Attribute

Google allows you to create additional attributes to those already offered to match your specific needs. Please confirm with your Google Account Manager if additional attribute is really required before adding it.

To add a custom attribute, 4 fields are to be filled in.

  • customAttributes.name
  • customAttributes.type
  • customAttributes.unit
  • customAttributes.value

You may add as many custom attributes as you need in Lengow.

4. Add Custom Labels

Google allows you to add up to 5 custom attributes in your catalog, with these fields:

  • customLabel0
  • customLabel1
  • customLabel2
  • customLabel3
  • customLabel4

5. Manage your products service by service

When you activate a service, Lengow automatically pre-populates several fields for you to indicate in your optimized catalog the values ​​expected by Google to display your products on the right service.

These are the fields:

  • destinationName.Shopping
  • destinationName.ShoppingActions
  • destinationName.google_display_ads

These fields are only available in the Attribute Matching if the service is activated.

Lengow gives you the ability to restrict the display of your products to a lower level (for example: product or category), thanks to Rules.

For products targeted by your rule, indicate the value “Yes” in the field corresponding to the service you want to exclude your products.

We strongly recommend that you use this type of rule when initially setting up your catalog on this structure, in order to progressively display your inventory on Google Actions.
#1 Activate the service in Lengow.
#2 Indicate “Yes” to exclude all your products from the service, during the time for you to set up your catalogue properly.

  The deactivation of the service (#1 above) will override registered rules. The result will be the same as applying the "Yes" value in one of the destination fields in the Attribute Matching. The fields for the disabled service are hidden in the Attribute Matching. They will no longer be sent to Google for the service in question, but will be retained if reactivated later.

Manage your Exclusions

Google doesn't want to receive parent products. Lengow exclude them automatically based on information filled in the Lengow Matching when adding your catalog.

Products excluded with the Exclusion feature will be sent to Google with a 0 stock.

You can add other exclusions:

  • Products you don't want to display on this channel.
  • Products from your catalog which don't match with Google expectations.

Please note that using an exclusion will impact all activated services on this channel.

To display a product on a service and deactivate it on another channel, use destination attributes in the Attribute Matching.

Preview your data

Check the data you are about to send to the channel using "Preview".

Note: Codes corresponding to matched categories in the "Categories Matching" step will be displayed at this stage.

Configure your Options

Configure options before sending your products catalogue to the channel.

Different tab will be displayed according to activated service.s:

  • Costs: For all services.
  • Tracking: For all services, except Google Shopping Actions.
  • API ID : For all services.

Follow instructions displayed on the screen. Fill in your Google id. Once you are connected, if you have multiple Merchant ID, select the account where you want to send your products.

Launch the channel catalogue

Before the first sending

You are about to activate this channel on Lengow for the first time and your catalog is already online on Google Shopping (you are maybe managing it directly in your Google Merchant Center or through a csv file from Lengow for example):

  • Finalize sending your catalog from Lengow through API.
    At this point, both feeds are active and therefore indexed by Google. Note that each indexing will take precedence over the previous one (ex: Data from API feed will be online, then it will be the data of the URL feed that will be displayed).

When the configuration of your API catalog is finalized and your products are online:

  • Go to your Google Merchant Center and pause the csv feed: Google Merchant Center > "Products" > "Feeds" > choose you feed > "Settings" > "Fetch schedule" > "Pause schedule”.

Then your data will be done automatically between Lengow and Google.

Optimised feed url which is available on the "Settings" page for this channel is only there to help you have a view on all data sent to Google. If you upload it in your Google Merchant Center, an error will occur.

Two different feeds are sent to Google through the API:

  • Product feed: enables the integration and creation of products. It contains all the fields expected by Google. It is sent to Google once a day. If your products are free from errors, they will be created in Google and will appear online within 2 days, after the offer feed has been sent
  • Offer feed: il permet la mise à jour des prix, stock… Il contient uniquement le champ identifiant produit et les données variant fréquemment. Il est envoyé à Google toutes les heures. Lorsque Google reçoit le flux offres, la mise à jour est quasiment instantanée sur le Google.

Read Integration Reports

The three reports

  • Products and Offers integration reports

Read product and offer Integration Reports to check that your products are properly configured, either at product creation level (product feed's named "Push Products") or updates (offer feed's named "Push offers"). These reports list only items which were rejected by Google. These reports are generated after each catalog push to Google. 

  • Find in the "Product Statuses" report, the status for each of your products. For each of your product with an error, Google specifies the reason for the rejection.
    This report is generated once a day.

These three types of reports are available and downloadable in your Lengow account: "Channels" tab > select the Google channel > click on "Activity".

Errors

To help you correct these errors:

Google Shopping

Google Actions

Please read our guide “Google Actions: Errors that may occur”.

Edit a product file

Contact your Google account manager to edit this data.

Data is automatically updated as soon as the offer feed is sent out.

Unpublish/Delete an offer

1. Unpublish

  • Case #1: Only one Google service is activated for your catalog and you want to unpublish on or many product.s from this service

Case #1.A: The activated service is Google Shopping Actions

Fill in the "sellOnGoogleQuantity" field with 0. Use a rule to apply this un-publication to all or part of your catalog.

or

Fill in the "availability" field with the value "out of stock". Use a rule to apply this un-publication to all or part of your catalog.

Case #1.B: The activated service isn't Google Shopping Actions

Fill in the "availability" field with the value "out of stock". Use a rule to apply this un-publication to all or part of your catalog.

  • Case #2: Several Google services are enabled for your catalog and you want to un-publish your products from only one of these services (and continue to display them on other services).

Fill in the field "destinationName. ..." corresponding to the service on which you want to un-publish the product.s with the value "Yes". Use a rule to apply this un-publication to all or part of your catalog.

In the Preview tab, the “1”value indicates that the product won’t be displayed on the service. The “0” value indicated that the product will be displayed on the service.

Example: I want to un-publish my products from Google Shopping Actions and I want to keep displaying them on other services. Fields will have to be filled in this way in the Preview:

  • destinationName.Shopping: 0
    It means the product will be displayed on Google Shopping
  • destinationName.ShoppingActions: 1
    It means the product won’t be displayed on Google Shopping Actions
  • destinationName.google_display_ads: 0
    It means the product will be displayed on Google Display Ads

2. Delete products

For all services:

Currently, Lengow doesn’t offer to delete products on the Google Merchant Center.

Manage your Google Shopping Acitons orders

You can manage your orders in the Lengow platform.

1. Order retrieval

Lengow retrieve orders every hours.

2. Order processing

Orders go through various statuses in Lengow while being processed.

3. Statuses of Google Shopping Actions orders

Lengow retrieves the orders with status "Waiting Shipment".

Here is the list of Google Shopping Actions statuses corresponding to orders statuses in Lengow and actions you could realise at the different steps:

  • New order

NEW” : The order is being processed on Google side. A fraud check is performed. The buyer has the option to cancel the order.

  • Waiting shipment

"SHIPPING": Order is awaiting for shipment. During this status, you can confirm the shipment of the order and enter the parcel tracking number.

You can also cancel the order shipment and indicate:

  • The reason for this cancellation, using the list of values ​​available in Lengow. (At the product line level or for the whole order)
  • The quantity of products you want to canceled (At the level of the produced line only). Leaving the field empty, the total volume is taken into account.
  • A comment if you want to. (At the product line level or for the whole order).

 

  • Shipped

"SHIPPED": "sent". Order has been sent and shipment is in progress.

During this status, you can make a refund (if the product has been returned for example).

Indicate:

- The reason for this refund,
- Choose if you refund shipping fees,
- A comment if needed,
- The quantity of products refunded if necessary (at the product line only).

The refund is applied to the total amount of the product (no partial refund of a product).

  • Cancelled

"CANCELLED": order cancelled by merchant or customer during the “SHIPPING” status.

  • Refunded

"REFUNDED": order has been refunded.

Contact

Your Google account manager.

Useful links

Set up Google Shopping, Display Ads & Actions

 

Contact Google or your Lengow account manager to know if you are eligible to sell your products on Google Actions. This service access has to be validated by Google first.

To distribute your products on Google, check that your products catalogue contains the data normally required.

Note: you don't have these values in your product catalogue? Contact the Lengow Support Team to find an alternative.

Preamble

We chose to indicate in this guide fields technical names given by Google, for two reasons:

  • They are titles, which Google will communicate to you
  • These titles are common to all languages in Lengow. Whatever version of this channel you use (English, French, Spanish, Italian, ...), this guide will refer to the fields mentioned on the structure.

In Lengow, you will find the title of these fields under the name indicated by Lengow in the language of the structure:

Capture_d__cran_2019-04-05___11.30.26.png

Add a channel catalogue

Add a Google channel catalogue in your Lengow account and select the service.s you want to activate:

Multi-countries display

  • Google Shopping and Display Ads services: If you display your products in multiple countries, you'll have as many Google Shopping feeds in Lengow as you need to distribute your products. Each Google Shopping feed is independent of the others and although there are similarities, requires a specific country settings.
  • Google Shopping Actions service: It is only available in France for instance.

Will some products in your catalog be displayed on Google Shopping and others on Google Shopping Actions?

Only one Google channel is required in Lengow! Many fields are common to these services. The structure made available in your account will automatically adapt to your selection.

Unless specified, following settings are for all Google services.

Match Categories

Match your categories with Google's through "Categories Matching".

Complete Attributes Matching

Match your products catalogue fields with the fields requested by the channel, based on field definition. If necessary, enter hard values, use functions and/or adapt the values by creating rules. For fields with valid values, select the suggested values or match with your products catalogue values.

Some fields are mandatory and must be completed for your products to be created or updated. Other fields are optional but Google recommends you fill them in to improve your products visibility.

Some special features for Google :

1. Set up your special offers/sales

To set up special offers, fill in the following fields:

  • salePrice.value: discounted price of your on sale product
  • price.value: strikethrough price of your product (original price)

If you prepare your sales or promotions in advance, fill in this field so that your reduced prices won't be displayed immediately:

  • salePriceEffectiveDate: time period during which sales will apply. You have to follow this exact formula when you fill this in: “2018-06-27T08:00-0200/2018-08-07T23:00-0200” for all your on sale products. If you use this field, Google recommends you to optimise your feed at least 7 days before the first day of the sales period to make sure changes are taken into account.

Please make sure you use the right time zone in this formula according to your location (for example: 0100 matchs the French time zone for the winter sales and 0200 matchs to the summer time in France).

Click here to read Google's documentation.

2. Delivery methods and costs

Here are the fields that are linked yo delivery method and costs. Please check the structure's definition for more details and to know whether it is a required or an optional field.

  • shippingLabel : Shipping method. Find more information about it in the Google HelpCenter. This refers to the label you defined while creating a shipping method in your Google Merchant Center. In Lengow, you’ll indicate the shipping method label you want to apply to your product·s.
    • For Google Shopping service: you can either fill in this field or shipping fields (shipping.price.value, shipping.price.currency, shipping.country at the least and optionnaly: shipping.region, shipping.service, shipping.locationId, shipping.locationGroupName, shipping.postalCode).
      It is possible to fill only one shippingLabel per product.
    • For Google Shopping Actions service: These shipping costs are considered at basket level (whatever the number of units of product added in the basket). They have to be set up in your Google Merchant Center > “Shipping” tab > “Shipping Services”.
      It is possible to fill only one shippingLabel per product.

3. Add Custom Attribute

Google allows you to create additional attributes to those already offered to match your specific needs. Please confirm with your Google Account Manager if additional attribute is really required before adding it.

To add a custom attribute, 4 fields are to be filled in.

  • customAttributes.name
  • customAttributes.type
  • customAttributes.unit
  • customAttributes.value

You may add as many custom attributes as you need in Lengow.

4. Add Custom Labels

Google allows you to add up to 5 custom attributes in your catalog, with these fields:

  • customLabel0
  • customLabel1
  • customLabel2
  • customLabel3
  • customLabel4

5. Manage your products service by service

When you activate a service, Lengow automatically pre-populates several fields for you to indicate in your optimized catalog the values ​​expected by Google to display your products on the right service.

These are the fields:

  • destinationName.Shopping
  • destinationName.ShoppingActions
  • destinationName.google_display_ads

These fields are only available in the Attribute Matching if the service is activated.

Lengow gives you the ability to restrict the display of your products to a lower level (for example: product or category), thanks to Rules.

For products targeted by your rule, indicate the value “Yes” in the field corresponding to the service you want to exclude your products.

We strongly recommend that you use this type of rule when initially setting up your catalog on this structure, in order to progressively display your inventory on Google Actions.
#1 Activate the service in Lengow.
#2 Indicate “Yes” to exclude all your products from the service, during the time for you to set up your catalogue properly.

  The deactivation of the service (#1 above) will override registered rules. The result will be the same as applying the "Yes" value in one of the destination fields in the Attribute Matching. The fields for the disabled service are hidden in the Attribute Matching. They will no longer be sent to Google for the service in question, but will be retained if reactivated later.

Manage your Exclusions

Google doesn't want to receive parent products. Lengow exclude them automatically based on information filled in the Lengow Matching when adding your catalog.

Products excluded with the Exclusion feature will be sent to Google with a 0 stock.

You can add other exclusions:

  • Products you don't want to display on this channel.
  • Products from your catalog which don't match with Google expectations.

Please note that using an exclusion will impact all activated services on this channel.

To display a product on a service and deactivate it on another channel, use destination attributes in the Attribute Matching.

Preview your data

Check the data you are about to send to the channel using "Preview".

Note: Codes corresponding to matched categories in the "Categories Matching" step will be displayed at this stage.

Configure your Options

Configure options before sending your products catalogue to the channel.

Different tab will be displayed according to activated service.s:

  • Costs: For all services.
  • Tracking: For all services, except Google Shopping Actions.
  • API ID : For all services.

Follow instructions displayed on the screen. Fill in your Google id. Once you are connected, if you have multiple Merchant ID, select the account where you want to send your products.

Launch the channel catalogue

Before the first sending

You are about to activate this channel on Lengow for the first time and your catalog is already online on Google Shopping (you are maybe managing it directly in your Google Merchant Center or through a csv file from Lengow for example):

  • Finalize sending your catalog from Lengow through API.
    At this point, both feeds are active and therefore indexed by Google. Note that each indexing will take precedence over the previous one (ex: Data from API feed will be online, then it will be the data of the URL feed that will be displayed).

When the configuration of your API catalog is finalized and your products are online:

  • Go to your Google Merchant Center and pause the csv feed: Google Merchant Center > "Products" > "Feeds" > choose you feed > "Settings" > "Fetch schedule" > "Pause schedule”.

Then your data will be done automatically between Lengow and Google.

Optimised feed url which is available on the "Settings" page for this channel is only there to help you have a view on all data sent to Google. If you upload it in your Google Merchant Center, an error will occur.

Two different feeds are sent to Google through the API:

  • Product feed: enables the integration and creation of products. It contains all the fields expected by Google. It is sent to Google once a day. If your products are free from errors, they will be created in Google and will appear online within 2 days, after the offer feed has been sent
  • Offer feed: il permet la mise à jour des prix, stock… Il contient uniquement le champ identifiant produit et les données variant fréquemment. Il est envoyé à Google toutes les heures. Lorsque Google reçoit le flux offres, la mise à jour est quasiment instantanée sur le Google.

Read Integration Reports

The three reports

  • Products and Offers integration reports

Read product and offer Integration Reports to check that your products are properly configured, either at product creation level (product feed's named "Push Products") or updates (offer feed's named "Push offers"). These reports list only items which were rejected by Google. These reports are generated after each catalog push to Google. 

  • Find in the "Product Statuses" report, the status for each of your products. For each of your product with an error, Google specifies the reason for the rejection.
    This report is generated once a day.

These three types of reports are available and downloadable in your Lengow account: "Channels" tab > select the Google channel > click on "Activity".

Errors

To help you correct these errors:

Google Shopping

Google Actions

Please read our guide “Google Actions: Errors that may occur”.

Edit a product file

Contact your Google account manager to edit this data.

Data is automatically updated as soon as the offer feed is sent out.

Unpublish/Delete an offer

1. Unpublish

  • Case #1: Only one Google service is activated for your catalog and you want to unpublish on or many product.s from this service

Case #1.A: The activated service is Google Shopping Actions

Fill in the "sellOnGoogleQuantity" field with 0. Use a rule to apply this un-publication to all or part of your catalog.

or

Fill in the "availability" field with the value "out of stock". Use a rule to apply this un-publication to all or part of your catalog.

Case #1.B: The activated service isn't Google Shopping Actions

Fill in the "availability" field with the value "out of stock". Use a rule to apply this un-publication to all or part of your catalog.

  • Case #2: Several Google services are enabled for your catalog and you want to un-publish your products from only one of these services (and continue to display them on other services).

Fill in the field "destinationName. ..." corresponding to the service on which you want to un-publish the product.s with the value "Yes". Use a rule to apply this un-publication to all or part of your catalog.

In the Preview tab, the “1”value indicates that the product won’t be displayed on the service. The “0” value indicated that the product will be displayed on the service.

Example: I want to un-publish my products from Google Shopping Actions and I want to keep displaying them on other services. Fields will have to be filled in this way in the Preview:

  • destinationName.Shopping: 0
    It means the product will be displayed on Google Shopping
  • destinationName.ShoppingActions: 1
    It means the product won’t be displayed on Google Shopping Actions
  • destinationName.google_display_ads: 0
    It means the product will be displayed on Google Display Ads

2. Delete products

For all services:

Currently, Lengow doesn’t offer to delete products on the Google Merchant Center.

Manage your Google Shopping Acitons orders

You can manage your orders in the Lengow platform.

1. Order retrieval

Lengow retrieve orders every hours.

2. Order processing

Orders go through various statuses in Lengow while being processed.

3. Statuses of Google Shopping Actions orders

Lengow retrieves the orders with status "Waiting Shipment".

Here is the list of Google Shopping Actions statuses corresponding to orders statuses in Lengow and actions you could realise at the different steps:

  • New order

NEW” : The order is being processed on Google side. A fraud check is performed. The buyer has the option to cancel the order.

  • Waiting shipment

"SHIPPING": Order is awaiting for shipment. During this status, you can confirm the shipment of the order and enter the parcel tracking number.

You can also cancel the order shipment and indicate:

  • The reason for this cancellation, using the list of values ​​available in Lengow. (At the product line level or for the whole order)
  • The quantity of products you want to canceled (At the level of the produced line only). Leaving the field empty, the total volume is taken into account.
  • A comment if you want to. (At the product line level or for the whole order).

 

  • Shipped

"SHIPPED": "sent". Order has been sent and shipment is in progress.

During this status, you can make a refund (if the product has been returned for example).

Indicate:

- The reason for this refund,
- Choose if you refund shipping fees,
- A comment if needed,
- The quantity of products refunded if necessary (at the product line only).

The refund is applied to the total amount of the product (no partial refund of a product).

  • Cancelled

"CANCELLED": order cancelled by merchant or customer during the “SHIPPING” status.

  • Refunded

"REFUNDED": order has been refunded.

Contact

Your Google account manager.

Useful links

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request