Events

Below, you can see a list of default mobile events along with their method signatures and examples:

Your title goes here

While SDK events are automatically triggered by Insider, the other event types need to be implemented via their methods by partners.

SDK events

Session events are automatically triggered based on user actions on the application and campaigns and do not require any configuration from the customer's end.

Event	How does it work?
Mobile App Opened	Triggered when the app is opened
Session Start	Triggered every time a session starts
Session Start From Push	Triggered if a session starts upon a click on a push notification triggered from an app template. Test pushes do not trigger this event.
Push Session	Triggered if a session starts upon a click on a push notification. Test pushes do not trigger this event.
Push Delivered	Triggered when a push is delivered
App Push Opened	Triggered when an app push is opened
InApp Seen	Triggered when an inApp is seen along with the inApp ID and variant ID information
Mobile Social Proof Seen	Triggered when a social proof is seen

Page visit events

You should trigger the page visit events when a user visits the respective type of page in the application. The default page visit events include the Homepage View, Listing Page View, Product Detail Page View, Cart Page View, and Confirmation Page View. See below for their method signatures and examples.

Your title goes here

If you want to trigger any event for any other type of page (e.g. test drive form page, discounts page, etc.), you should define a custom event on the Test Lab.

Homepage View

This method allows you to tag the visits on your homepage as an event. You can call this method each time a user visits your homepage.

Method Signature

+(void)visitHomepage;

Method Examples

[Insider visitHomepage];

Insider.visitHomepage()

Listing Page View

This method allows you to tag the visits on your listing page as an event. You can call this method each time a user visits your listing page along with the following event parameters: taxonomy, type, referrer, key, show_on_segment, is_pii, device_type, url, and source.

Parameter	Data Type
taxonomy	Array of string

Your title goes here

If you pass any nil/null or empty parameter to this method, this event will be ignored.

Method Signature

+(void)visitListingPageWithTaxonomy:(NSArray *)taxonomy

Method Examples

NSArray *taxonomy = [NSArray arrayWithObjects: @"taxonomy1", @"taxonomy2", @"taxonomy3", nil];
[Insider visitListingPageWithTaxonomy:taxonomy];

Insider.visitListingPage(withTaxonomy: ["taxonomy"])

Product Detail Page View

This method allows you to tag the visits on your product page as an event. You can call this method each time a user visits your product page along with the following event parameters: product ID, name, taxonomy, imageURL, price, and currency.

This event is required for the Social Proof method.

Parameter	Data Type
product	object (Insider product object)

Your title goes here

This event requires the Insider product object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes.

Method Signature

+(void)visitProductDetailPage:(InsiderProduct *)product;

Method Example

[Insider visitProductDetailPage:insiderExampleProduct];

Insider.visitProductDetailPage(with: insiderExampleProduct)

Cart Page View

This method allows you to tag the visits on your cart page as an event. You can call this method each time a user visits your cart page along with the following event parameters: product ID, name, taxonomy, imageURL, price, and currency.

Parameter	Data Type
insiderProduct	Array of Insider product object

Your title goes here

This event requires the Insider product object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes.

Method Signature

+(void)visitCartPage:(NSArray *)insiderProducts;

Method Examples

[Insider visitCartPage:insiderExampleProducts];

Insider.visitCartPage(withProducts: insiderExampleProducts)

Wishlist Page View

This method allows you to tag the visits on your wishlist page as an event. You can call this method each time a user visits your wishlist page along with the following event parameters: product ID, name, taxonomy, imageURL, price, and currency.

Parameter	Data Type
insiderProduct	Array of Insider product object

Your title goes here

This event requires the Insider product object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes.

Method Signature

+(void)visitWishlistWithProducts:(NSArray *)insiderProducts;

Method Examples

[Insider visitWishlistWithProducts:insiderExampleProducts];

Insider.visitWishlistWithProducts(withProducts: insiderExampleProducts)

Confirmation Page View (Purchase)

This method allows you to tag the visits on your confirmation page as an event. You can call this method each time a user makes a purchase along with the following event parameters: product ID, name, taxonomy, imageURL, price, and currency.

This event is required for the Track Revenue method.

Parameter	Data Type
saleID	String
product	Object (Insider product object)

Your title goes here

Make sure to call this event only on successful transactions that are completed with any payment method.

Your title goes here

This event requires the Insider product object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes.

Method Signature

+(void)itemPurchasedWithSaleID:(NSString *)saleID product:(InsiderProduct *)product;

Method Examples

[Insider itemPurchasedWithSaleID:@"uniqueSaleID" product:insiderExampleProduct];

Insider.itemPurchased(withSaleID: "uniqueSaleID", product: insiderExampleProduct)

Sign Up Confirmation

This method allows you to tag the visits on your sign up confirmation page as an event. You can call this method each time a user signs up to your application.

Method Signature

+(void)signUpConfirmation;

Method Examples

[Insider signUpConfirmation];

Insider.signUpConfirmation();

Cart events

You should trigger the page visit events when a user visits the respective type of page in the application. The default cart events include the Item Added to Cart, Item Removed from Cart, and Cart Cleared. See below for their method signatures and examples.

Your title goes here

If you want to trigger any other cart-related event, you should define a custom event on the Test Lab.

Item Added to Cart (Add to Cart)

You can call this method whenever a user adds a product (Insider product object) to their cart along with the following event parameters: product ID, name, taxonomy, imageURL, price, and currency.

This event is required for the Cart Reminder method.

Parameter	Data Type
product	Object (Insider product object)

Your title goes here

This event requires the Insider product object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes.

Method Signature

+(void)itemAddedToCartWithProduct:(InsiderProduct *)product;

Method Examples

[Insider itemAddedToCartWithProduct:insiderExampleProduct];

Insider.itemAddedToCart(with: insiderExampleProduct)

Item Removed from Cart

You can call this method whenever a user removes a product (Insider product object) from their cart along with the following event parameters: product ID, name, taxonomy, imageURL, price, and currency.

This event is required for the Cart Reminder method.

Parameter	Data Type
productID	String

Your title goes here

This event requires the Insider product object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes.

Method Signature

+(void)itemRemovedFromCartWithProductID:(NSString *)productID;

Method Examples

[Insider itemRemovedFromCartWithProductID:@"productID"];

Insider.itemRemovedFromCart(withProductID: "productID")

Cart Cleared

You can call this method whenever a user removes all products from their cart or when the last Insider product object is removed from the cart.

This event is required for the Cart Reminder method.

Your title goes here

Make sure to consider all cases and methods a user can empty their cart.

Method Signature

+(void)cartCleared;

Method Examples

[Insider cartCleared];

Insider.cartCleared()

Wishlist events

You should trigger the wishlist events when a user takes the action for the respective type of wishlist moves in the application. The default wishlist events include the Item Added to Wishlist, Item Removed from Wishlist, and Wishlist Cleared. See below for their method signatures and examples.

Your title goes here

If you want to trigger any other cart-related event, you should define a custom event on the Test Lab.

Item Added to Wishlist (Add to Wishlist)

You can call this method whenever a user adds a product (Insider product object) to their wishlist along with the following event parameters: product ID, name, taxonomy, imageURL, price, and currency.

Parameter	Data Type
product	Object (Insider product object)

Your title goes here

This event requires the Insider product object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes.

Method Signature

+(void)itemAddedToWishlistWithProduct:(InsiderProduct *)product;

Method Examples

[Insider itemAddedToWishlistWithProduct:insiderExampleProduct];

Insider.itemAddedToWishlistWithProduct(with: insiderExampleProduct)

Item Removed from Wishlist

You can call this method whenever a user removes a product (Insider product object) from their wishlist along with the following event parameters: product ID, name, taxonomy, imageURL, price, and currency.

Parameter	Data Type
productID	String

Your title goes here

This event requires the Insider product object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes.

Method Signature

+(void)itemRemovedFromWishlistWithProductID:(NSString *)productID;

Method Examples

[Insider itemRemovedFromWishlistWithProductID:@"productID"];

Insider.itemRemovedFromWishlistWithProductID(withProductID: "productID")

Wishlist Cleared

You can call this method whenever a user removes all products from their wishlist or when the last Insider product object is removed from the wishlist.

Your title goes here

Make sure to consider all cases and methods a user can empty their wishlist.

Method Signature

+(void)wishlistCleared;

Method Examples

[Insider wishlistCleared];

Insider.wishlistCleared()