---
title: Troubleshooting Guide
description: Troubleshooting guide for the Opensend SDK.
---

[Skip to content](https://help.opensend.com/opensend-sdk/troubleshooting-guide#main-content)

[Contact Support](https://help.opensend.com/kb-tickets/new?hsLang=en)

[![Logo Black.png\]](https://help.opensend.com/hs-fs/hubfs/Logo%20Black.png?height=33&name=Logo%20Black.png)](https://opensend.com/)

Open main navigation

Close main navigation

- [Contact Support](https://help.opensend.com/kb-tickets/new)
- [Return to opensend.com](https://opensend.com/)

[Return to opensend.com](https://opensend.com/)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Success Center](https://help.opensend.com/?hsLang=en)
2. [Getting started](https://help.opensend.com/getting-started?hsLang=en)
3. [Opensend SDK](https://help.opensend.com/getting-started?hsLang=en#opensend-sdk)

# Troubleshooting Guide

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

 

### Quick Diagnostics

<https://github.com/Intelligence-Labs/tagoir-sdk/blob/develop/docs/user-guides/troubleshooting.md#quick-diagnostics>

#### Check SDK Status

<https://github.com/Intelligence-Labs/tagoir-sdk/blob/develop/docs/user-guides/troubleshooting.md#check-sdk-status>

```
// Verify SDK is loadedconsole.log('SDK available:', typeof window._oirtrk !== 'undefined');// Check SDK versionif (window._oirtrk?.version) {  console.log('SDK version:', window._oirtrk.version());}
```

 

#### Check Network Requests

<https://github.com/Intelligence-Labs/tagoir-sdk/blob/develop/docs/user-guides/troubleshooting.md#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

<https://github.com/Intelligence-Labs/tagoir-sdk/blob/develop/docs/user-guides/troubleshooting.md#check-console-errors>

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

---

### Common Issues

<https://github.com/Intelligence-Labs/tagoir-sdk/blob/develop/docs/user-guides/troubleshooting.md#common-issues>

#### SDK Not Loading

<https://github.com/Intelligence-Labs/tagoir-sdk/blob/develop/docs/user-guides/troubleshooting.md#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

<https://github.com/Intelligence-Labs/tagoir-sdk/blob/develop/docs/user-guides/troubleshooting.md#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

<https://github.com/Intelligence-Labs/tagoir-sdk/blob/develop/docs/user-guides/troubleshooting.md#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

<https://github.com/Intelligence-Labs/tagoir-sdk/blob/develop/docs/user-guides/troubleshooting.md#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.

- [Getting started](https://help.opensend.com/getting-started?hsLang=en#main-content)

    - [Start Here!](https://help.opensend.com/getting-started?hsLang=en#start-here)
    - [Installation and Setup](https://help.opensend.com/getting-started?hsLang=en#installation-and-setup)
    - [CNAME Setup](https://help.opensend.com/getting-started?hsLang=en#cname-setup)
    - [Opensend SDK](https://help.opensend.com/getting-started?hsLang=en#opensend-sdk)
- [Best Practices to Maximize Revenues](https://help.opensend.com/best-practices-to-maximize-revenues?hsLang=en#main-content)

    - [Direct-to-consumer](https://help.opensend.com/best-practices-to-maximize-revenues?hsLang=en#direct-to-consumer)
    - [Business-to-business](https://help.opensend.com/best-practices-to-maximize-revenues?hsLang=en#business-to-business)
    - [Deliverability](https://help.opensend.com/best-practices-to-maximize-revenues?hsLang=en#deliverability)
- [Dashboards & Reports](https://help.opensend.com/dashboards-reports?hsLang=en#main-content)

    - [Klaviyo Reports](https://help.opensend.com/dashboards-reports?hsLang=en#klaviyo-reports)
    - [Iterable Reports](https://help.opensend.com/dashboards-reports?hsLang=en#iterable-reports)
- [Reconnect](https://help.opensend.com/reconnect?hsLang=en#main-content)

    - [Klaviyo](https://help.opensend.com/reconnect?hsLang=en#klaviyo)
    - [Iterable](https://help.opensend.com/reconnect?hsLang=en#iterable)
    - [Bloomreach](https://help.opensend.com/reconnect?hsLang=en#bloomreach)
    - [Attentive](https://help.opensend.com/reconnect?hsLang=en#attentive)
    - [Salesforce Marketing Cloud](https://help.opensend.com/reconnect?hsLang=en#salesforce-marketing-cloud)
- [Personas](https://help.opensend.com/personas?hsLang=en)
- [Revive](https://help.opensend.com/revive?hsLang=en)
- [Integrations](https://help.opensend.com/integrations?hsLang=en#main-content)

    - [API Keys and Account IDs](https://help.opensend.com/integrations?hsLang=en#api-keys-and-account-ids)
    - [Bloomreach](https://help.opensend.com/integrations?hsLang=en#bloomreach)
    - [Braze](https://help.opensend.com/integrations?hsLang=en#braze)
    - [Facebook](https://help.opensend.com/integrations?hsLang=en#facebook)
    - [Google](https://help.opensend.com/integrations?hsLang=en#google)
    - [Iterable](https://help.opensend.com/integrations?hsLang=en#iterable)
    - [Klaviyo](https://help.opensend.com/integrations?hsLang=en#klaviyo)
    - [Listrak](https://help.opensend.com/integrations?hsLang=en#listrak)
    - [Sendlane](https://help.opensend.com/integrations?hsLang=en#sendlane)
    - [Suppression List](https://help.opensend.com/integrations?hsLang=en#suppression-list)
    - [Webhook](https://help.opensend.com/integrations?hsLang=en#webhook)
    - [Yotpo](https://help.opensend.com/integrations?hsLang=en#yotpo)
    - [Zapier](https://help.opensend.com/integrations?hsLang=en#zapier)
    - [Attentive](https://help.opensend.com/integrations?hsLang=en#attentive)
    - [Salesforce Marketing Cloud](https://help.opensend.com/integrations?hsLang=en#salesforce-marketing-cloud)
- [FAQs](https://help.opensend.com/faqs?hsLang=en)
- [General](https://help.opensend.com/general?hsLang=en)

[![Chill listening crop-3](https://help.opensend.com/hs-fs/hubfs/OpenSend_Logo%20icon%202.png?width=42&height=42&name=OpenSend_Logo%20icon%202.png "Chill listening crop-3")](https://www.opensend.com/)

Opensend Help Center

Copyright © 2026, Opensend Inc