Product sales
How to troubleshoot catalog match rate issues
This guide aims to assist you in understanding and diagnosing match rate issues for better Video Shopping Ads (Catalog) performance.
Before getting started:
SKU ID is the unique ID that identifies each product in your catalog.
Content ID is the parameter that identifies the individual product. The value of this parameter should be the same as the SKU ID of the product in your catalog.
If you are facing trouble viewing your match rates or if your match rates are below optimal levels, refer to the following recommendations to resolve them.
Check that your pixel or app is connected to your catalog.
Make sure your catalog and pixel or app are owned by the same Business Center account. Otherwise, you may grant partner access to your Business Center account to share your catalog and pixel or app access.
You must have admin access to your Business Center account or Pixel Editing permission for the pixel or app. Learn more about user roles and permissions in Business Center.
Make sure that your app or pixel is successfully set up in Events Manager and the required event types (View Content, Add to Cart, and Complete Payment) are sent to your Mobile Measurement Partner (MMP) platform.
Check that the required parameters (content_ID, quantity, price, currency, value) are being sent.
Make sure that the content_ID of your events is enabled on your Mobile Measurement Partner (MMP) platform.
Note: Match rates will not be reflected if your pixel or app does not pass back any events in the past 7 days.
Check if any Content_ID parameters are missing.
To extract a list of affected events to validate, go to Catalog Manager and select Event Sources. Click your connected pixel or app and select Export events without content ID.
Check that your content_ID parameter is in the proper format by ensuring the following. Learn more about the proper format of TikTok Pixel parameters.
Ensure the correct spelling is used for parameter names. For example, the content ID parameter should be spelled as content_id instead of content_ids.
Avoid the use of commas to separate multiple product information. Enter your content_ID parameter as:
Single item as {content_id: '12345'}
Multiple item as {content_id: '12345'},{content_id: '67890'}
Avoid the use of unnecessary symbols and spaces between characters.
Ensure that all events are sent through the required parameters in all cases by by using the Test Events, Pixel Helper tools or by inspecting your landing page. Please note that events that have been set up using Event Builder will not send back any parameters. Only Custom Code events, Events API, or partner integration events support parameters.
Check if there's a mismatch of content ID with your catalog.
To extract a list of affected events to validate, go to Catalog Manager and select Event Sources. Click your connected pixel or app and select Export content IDs that don't match with this catalog.
Check that your catalog contains the item that your pixel or app is passing back events with TikTok. This can be done by ensuring that a product source is connected and the products are updated on a daily basis.