Onboarding Guide

Troubleshoot your feed

Next: Overview of Merchant Eye'due south product data specification

Troubleshoot your feed [hero image]

At times, you lot may demand assistance troubleshooting your feed. Our goal is to provide answers to specific issues that y'all might encounter when using feeds and Google Merchant Middle.

Review feed processing results

You're able to review the results of all feed processing for file-based or Google Sheet-based feeds. To find the results:

  1. Sign in to your Merchant Center account.
  2. From the navigation menu, click Products, then click Feeds.
  3. Click the primary or supplemental feed name yous'd similar to review.
  4. Review the results:
    • Properties: Includes key feed backdrop, which vary depending on the input method of the feed. Hither, you can find attributes such as input method, timezone, filesize, detected delimiter (if applicative), and more.
    • Attributes: Your feeds need to adhere to the product information specifications for the programs you're opted into. In this section, you tin review all of the attributes we found in your feed, including those attributes which are recognized and map to the feed specification, and also unrecognized attributes which do not match ane listed in the product data specification. You lot may review the list and use tools such as feed rules to tell Merchant Center which unrecognized attribute y'all would similar to use to populate a Google attribute. For instance, you may desire to utilize "product proper name" in the title [championship] attribute.
    • Processing data: In this section, you tin review the amount of items found in your feed, as well as those with any detected item issues. Review the list of detail issues to understand how many items in your feed are impacted, including examples and links to documentation to address the result.

If your business relationship has been disapproved and your feeds seem to be correct, delight view consolidated event reporting for the Shopping product data across your account, feeds, and items in the "Diagnostics" page, located under "Products".

Notation: Processing only checks for basic file and data issues. To meet all problems, become to Diagnostics.

Troubleshoot your feed | Feed creation issues [icon] Feed creation issues

  • Forgotten attribute: Your feed may be missing a required attribute. The ID [id] attribute is one of the nearly usually forgotten attributes, so always check information technology first.
  • Incorrect formatting: Click any of these links for instance files that show what a feed should look like in these formats.
    • Tab delimited (.txt)
    • RSS 2.0
    • Cantlet ane.0
  • We currently don't allow feeds in .xls format. If you lot created a feed in .xls format, learn how to convert information technology to a .txt file.

Troubleshoot your feed | Feed registration issues [icon]Feed registration issues

  • Country of sale: Specify the principal location where your items are sold. For example, if y'all specify "United States" as your land of sale, this indicates that your items are available for purchase in the United states of america. The production data uploaded to a selected country must encounter the requirements for that land, including the feed specifications and policies.
  • Multiple countries: Specify multiple countries of sale if you lot sell the same product in multiple countries. Ensure your products run across the requirements for each country, including the feed specifications and policies.
  • Information feed file proper name: RSS and Atom files should end with an .xml extension. Filenames that don't end with any extension will exist processed every bit a tab-delimited file past default and should finish with (.txt). Think that we do not take files in Excel format. Meet converting your spreadsheet for help.
  • When using filename extensions like .aught or .gz, you must ensure that the file is compressed because our arrangement assumes that the file is compressed. Uploading an uncompressed file in this case may cause feed failure. Delight make sure that the compressed archive contains exactly one file.

Please notation, when editing your information feed settings we recommend you leave "autodetect" every bit the selected option unless a specific problem needs to be addressed.

Troubleshoot your feed | Formatting issues Formatting problems

  • Text or tab-delimited
    • If yous are using previously formatted text (anything with line breaks or quotations), make sure your feed has quoted attributes turned on.
    • Make sure that your columns (tabs) with the required attributes correctly match all the items; often there will be either an actress tab or a missing tab.
    • If you're using Google Sheets, the Google Merchant Middle add-on can aid you validate your data.
  • XML
    • You cannot include un-escaped special characters like "&".
    • Your aspect names may not contain capital letters, any capitalization in your attribute names should exist removed. For case, the title [title] attribute should be entered every bit <title>, instead of <Title>.
    • Incorrect encoding sometimes occurs. Be sure to encode your file in the accepted formats.

Troubleshoot your feed | Upload issues [icon]Uploading issues

  • Your feed may be too large for the upload method you're using.
    • Direct upload files must exist less than 4 GB in size. (If you're encountering an "oops" bulletin from this method, please wait a few hours and try again.)
    • SSH File Transfer Protocol (SFTP) and File Transfer Protocol (FTP) files must be less than four GB in size.
    • Files set for scheduled fetches must be less than 4 GB in size.
  • Commonly, automatic uploads fail because:
    • The URL used for scheduled fetch is roboted or does not have permission settings for Merchant Eye to download the information feed.
    • The URL used for scheduling is not working or redirects to a page that doesn't contain the data feed.
  • Compressed files must be smaller than 500 MB.

Hither are some of the near common errors encountered using SFTP and FTP.

Issue Solution
Server not found error

For FTP, verify you're signing on to ftp://uploads.google.com. If yous're using an FTP client, remove ftp://; and employ uploads.google.com.

For SFTP, verify you lot're signing on to {sftp username}@partnerupload.google.com with a specified server port of 19321. If you're using an SFTP customer, you may need to prefix the host name address with the 'sftp://' protocol (for example, sftp://partnerupload.google.com).
Username or countersign incorrect Click hither for assist with SFTP and FTP login issues.
"Can't build data connectedness" or "FTP folder mistake" You lot will demand to upload using passive FTP.
"Filename not allowed" error Ensure that your filename does not comprise spaces. The name of your file should exactly match the name of the filename you registered in your account.
You don't have a data feed registered with this proper noun Ensure that the name of the file you're submitting via SFTP or FTP exactly matches the file proper noun provided when registering your data feed.
"FTP connexion reset by peer" error The Cyberspace connexion to our FTP server was lost. Please try uploading your file once more. If your file is nether 200 MB in size, you can also upload your file directly through the Google Merchant Middle information feeds page. If your file is larger than 200 MB, try splitting your information feed into multiple files smaller than 200 MB. The smaller file size will allow you to upload your files through your dashboard.

For specific problems with SFTP and FTP not answered within this page read this article.

If you lot created your feed using i of the upload methods and would like to review it during your investigation, follow these steps to download it. Notation that there is no file to download for Content API feeds.

  1. Sign in to your Merchant Heart account.
  2. Select Products from the left-hand navigation card, so click Feeds.
  3. Under the "Feed" column, click the feed name.
  4. Under the "Processing" tab, click the iii-dot icon 3 dot icon on the far right.
  5. Select the pick to Download file.

Note that simply users who belonged to the merchant account at the time the file was uploaded take the right privileges to download the feed.

You'll be able to download a CSV report detailing processing errors and warnings subsequently you've uploaded your feed. When a report is bachelor, you'll meet an pick to download the study in the feed summary page next to the "Download file" button. The report will contain identifying information for errors at the summit, followed past a table with details on private items and their feed errors and warnings. Please note that the study will only exist bachelor for 14 days later you've uploaded your feed and will but particular up to 100,000 errors and warnings combined.

You may besides exist able to use feed rules to correct missing or incorrectly formatted attributes in your feed without editing its content.

Was this helpful?

How tin we improve it?