Dynamic Ads Debugging Tools

This document covers tools to aid developers in debugging the issues with dynamic ads. All these tools are available within business manager.

Product Catalog Debug Tool

The Product Catalog Debug Tool gives you an overview of all the things happening with your product catalog. It takes a business, ad account, ad campaign, ad set or ad ID and shows you an overview of all the dynamic ads related objects and associations.

Business Info

Once you enter an ID, the tool will resolve it to the business that owns the ad account connected to this ID. Then it will list all the objects such as pixels, product catalogs, pages and ad accounts that are owned by the business.

Setup Checklist

The setup checklist section of the tool automatically detects the steps that are missing from the Dynamic Ads setup and lists them in order. It also lists permission errors for the current logged in user if there are any.

Dynamic Ads

The Dynamic Ads section lists all the ad campaigns, ad sets and ads that are dynamic ads. It lists the audience ID connected to each ad and will also show the estimated audience size.

This section also allows you to preview ads directly by selecting products from the product set and sending the previews to your desktop or mobile feed. In the preview window, select the products you want to preview from the drop down on the right and then select the option to "View in Newsfeed" to inject the ad into your desktop feed.

Only ads that are targeted to mobile will have the option to view preview on mobile newsfeed.

Product Sets

The Product Sets section lists all the product sets within the product catalog. There is a "Debug" link that shows the product set creation params and this debugger helps you look up if a product belongs to that product set. In the debug window, enter the product ID that you want to lookup and the tool will tell you if this product ID belongs in the selected product set.

The Top Products link helps you understand the list of products that will get picked from the product set to be shown in a multi product ad format.

Retargeting Pixel Debug Tool

The Retargeting Pixel Debug Tool helps you debug the issues specifically related to retargeting. Once you enter the pixel ID, the tool will report all the ViewContent, Purchase and AddToCart events.

You can also use this tool to see all the events fired for your user ID for the specified pixel ID. So you can visit a product page on your website that fires pixel events for the specified pixel ID and double check if those pixels fires were registered correctly when you visited that page.

Furthermore, to help with debugging retargeting audiences, this tool allows you to enter an audience ID and check whether you have been included. This allows you to make sure the audience rules are setup correctly and you are being correctly matched.

Product Feed Debug Tool

The Product Feed Debug Tool allows you to paste in a product feed, and validate the feed for errors and warnings without adding any products to your Catalog. This is helpful in the early stages of integrating Dynamic Ads by being able to discover wether current feeds you may already have are supported by Facebook.