The Diagnostics section in Catalog Manager provides a comprehensive reporting system for your feeds and items, organizing them based on their context for product data display. With integrated and holistic reporting capability, it highlights products with eligibility and data accessibility issues, and offers actionable insights into data quality and compatibility. With guided recommendations, this provides you with a clear understanding of the status of your product data, making it simpler to spot and fix catalog issues.
The article details the different catalog issues and how to utilize the Diagnostics features to view and resolve them.
How to view and troubleshoot catalog issues
Before you begin: Ensure that you have created and added products to your catalog. Learn more about how to create and manage products in Catalog Manager.
View product status
Diagnostics helps you to monitor the trends and status of your products in your catalog.
Go to Catalog Manager and then select Diagnostics
Select your preferred time period to monitor the trend of each product status below:
Total Products - The number of products uploaded
Available Products - The number of products that were approved in review. This may decrease while products are being verified or reviewed.
Active Products in Ad Delivery - The number of products in ads you have been running in the past 1 day. This may decrease because products automatically expire after 30 days or on the set expiration date.
Troubleshoot catalog issues
Diagnostics also allows you to identify a list of catalog issues and provide recommendations on how to resolve them.
Go to Catalog Manager and then select Diagnostics
Filter catalog issues for focused troubleshooting
Filter catalog issues by Issue Type
Error: Issues that affect your ad performance and must be resolved.
Warning: Issues that may have some impact on your ad performance and are recommended to be resolved.
Filter catalog issues by Issue Category
Product attributes issue
File or feed upload issue
Product review issue
Catalog issue
Filter catalog issues by Feed
Click the Download button to export a full report of your catalog issues and affected items into a CSV file to troubleshoot. Alternatively, you can also click the Download button of each catalog issue to export an issue-specific report.
Library of Product Issues and Suggested Action
1. Product attribute issue
Error Name & Description | Suggested Action |
IDs cannot be duplicated | Check that your IDs are not duplicated, such as SKU ID. If multiple of the same ID is entered, only one product with that ID will be reflected. |
Image is less than 500x500 pixels | Check and update the link to an image that is at least 500x500 pixels |
Image link is invalid and the image information cannot be downloaded | Check and update the image link. It must end with .jpeg or .png. |
Invalid or inaccurate product link | Check that product links are active and aren't misspelled. They must begin with https:// or http://. |
Product link cannot be accessed | Check that access to your product links is not restricted |
Product price and page price are inconsistent | Make sure the product price matches that of the landing page |
Product inventory and page inventory are inconsistent | Make sure product inventory information matches that of the landing page |
"'Item group ID" missing | Check and add 'Item group ID' to relevant products |
'Additional image link' missing | Check and add 'Additional lmage link' to relevant products |
'Product type' missing | Check and add 'Product type' to relevant products |
'Google product category' missing | Check and add 'Google product category' to relevant products |
'GTIN' missing | Check and add 'GTIN' to relevant products |
Emojis and control characters are not allowed | Remove emojis or control characters |
Image download failed due to server | Please re-upload the image or update the image link |
Bad format of feed file or link | Please update the file format to CSV, XML, TSV, GZIP and check the accuracy of the feed link |
2. File or feed upload issue
Error Name & Description | Suggested Action |
|---|---|
Incorrect feed file or link format | Check the feed link and upload a file that is in CSV, XML, TSV, or GZIP format. |
TikTok doesn't have permissions to access the image information hosted on your server. | - Make sure the URL in feed or file is linked to a downloadable file. You can try opening the URL in your browser. - Check that your username and password are set up correctly. - Check that the following IP addresses are whitelisted on your image hosting site's server: -- 103.136.220.238 -- 103.136.220.239 -- 103.136.221.238 -- 103.136.221.239 -- 3.225.193.57 -- 34.196.227.34 |
TikTok doesn't have permissions to access the product information hosted on your server. | - Make sure the URL in feed or file is linked to a downloadable file. You can try opening the URL in your browser. - Check that your username and password are set up correctly. - Check that the following IP addresses are whitelisted on your platform's server: -- Singapore Region 103.136.220.237 103.136.221.237 -- Germany Region 3.124.7.171 18.198.252.115 |
Selected feed/ file is empty or does not contain required information. | Check to make sure the feed or file contains required fields in a valid format. |
Incorrect number of columns | Check to make sure the product information of your items in your feed or file matches the same number of required columns. |
3. Product review issue
Error Name & Description | Suggested Action |
|---|---|
Product was disapproved due to prohibited content. | Make sure your product information follows TikTok guidelines. If you believe this is a mistake, you can submit an appeal to review your products. |
4. Catalog issue
Error Name & Description | Suggested Action |
|---|---|
This catalog is frozen due to a lack of advertising activity in the last 28 days. This can slow and eventually halt the review of your products. | Create a new ad campaign to resume product review. |
This product feed hasn't been updated in the last 7 days. | Update this feed manually or schedule regular updates. |
This catalog is not bound to pixel or app. | Please go to the event source page to connect your pixel or app to your catalog. |
Tips for resolving catalog issues
Ensure your product information follows the required guidelines to minimize the number of issues when uploading products into your catalog. Learn more about the requirements of catalog product parameters here.
Aim to resolve all catalog issues to allow for a wider selection of items to be delivered and showcased to your audiences. This maximizes the potential of your catalog and optimizes the performance campaigns. Learn more about the best practices for a high quality catalog.