Troubleshooting Guide
Solutions to common issues when integrating and using the OIR SDK.
// Verify SDK is loaded
console.log('SDK available:', typeof window._oirtrk !== 'undefined');
// Check SDK version
if (window._oirtrk?.version) {
console.log('SDK version:', window._oirtrk.version());
}
Open browser DevTools → Network tab and filter for:
/evt- Event tracking requests/ack- Identity requestsaggle- All SDK requests
Look for error messages in the browser console related to SDK initialization or network requests.
Symptoms:
window._oirtrkis undefined- Events are not being tracked
Solutions:
-
Verify Script Tag
<script type="text/javascript">
!(function (s) {
var o = s.createElement('script'),
u = s.getElementsByTagName('script')[0];
o.src = 'https://cdn.aggle.net/oir/oir.min.js';
o.async = !0;
o.setAttribute('oirid', 'your-oirid');
o.setAttribute('oirtyp', 'your-oirtyp');
u.parentNode.insertBefore(o, u);
})(document);
</script> -
Check CDN Availability
- Verify CDN URL is accessible
- Check network connectivity
- Ensure no ad blockers are blocking the script
-
Add Error Handling
o.onerror = function () {
console.warn('OIR SDK failed to load');
};
Symptoms:
- Events are queued but not sent to server
- No network requests in DevTools
Solutions:
-
Check Configuration
Verify your configuration is set correctly using either method:
Via Script Attributes:
<script>
o.setAttribute('oirtyp', 'YOUR_INTEGRATION_TYPE');
o.setAttribute('oirid', 'YOUR_INTEGRATION_ID');
</script>Via cfg() Method:
window._oirtrk.cfg({
oirid: 'YOUR_INTEGRATION_ID',
oirtyp: 'YOUR_INTEGRATION_TYPE',
}); -
Verify Credentials
- Ensure
oiridandoirtypare set correctly in either script attributes or cfg() - Check for typos in both attribute names and values
- Ensure
-
Check Network
- Verify endpoint URLs are accessible
- Check for CORS issues
- SDK script correctly added to HTML
-
oiridandoirtypconfigured - No ad blockers blocking the script
- No console errors
- Network requests visible in DevTools
- localStorage available
- HTTPS enabled (production)
Before contacting support, gather this information:
- Browser and version
- SDK version (
window._oirtrk.version()) - Console errors (full stack trace)
- Network request details
- Steps to reproduce
Contact your account manager with this information.