You need to set Insider callbacks after the SDK initializes.
Method Signature
+(void)registerInsiderCallbackWithSelector:(SEL)selector sender:(id)sender;
// Callback Types
InsiderCallbackTypeNotificationOpen
InsiderCallbackTypeInappButtonClick
InsiderCallbackTypeTempStorePurchase
InsiderCallbackTypeTempStoreAddedToCart
InsiderCallbackTypeTempStoreCustomAction
InsiderCallbackTypeInAppSeen
InsiderCallbackTypeSessionStartedMethod Examples
-(void)insiderCallback:(NSDictionary *)dict {
InsiderCallbackType type = (InsiderCallbackType)[[dict objectForKey:@"type"] intValue];
switch (type) {
case InsiderCallbackTypeNotificationOpen:
break;
case InsiderCallbackTypeInappButtonClick:
break;
case InsiderCallbackTypeTempStorePurchase:
break;
case InsiderCallbackTypeTempStoreAddedToCart:
break;
case InsiderCallbackTypeTempStoreCustomAction:
break;
case InsiderCallbackTypeInAppSeen:
break;
case InsiderCallbackTypeSessionStarted:
break;
default:
break;
}
}
@objc public func insiderCallback(_ context: [String: Any]) {
if
let typeAsInt = context["type"] as? Int,
let type = InsiderCallbackType(rawValue: typeAsInt) {
switch type {
case .notificationOpen:
break
case .inAppSeen:
break
case .inappButtonClick:
break
case .sessionStarted:
break
case .tempStoreAddedToCart:
break
case .tempStorePurchase:
break
case .tempStoreCustomAction:
break
}
}
}
Push Handling by App Owner on Foreground
When the app is on the foreground, Apple has 2 different behaviors on push notifications.
- Not showing notification as a banner
- Showing notification as a banner
If you do not set up any additional methods, Insider SDK prefers to not show the notification banner.
If you set up Foreground Push View, then the notification banner shows.
On the other hand, if the app owner wants to handle push notification preview by themselves, the below callback can be used. With this callback method, the application can detect incoming notifications while in the foreground state, and Insider handles the push.
Method Signature
+(void)triggerPushProcessWithUserInfo:(NSDictionary *)userInfo;Method Examples
static NSString *APP_GROUP = @"group.com.company.product";
static NSString *INSIDER_PARTNER_NAME = @"your_partner_name";
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
UNUserNotificationCenter.currentNotificationCenter.delegate = self;
[Insider initWithLaunchOptions:launchOptions partnerName:INSIDER_PARTNER_NAME appGroup:APP_GROUP];
[Insider setForegroundPushCallback:@selector(setForegroundPushCallback:) sender:self];
return true;
}
-(void)setForegroundPushCallback:(UNNotification *) notification {
[Insider triggerPushProcessWithUserInfo:notification.request.content.userInfo];
}let appGroup = "group.com.company.product"
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
Insider.initWithLaunchOptions(launchOptions, partnerName: "your_partner_name", appGroup: appGroup)
Insider.setForegroundPushCallback(#selector(setForegroundPushCallback), sender: self)
return true
}
@objc func setForegroundPushCallback(notification: UNNotification) {
Insider.triggerPushProcess(userInfo: notification.request.content.userInfo)
}Insider callbacks, also known as "call-after" functions, help you retrieve useful data when necessary.
For example, let's take a look at the NotificationOpen callback. Say you have a push notification without a deep link. In this case, no callback will be fired. If you have a push notification with a key-value pair deep link, the NotificationOpen callback will be fired once you open the push notification.
The following are sample logs for different deep link types in app pushes and templates:
Key-Value Pair (Push)
[INSIDER][insiderCallbackTriggered] I Callback Type: NOTIFICATION_OPEN, Data:{
"type": 0,
"data": {
"received_at": "1748433708",
"collapse_id": "0_70815_1748433707",
"source": "Insider",
"camp_type": "0",
"key": "value",
"sound": "Default",
"camp_id": "70815",
"isSetPush": true,
"variant_id": "89159",
"sent_at": "1748433707"
}
}
Key-Value Pair (Message Action Button)
[INSIDER][insiderCallbackTriggered] Callback Type: NOTIFICATION_OPEN
{"type": 0,
"data": {
"buttonId": 0,
"source": "Insider",
"key": "value",
"buttonText": "key value pair button1"
}
}
Internal URL (Push)
[INSIDER][insiderCallbackTriggered] I Callback Type: NOTIFICATION_OPEN, Data:{
"type": 0,
"data": {
"received_at": "1748433708",
"collapse_id": "0_70815_1748433707",
"source": "Insider",
"camp_type": "0",
"ins_dl_internal": "https://www.test.com",
"sound": "Default",
"camp_id": "70815",
"isSetPush": true,
"variant_id": "89159",
"sent_at": "1748433707"
}
}
Internal URL (Message Action Button)
[INSIDER][insiderCallbackTriggered] Callback Type: NOTIFICATION_OPEN
{
"type": 0,
"data": {
"buttonId": 0,
"source": "Insider",
"buttonText": "test internal",
"ins_dl_internal": "https://www.test.com"
}
}
External URL (Push)
[INSIDER][insiderCallbackTriggered] I Callback Type: NOTIFICATION_OPEN, Data:{
"type": 0,
"data": {
"received_at": "1748433708",
"collapse_id": "0_70815_1748433707",
"source": "Insider",
"camp_type": "0",
"ins_dl_external": "https://www.test.com",
"sound": "Default",
"camp_id": "70815",
"isSetPush": true,
"variant_id": "89159",
"sent_at": "1748433707"
}
}
External URL (Message Action Button)
[INSIDER][insiderCallbackTriggered] Callback Type: NOTIFICATION_OPEN
{
"type": 0,
"data": {
"ins_dl_external": "https://www.test.com",
"buttonId": 0,
"source": "Insider",
"buttonText": "test external"
}
}
JSON (Push)
[INSIDER][insiderCallbackTriggered] I Callback Type: NOTIFICATION_OPEN, Data:{
"type": 0,
"data": {
"received_at": "1748433708",
"collapse_id": "0_70815_1748433707",
"source": "Insider",
"camp_type": "0",
"ins_dl_json": '{"test":"test2"}',
"sound": "Default",
"camp_id": "70815",
"isSetPush": true,
"variant_id": "89159",
"sent_at": "1748433707"
}
}
JSON (Message Action Button)
[INSIDER][insiderCallbackTriggered] Callback Type: NOTIFICATION_OPEN
{
"type": 0,
"data": {
"buttonId": 0,
"source": "Insider",
"buttonText": "test json",
"ins_dl_json": '{"test":"test2"}'
}
}
URL Scheme (Push)
[INSIDER][insiderCallbackTriggered] I Callback Type: NOTIFICATION_OPEN, Data:{
"type": 0,
"data": {
"received_at": "1748433708",
"collapse_id": "0_70815_1748433707",
"source": "Insider",
"camp_type": "0",
"ins_dl_url_scheme": "test",
"sound": "Default",
"camp_id": "70815",
"isSetPush": true,
"variant_id": "89159",
"sent_at": "1748433707"
}
}
URL Scheme (Message Action Button)
[INSIDER][insiderCallbackTriggered] Callback Type: NOTIFICATION_OPEN
{
"type": 0,
"data": {
"buttonId": 0,
"source": "Insider",
"buttonText": "test url scheme",
"ins_dl_url_scheme": 'test'
}
}
URL Scheme (App template)
[INSIDER][DEBUG][processTemplateStoreURL]: {
action = deepLink;
dismiss = 12;
redirection = "https://academy.useinsider.com";
}
JSON (App template)
[INSIDER][DEBUG][processTemplateStoreURL]: {
action = deepLink;
custom = {
json = "{\"insider_key\": \"insider_value\"}";
};
dismiss = 12;
}