Troubleshooting
Issues you may encounter and potential solutions.
Consent Modal Not Showing
Possible Causes:
- Incorrect
guiOptionsconfiguration. - SDK not properly initialized.
Solution:
- Double-check the
guiOptionsconfiguration to ensure the modal is correctly set. - Verify that the SDK is initialized with the correct parameters.
- Check the browser's console for error messages.
CSS Issues or Not Applying Correctly
Possible Causes:
- CSS variables are not correctly overridden.
- CSS conflicts with other project styles.
Solution:
- Ensure that the CSS variables are overridden correctly according to the documentation.
- Use the browser's Developer Tools to inspect and fix CSS conflicts.
Unable to Save User Consent
Possible Causes:
- Incorrect storage configuration.
- Restricted access to cookies or localStorage.
Solution:
- Ensure that you have set the correct storage configuration in the SDK.
- Check the browser settings or security policies to ensure cookies/localStorage are enabled.
SDK Fails to Load
Possible Causes:
- Incorrect path to the SDK file.
- Network connection issues.
Solution:
- Verify the path to the SDK in your configuration file.
- Ensure there are no network or firewall issues preventing the file from loading.
Interface Incompatibility on Some Browsers
Possible Causes:
- Certain CSS/JavaScript features are unsupported on older browsers.
Solution:
- Check the list of supported browsers in the documentation.
- Update the browser to the latest version.
- Add polyfills for unsupported features if necessary.
"Missing or Invalid Credentials" Error
Possible Causes:
- Missing or invalid login credentials (
url,key,trackingId). - The
urlis incorrect or the Kalapa CMP server is unreachable.
Solution:
- Double-check the login credentials:
- Ensure that all fields (
url,key,trackingId) are filled in correctly.
- Ensure that all fields (
- Verify that the
urlis a valid Kalapa CMP server address. - Confirm that the
keyandtrackingIdmatch the information provided by Kalapa. - If the issue persists, contact Kalapa support to verify your login credentials.
"Unauthorized Access" or "Invalid API Key" Error
Possible Causes:
- Invalid or expired API key.
- Your account does not have permission to access the Kalapa CMP system.
Solution:
- Ensure the
keyused is a valid API key provided by Kalapa. - Contact Kalapa to verify the status and permissions of your account.
- Request a new or renewed API key if needed.
Unable to Connect to Kalapa CMP Server
Possible Causes:
- Incorrect
urlor network accessibility issues. - Kalapa CMP server is down or blocked by a firewall.
Solution:
- Verify the
urland ensure it matches the one provided by Kalapa. - Check if your network allows access to this
url(not blocked by a firewall or network policy). - Check the status of the Kalapa CMP system. If necessary, contact support for confirmation.
Tracking ID Issues
Possible Causes:
- Missing or incorrect
trackingIdfield.
Solution:
- Verify the value of
trackingIdand ensure it matches the ID provided by Kalapa. - If you're unsure about the
trackingId, contact Kalapa for assistance.
If these issues persist, please contact Kalapa support for timely assistance.