Troubleshoot Catalogs

We recommend checking that your catalogs are working as intended regularly. Troubleshooting your catalog will let you know it's showing the right audience the correct ads. If you don’t do this, you may experience ad delivery challenges.

To find and fix issues, go to Catalogs, choose your catalog, and select Diagnostics. Your statuses will be split across these sections:

• Import overview: Check the status of your latest import and any errors that may have occurred. You can expand a row or download a summary of the changes.
• DPA readiness: Understand the accuracy of product metadata in your conversion events. We recommend using this status to enhance the quality of your dynamic product ads (DPAs).
• Product diagnostics: See if your products have been approved for ads and troubleshoot ejected ones.

Import overview

You can determine if your catalog has errors to resolve based on the import status:

Status	Description
Complete	No further steps are required.
Complete with errors	At least one row wasn't successfully ingested. We recommend fixing the issue or products with errors won't be served.
Failed	None of the rows were added or updated, and your catalog won't be served.
Processing	The import is in progress. Wait and try again later to view potential errors.

Select the status to open the import overview.

Expanding a row will show more details on the error detected. You can hover over the ID to show the product’s untruncated ID.

We recommend resolving as many catalog issues as possible to ensure a high-quality catalog and maximize product selection for your product ads and DPAs. You'll need to update your catalog to fix most issues. 

Contact support if any errors persist.

Product diagnostics

Product diagnostics lets you see which products have been approved for ads and troubleshoot any issues. 

Issues are split into these categories:

• Error: Your product has a critical misconfiguration that must be resolved before you can use it for ads.
• Warning: Your product has a misconfiguration, but it can still be used for ads. However, we strongly recommend fixing this issue to ensure accurate metrics.

Expand the issue to see more details on the product that is being affected.

Common errors

General errors

Error	Description	Solution
Internal Server Error	We are unable to process the request right now.	If a username and password are required, update your feed with the correct credentials. Sync Feed: In the Catalogs Manager, select a catalog and open the Settings tab. Set your Feed URL then save your changes. Bulk Import: Update your bulk import catalog. When finished, wait then try again.
Catalog stuck on “processing” for a long time	The catalog import status is still pending after typical upload times.	Re-import the feed.

Feed file errors

Error	Description	Solution
File is inaccessible	We can’t access the feed from the URL you’ve provided. Ensure the URL is correct and try again.	Check your URL and verify it with your feed vendor if necessary.
Feed can’t be authorized	We aren’t authorized to access the feed you’ve provided.	Ensure you have shared the correct password with us if the file is password protected. Otherwise, ensure the file is publicly accessible.
File size exceeded	The product feed file size is greater than 15 MB.	Reduce the size of the file and re-import the feed.
File format is invalid	The product feed file is formatted incorrectly.	Check that the file is saved as a CSV and contains proper and escaped delimiters, enclosed quotes, and correct line breaks. You’ll see .csv at the end of the URL for data feeds.
File is empty	The product feed file contains no contents.	Ensure the file isn’t empty and update it.
File header is invalid	The product feed file does not contain a required column or isn’t formatted correctly.  Sometimes, feeds generate all the fields in the first cell, making it look like it’s correctly formatted when it isn’t.	Verify your feed file follows the specifications and Reddit template, ensuring all the required columns are included in the file.
File encoding is invalid	The product feed file isn’t encoded correctly.	Verify that the file is encoded in UTF-8, ASCII, ISO-8859-1, CP-1252, Windows-1251, or Latin-1. If it isn’t, update the file encoding and re-import the feed.

Image errors

Error	Description	Solution
Unable to process image	AMD retried fetching without success and gave up with a failed status. This commonly happens when the image URL is in the wrong format.	Verify that image_link is available at the provided URL and the correct permissions have been set.
Image is invalid	The product image doesn’t meet our specifications.	Check that image_link meets our specifications and an image is being hosted at the URL.
Image is rejected	The product image couldn't be uploaded because it doesn’t comply with our content guidelines.	Ensure the rejected images don’t contain inappropriate content. If you believe products were incorrectly rejected, contact Customer Support. Pending the reason for rejection, Customer Support can overturn product rejections through a certain limit.

Product errors

Error	Description	Solution
{{Product field}} is invalid	Learn more about this issue.	Learn more about this issue.
Product ID, title, description, link, image link, or price is missing	The field was missing for this product.	Ensure you’re including all of the required fields in your catalog.
Products are not available for selection when creating a product ad	The product was rejected because it doesn’t comply with our content guidelines.	Ensure you haven’t uploaded restricted or prohibited products. If you believe products were incorrectly rejected, contact Customer Support. Pending the reason for rejection, Customer Support can overturn product rejections through a certain limit.

Product field is invalid

The product field is invalid. This may happen because of several reasons:

Issue	Solution
Field length is too long.	Shorten the length of this field.
Link doesn’t start with HTTP or HTTPS or doesn’t comply with RFC 2396 or RFC 1738.	Re-format the fields.
Price and/or sale price isn’t provided in the correct format (a numeric value, followed by a space, followed by a valid currency code).	Provide the price and sale price in the correct format. These are examples of valid prices: 20.55 USD, 18.00 CAD, 55 EUR.
The currency code is different between at least two fields.	Set the same currency code for price and sale price.
Field appears to contain HTML.	Remove any code or script from the field.