Errors and Solutions

This guide contains the most common errors when using the WPify Woo Zbozi.cz Conversions plugin and steps to resolve them.

Conversion Tracking Errors

Conversions are not being tracked

Cause: The Shop ID or Private Key is missing or incorrect.

Solution:

1. Go to WooCommerce → Wpify Modules → Zbozi.cz/Sklik Conversions
2. Verify that Shop ID and Private Key are filled in correctly
3. Check the order notes — the plugin adds a note when a conversion is sent or when an error occurs
4. If using sandbox mode, make sure to check the sandbox Zbozi.cz environment

Conversion tracking error in order notes

Cause: The Zbozi.cz API returned an error.

Solution:

1. Check the error message in the order notes
2. Verify your Shop ID and Private Key in the plugin settings
3. If the error mentions a network issue, try enabling Send asynchronously — this retries the request via WooCommerce Scheduled Actions

Frontend conversion script not firing on thank you page

Cause: The conversion script may be blocked by cookie consent settings or a caching plugin.

Solution:

1. Check if the marketing cookie consent is configured correctly — if cookie name/value are set but the customer hasn’t given consent, the script runs with consent: 0
2. Disable page caching for the order-received (thank you) page
3. Open the browser console and look for “Zboží.cz conversionConf” log message

Opt-Out Errors

Opt-out checkbox does not appear in checkout

Cause: The opt-out feature is not enabled in settings.

Solution:

1. Go to plugin settings → Satisfaction questionnaire tab
2. Enable Enable Opt-Out
3. Fill in the Enable Opt-Out Text

Shipping Method Mapping

Shipping methods are not shown in settings

Cause: No shipping zones or methods are configured in WooCommerce.

Solution:

1. Go to WooCommerce → Settings → Shipping and add shipping zones with methods
2. Return to the plugin settings → Shipping methods tab — the methods will appear

Frequently Asked Questions (FAQ)

What is the difference between backend and frontend conversion?

The plugin sends conversions in two ways:

• Backend — server-to-server API call to Zbozi.cz when the order is created. This is the primary tracking method and includes order details, shipping type and optionally the customer email.
• Frontend — JavaScript on the thank you page that triggers the Zbozi.cz/Sklik conversion pixel. This is used for browser-based tracking and respects cookie consent settings.

Do I need both Shop ID and Sklik ID?

No. Shop ID is required for Zbozi.cz conversion tracking. Sklik ID is optional — fill it in only if you also want to track Sklik.cz conversions.

Does the plugin work with block checkout?

Yes. The opt-out checkbox is displayed in both classic and block checkout. Backend conversion tracking works with both checkout types.

What happens if cookie consent is not configured?

If you don’t configure the marketing cookie name and value, Zbozi.cz will process all conversions as if consent had been given. Configure the cookie settings to comply with GDPR.