What is Debug mode used for, and when should I use it?

Debug mode displays OpenAI Ads SDK activity in the browser console. It lets you check that the Pixel is loaded, events are triggered, and the expected information is sent when actions are completed in your shop.

Use it temporarily when installing tracking or investigating a measurement issue. It is intended for technical checks, not for permanent use in your shop.

What Debug mode displays

When this mode is enabled, SDK activity is displayed in your browser’s developer console. This can help you check that the Pixel is loaded, initialized with the configured Pixel ID, and sending events when they occur.

To view this information, open your browser’s developer tools, then select the “Console” tab. Next, perform the action you want to test in your shop, such as viewing a product, adding an item to the cart, or completing an order.

When should I enable Debug mode?

Enable Debug mode in the following situations:

• after configuring or changing the Pixel ID;
• after enabling the Pixel or the Conversions API;
• when expected events do not appear to be received;
• after changing the theme, checkout process, or consent management tool;
• when you want to confirm that an event is triggered at the correct time.

Debug mode makes it easier to identify a configuration or triggering issue before continuing your checks in OpenAI Ads Manager.

Important: events are still real

Debug mode does not prevent events from being sent to OpenAI. Events sent while debugging is enabled remain real events and may be used for conversion measurement according to your configuration.

If you want to test event structure without recording actual conversions, use the “Validation only” option instead. This mode is different from Debug mode.

See our FAQ What is Validation mode used for, and when should I disable it? to understand the difference.

Disable Debug mode after testing

Disable Debug mode as soon as you have confirmed that the integration works correctly. This option adds technical information to the browser console and is no longer needed once testing is complete.

To understand the role of the Pixel, see our FAQ What is the Pixel used for, and why should I enable it?. You can also refer to the official OpenAI Ads Measurement Pixel documentation.