Product Images in Dynamic Creatives
In Dynamic Banners, product images are loaded by the Image Proxy infrastructure, which downloads the images from the URL provided in the product catalog.
A common issue is that some or all product images fail to display in the banners. This article will help you understand the potential causes of this issue and provide guidance on how to address it.
Potential Causes
When product images fail to load in dynamic banners, you might encounter one of the following two issues:
Some images aren't displayed: This issue is relatively rare and typically occurs due to problems with the image file itself, such as:
Unsupported file types (add example or add guide link with supported formats)
Image files that are too large to process (add max size)
Temporary issues with the client's server (such as server downtime or connectivity issues)
No images are displayed at all: This is the more common issue, where no product images are visible in the banner. The possible causes for this issue include:
Improper Criteo IP address whitelisting: If the Criteo servers are not whitelisted in the client's firewall, the images will not be accessible.
Throttling: If the client server is throttling or limiting requests (e.g., rate limiting), the image proxy may not be able to fetch the images in time.
Restrictions on cURL requests: The server might block outgoing cURL requests, preventing the Image Proxy from retrieving the images.
In banners where product images are missing, you may see empty containers where the image should be or, in some cases, a question mark icon as a placeholder.
Troubleshooting Product Image Issues
To troubleshoot missing product images in banners, consider the following steps:
Check the Image File
Ensure the image file is of an appropriate type and size. The Image Proxy supports common formats like .jpg, .png, and .webp. - needs review
Check if the image file size exceeds any limits enforced by the Image Proxy or the client's server.
Verify IP Whitelisting
Ensure that Criteo's IP addresses are correctly whitelisted on your server. Without this, the image proxy cannot access your product images.
Check for Throttling or Restrictions
Review the server logs to check if any throttling or rate-limiting rules could be preventing the Image Proxy from fetching images.
Verify if cURL requests are blocked on the server side. If they are, you may need to adjust server configurations to allow outgoing HTTP requests.
Use the Correct Preview Tool
When troubleshooting, use the TOP Creative Preview V1 or Globan to preview live banners. These tools render the banners using the same pipeline as live impressions.
Design Tool Preview uses a separate rendering pipeline and should not be relied upon to replicate the live banner experience.