Skip to content
  • There are no suggestions because the search field is empty.

Troubleshooting Guide

Solutions to common issues when integrating and using the OIR SDK.

 

Quick Diagnostics

Check SDK Status

// 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());
}
 

Check Network Requests

Open browser DevTools → Network tab and filter for:

  • /evt - Event tracking requests
  • /ack - Identity requests
  • aggle - All SDK requests

Check Console Errors

Look for error messages in the browser console related to SDK initialization or network requests.


Common Issues

SDK Not Loading

Symptoms:

  • window._oirtrk is undefined
  • Events are not being tracked

Solutions:

  1. 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>
     
  2. Check CDN Availability

    • Verify CDN URL is accessible
    • Check network connectivity
    • Ensure no ad blockers are blocking the script
  3. Add Error Handling

    o.onerror = function () {
    console.warn('OIR SDK failed to load');
    };
     

Events Not Sending

Symptoms:

  • Events are queued but not sent to server
  • No network requests in DevTools

Solutions:

  1. 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',
    });
     
  2. Verify Credentials

    • Ensure oirid and oirtyp are set correctly in either script attributes or cfg()
    • Check for typos in both attribute names and values
  3. Check Network

    • Verify endpoint URLs are accessible
    • Check for CORS issues

Debug Checklist

  •  SDK script correctly added to HTML
  •  oirid and oirtyp configured
  •  No ad blockers blocking the script
  •  No console errors
  •  Network requests visible in DevTools
  •  localStorage available
  •  HTTPS enabled (production)

Getting Help

Before contacting support, gather this information:

  1. Browser and version
  2. SDK version (window._oirtrk.version())
  3. Console errors (full stack trace)
  4. Network request details
  5. Steps to reproduce

Contact your account manager with this information.