Troubleshooting images in ad banners

Product images sometimes fail to show up properly on banners. When this happens, you'll either see empty spaces where the images should be, or you might see question marks instead of the actual product images.

This can happen due to multiple reasons like:  

  • Image file compatibility issues with ImageProxy

  • File size exceeds system limits   

  • Temporary server issues  

  • Incorrect Criteo IP address whitelisting configuration

  • Server-side throttling 

  • Restrictions on cURL requests 

Preliminary Checks

Before going through the full troubleshooting process related to ImageProxy or Whitelisting, there are a few preliminary checks that you can perform: 

  1. Verify the design set configuration, paying special attention to Data Mapping settings. 

  1. Review your Catalog Statistics and Quality Score for any unusual data indicating temporary issues. 

  1. Test load times for random catalog images:

    • Open several images in new browser tabs 

    • Any images taking near or over 2 seconds to load will likely fail ImageProxy's 4-second timeout limit 

  1. Examine the browser’s console when loading banners with missing images:

    • Note any error messages 

    • While 404 errors from ImageProxy servers are common but unhelpful 

    • Other error codes (or no errors) can help direct investigation 

  2. For suspected cache-related issues (e.g., identical images loading inconsistently):  

    • Try adding a "cache buster" parameter 

    • Use a field transformer in catalog configuration to add parameters (like "?cb=1") to image URLs 

    • Relaunch the import after making changes