Quick Start Guide for Developers

Welcome to Insider's Growth Management Platform! This guide will help you integrate Insider into your web or mobile application, enabling you to deliver personalized experiences to your users.

Determine Your Platform

Identify the platform you want to integrate:

Web Application: Proceed with the Web SDK Integration.
Mobile Application: Proceed with the Mobile SDK Integration.

Web SDK Integration

To integrate Insider with your website, you can follow the steps below to install and configure the Web SDK. This enables Insider to collect data, identify users, and trigger personalized experiences.

1. Select Your Integration Platform

Insider's Web SDK is compatible with various platforms:

Standard HTML websites
Single Page Applications (SPA)
Tag Management Systems (TMS) like Google Tag Manager

You can follow the relevant instructions based on your platform from the Integration Platforms guide.

2. Add the Insider Tag to Your Website

You can also complete the Insider Tag integration on Insider's new onboarding center. Refer to Insider Onboarding Center for further details.

Insert the Insider Tag into the <head> section of your HTML pages, just before the closing </head> tag:

<script async src="//{partnerName}.api.useinsider.com/ins.js?id={partnerId}"></script>

Replace {partnerName} and {partnerId} with your Insider-specific values. You can find this information in Account Settings in InOne.

Refer to Insider Tag integration for further details.

3. Set Up Data Flow

Before loading the Insider Tag, define the window.InsiderQueue to share user identifiers, custom attributes, and events. This setup ensures Insider receives the correct data for personalization and analytics.

Refer to the Web SDK Integration guide for implementation details.

4. Test the Integration

After completing your Web SDK setup, validate that the integration is working as expected:

Use browser DevTools:
- Open the Network tab and check for requests to *.api.useinsider.com/track.
- Open the Console tab to identify any SDK-related logs, warnings, or errors.
Verify in InOne: Ensure user data and events are visible in the relevant sections, such as Audiences, Event History, or User Profiles, in InOne.
Check with your Insider One team: The Insider One team may provide debugging tools or help confirm whether data is being received properly.

Make sure the Insider Tag fires on all intended pages, and that user identifiers and custom attributes are available on first load if needed.

You’ve now completed the Web SDK setup! With the integration in place, Insider can start delivering personalized, data-driven experiences across your website.

Mobile SDK Integration

This section will help you integrate Insider’s Mobile SDK into your Android, iOS, React Native, Expo, Flutter, and Cordova/Ionic platforms to enable personalized, real-time experiences.

1. Select Your Mobile Platform

Choose the SDK that matches your app framework:

Android → Android SDK Integration Guide
iOS → iOS SDK Integration Guide
React Native → React Native SDK Integration Guide
Expo → Expo SDK Integration Guide
Flutter → Flutter SDK Integration Guide
Cordova/Ionic → Cordova SDK Integration Guide

Each guide includes platform-specific instructions for installation, initialization, event tracking, and push notification setup.

Below, you can check the demo applications on GitHub.

2. Complete the Basic SDK Setup

Use Insider's Mobile Integration Wizard to complete the basic SDK setup for your platform(s):

SDK	Basic SDK Contents
Android	Required dependencies and permissions Set Firebase messaging service Register landing class Initialize SDK Customize notifications Firebase cloud messaging Set callbacks
iOS	Add required targets Add capabilities and URL types SDK integration: Cocoapods, Carthage, or manual installation Initialize SDK Customize notification sounds Configure Apple push certificates: p8 and p12 Bridging-header file Set callbacks
React Native	SDK installation Set callbacks Required dependencies and permissions Firebase cloud messaging Huawei messaging service
Expo	SDK installation Set callbacks Firebase cloud messaging
Flutter	SDK installation Set callbacks Required dependencies and permissions Firebase cloud messaging Huawei messaging service
Cordova/Ionic	SDK installation Set callbacks Required dependencies and permissions Firebase cloud messaging Huawei messaging service

Refer to the relevant SDK guide above for platform-specific installation instructions.

3. Identify Users and Products with Attributes, Objects, and Methods, and Track Events

Once the basic setup is completed:

Identify users by email, phone, or user ID.
Track custom events such as logins, purchases, or screen views.
Send attributes, like subscription level, gender, or preferences.
Configure product attributes, like price, stock, or color.

Use Insider's Mobile Integration Wizard and Test Lab to configure events, event parameters, attributes, objects, and methods to complete the advanced integration for your platform(s):

Android SDK: Events, Event Parameters, and Attributes, Objects, Advanced Methods
iOS SDK: Events, Event Parameters, and Attributes, Objects, Advanced Methods
React Native SDK: Events, Event Parameters, and Attributes, Objects, Advanced Methods
Expo SDK: Events, Event Parameters, and Attributes, Objects, Advanced Methods
Flutter SDK: Events, Event Parameters, and Attributes, Objects, Advanced Methods
Cordova/Ionic SDK: Events, Event Parameters, and Attributes, Objects, Advanced Methods

4. Set Up Push Notifications

See below for the requirements for different push types.

Push Type	Requirements
Single App Push	Basic SDK version
Slider App Push	Basic SDK version for Android Advanced Push Notification integration steps for iOS
Carousel App Push	Basic SDK version for Android Advanced Push Notification integration steps for iOS
Geofence App Push	Basic SDK version Geofence method for the respective platform(s) Add the necessary keys and values required by location permissions into your plist file as described in Configure Cocoapods Installation step.
Recurring App Push	Basic SDK version
Cart Reminder App Push	Integrate the SDK version 7.1 at least on both platforms. Integrate Carousel/Slider Push Notifications for iOS. Integrate Insider’s Revenue Tracking Method. Integrate Insider's Cart Reminder Method. Use the dedicated methods to pass item name, item ID, item price, price currency, and item image to Insider with the 7.1 SDK and above.
Conversion App Push	Integrate the basic SDK version Integrate the dedicated events and attributes to segment users, personalize push notification content, and trigger campaigns.

5. Test the Integration

After you create events and attributes, use Insider's Test Lab to test the configured events and attributes.