--- title: "Events" slug: "cordova-default-mobile-events" description: "Reference every default Cordova mobile event, page visits, cart, and wishlist with method signatures and custom parameter examples." updated: 2026-10-10T20:41:55Z published: 2026-10-10T20:41:55Z canonical: "academy.insiderone.com/cordova-default-mobile-events" --- > ## Documentation Index > Fetch the complete documentation index at: https://academy.insiderone.com/llms.txt > Use this file to discover all available pages before exploring further. # Events Below, you can see a list of default mobile events along with their method signatures and examples: - [SDK Events](/docs/cordova-default-mobile-events#sdk-events) - [Page Visit Events](/docs/cordova-default-mobile-events#page-visit-events) - [Cart Events](/docs/cordova-default-mobile-events#cart-events) - [Wishlist Events](/docs/cordova-default-mobile-events#wishlist-events) 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. 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. 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](https://academy.insiderone.com/docs/creating-events-and-attributes-for-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 ```javascript visitHomePage(): void; ``` #### Method Example ```javascript window.Insider.visitHomePage(); ``` **visitHomePage(customParameters?: CustomParameters)** You can call this method each time a user visits your homepage, optionally passing custom parameters. | Parameter | Data Type | | --- | --- | | customParameters | Object (optional) | **Method signature** ```javascript visitHomePage(customParameters?: CustomParameters): void; ``` **Method example** ```javascript const customParameters = { source: 'deeplink', campaign: 'spring_sale' }; window.Insider.visitHomePage(customParameters); ``` ### 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 | If you pass any nil/null or empty parameter to this method, this event will be ignored. #### Method Signature ```javascript visitListingPage(taxonomy: object): void; ``` #### Method Example ```javascript const taxonomy = ['taxonomy1', 'taxonomy2', 'taxonomy3']; window.Insider.visitListingPage(taxonomy); ``` **visitListingPage(taxonomy: Array, customParameters?: CustomParameters)** You can call this method each time a user visits your listing page, along with taxonomy and optional custom parameters. | Parameter | Data Type | | --- | --- | | taxonomy | Array of string | | customParameters | Object (optional) | > If you pass any nil/null or empty taxonomy, this event will be ignored. **Method signature** ```javascript visitListingPage(taxonomy: Array, customParameters?: CustomParameters): void; ``` **Method example** ```javascript const taxonomy = ['taxonomy1', 'taxonomy2', 'taxonomy3']; const customParameters = { sort_type: 'price_asc', filter_count: 3 }; window.Insider.visitListingPage(taxonomy, customParameters); ``` ### 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](/docs/cordova-social-proof) method. | Parameter | Data Type | | --- | --- | | product | object ([Insider product object](/docs/cordova-product-object)) | This event requires the Insider [product](/docs/cordova-product-object) object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes. #### Method Signature ```javascript visitProductDetailPage(product: object): void; ``` #### Method Example ```javascript var product = window.Insider.createNewProduct('product_id', 'Apple', taxonomy, 'imageURL', 1000.5, 'currency'); window.Insider.visitProductDetailPage(product); ``` **visitProductDetailPage(product: object, customParameters?: CustomParameters)** You can call this method each time a user visits your product page with the Insider product object and optional custom parameters. | Parameter | Data Type | | --- | --- | | product | Object (Insider product object) | | customParameters | Object (optional) | **Method signature** ```javascript visitProductDetailPage(product: object, customParameters?: CustomParameters): void; ``` **Method example** ```javascript var product = window.Insider.createNewProduct('product_id', 'Apple', taxonomy, 'imageURL', 1000.5, 'currency'); const customParameters = { referrer: 'recommendation_widget', position: 2 }; window.Insider.visitProductDetailPage(product, customParameters); ``` ### 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 with the list of Insider product objects, an optional saleID, and optional custom parameters. | Parameter | Data Type | | --- | --- | | insiderProducts | Array of [Insider product object](/docs/cordova-product-object) | | saleID | String (optional) | | customParameters | Object (optional) | This event requires the Insider [product](/docs/cordova-product-object) object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes. #### Method signatures ```javascript visitCartPage(products: Array): void; visitCartPage(products: Array, customParameters: CustomParameters): void; visitCartPage(products: Array, saleID: string): void; visitCartPage(products: Array, saleID: string, customParameters: CustomParameters): void; ``` #### Method examples ```javascript // Only products window.Insider.visitCartPage(insiderExampleProducts); // Products + customParameters window.Insider.visitCartPage(insiderExampleProducts, { cart_total: 499.90, item_count: 3 }); // Products + saleID window.Insider.visitCartPage(insiderExampleProducts, 'cart_session_123'); // Products + saleID + customParameters window.Insider.visitCartPage(insiderExampleProducts, 'cart_session_123', { cart_total: 499.90, coupon_applied: true }); ``` ### 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](https://academy.insiderone.com/docs/cordova-product-object) | This event requires the Insider [product](https://academy.insiderone.com/docs/cordova-product-object) object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes. #### Method Signature ```javascript function visitWishlistPage(products: object[]): void ``` #### Method Example ```javascript window.Insider.visitWishlistPage(insiderExampleProducts); ``` **visitWishlistPage(products: Array, customParameters?: CustomParameters)** You can call this method each time a user visits your wishlist page with the list of Insider product objects and optional custom parameters. | Parameter | Data Type | | --- | --- | | insiderProducts | Array of Insider product object | | customParameters | Object (optional) | **Method signature** ```javascript visitWishlistPage(products: Array, customParameters?: CustomParameters): void; ``` **Method example** ```javascript const customParameters = { item_count: 5, last_updated: new Date() }; window.Insider.visitWishlistPage(insiderExampleProducts, customParameters); ``` ### 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](/docs/cordova-track-revenue) method. | Parameter | Data Type | | --- | --- | | saleID | String | | product | Object ([Insider product object](/docs/cordova-product-object)) | Make sure to call this event only on successful transactions that are completed with any payment method.This event requires the Insider [product](/docs/cordova-product-object) object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes. #### Method Signature ```javascript itemPurchased(uniqueSaleID: string, product: object): void; ``` #### Method Example ```javascript var product = window.Insider.createNewProduct('product_id', 'Apple', taxonomy, 'imageURL', 1000.5, 'currency'); await window.Insider.itemPurchased('unique_sale_id', product); ``` **itemPurchased(uniqueSaleID: string, product: object, customParameters?: CustomParameters)** You can call this method each time a user makes a purchase, along with the unique sale ID, Insider product object, and optional custom parameters. | Parameter | Data Type | | --- | --- | | uniqueSaleID | String | | product | Object (Insider product object) | | customParameters | Object (optional) | **Method signature** ```javascript itemPurchased(uniqueSaleID: string, product: object, customParameters?: CustomParameters): void; ``` **Method example** ```javascript var product = window.Insider.createNewProduct('product_id', 'Apple', taxonomy, 'imageURL', 1000.5, 'currency'); const customParameters = { payment_method: 'credit_card', discount_amount: 50.0, is_first_purchase: true, purchase_date: new Date() }; await window.Insider.itemPurchased('unique_sale_id', product, customParameters); ``` ### 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 ```javascript signUpConfirmation(): void; ``` #### Method Example ```javascript window.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. If you want to trigger any other cart-related event, you should define a custom event on the [Test Lab](https://academy.insiderone.com/docs/creating-events-and-attributes-for-test-lab). ### Item Added to Cart (Add to Cart) You can call this method whenever a user adds a product ([Insider product object](/docs/cordova-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](/docs/cordova-cart-reminder) method. | Parameter | Data Type | | --- | --- | | product | Object ([Insider product object](/docs/cordova-product-object)) | This event requires the Insider [product](/docs/cordova-product-object) object to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes. #### Method Signature ```javascript itemAddedToCart(product: object): void; ``` #### Method Example ```javascript var product = window.Insider.createNewProduct('product_id', 'Apple', taxonomy, 'imageURL', 1000.5, 'currency'); const itemAC = window.Insider.itemAddedToCart(product); ``` **itemAddedToCart(product: object, customParameters?: CustomParameters)** You can call this method whenever a user adds a product (Insider product object) to their cart, along with optional custom parameters. | Parameter | Data Type | | --- | --- | | product | Object (Insider product object) | | customParameters | Object (optional) | **Method signature** ```javascript itemAddedToCart(product: object, customParameters?: CustomParameters): void; ``` **Method example** ```javascript var product = window.Insider.createNewProduct('product_id', 'Apple', taxonomy, 'imageURL', 1000.5, 'currency'); const customParameters = { quantity: 2, size: 'M', color: 'red' }; window.Insider.itemAddedToCart(product, customParameters); ``` ### Item Removed from Cart You can call this method whenever a user removes a product from their cart. An optional saleID and optional custom parameters may be supplied > This event is required for the [Cart Reminder](/docs/cordova-cart-reminder) method. | Parameter | Data Type | | --- | --- | | productID | String | | saleID | String (optional) | | customParameters | Object (optional) | This event requires the Insider [product](/docs/cordova-product-object) object to be integrated beforehand, along with its product ID, name, taxonomy, image URL, price, and currency attributes. #### Method Signatures ```javascript itemRemovedFromCart(productID: string): void; itemRemovedFromCart(productID: string, customParameters: CustomParameters): void; itemRemovedFromCart(productID: string, saleID: string): void; itemRemovedFromCart(productID: string, saleID: string, customParameters: CustomParameters): void; ``` #### Method Examples ```javascript // Only productID window.Insider.itemRemovedFromCart('product_id'); // productID + customParameters window.Insider.itemRemovedFromCart('product_id', { reason: 'out_of_stock' }); // productID + saleID window.Insider.itemRemovedFromCart('product_id', 'cart_session_123'); // productID + saleID + customParameters window.Insider.itemRemovedFromCart('product_id', 'cart_session_123', { reason: 'user_removed', quantity: 1 }); ``` ### Cart Cleared You can call this method whenever a user removes all products from their cart or when the last [Insider product object](/docs/cordova-product-object) is removed from the cart. > This event is required for the [Cart Reminder](/docs/cordova-cart-reminder) method. Make sure to consider all cases and methods a user can empty their cart. #### Method Signature ```javascript cartCleared(): void; ``` #### Method Example ```javascript window.Insider.cartCleared(); ``` **cartCleared(customParameters?: CustomParameters)** You can attach optional custom parameters to this method. | Parameter | Data Type | | --- | --- | | customParameters | Object (optional) | **Method signature** ```javascript cartCleared(customParameters?: CustomParameters): void; ``` **Method example** ```javascript const customParameters = { reason: 'user_cleared', cleared_at: new Date() }; window.Insider.cartCleared(customParameters); ``` ## 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. If you want to trigger any other wishlist-related event, you should define a custom event on the [Test Lab](https://academy.insiderone.com/docs/creating-events-and-attributes-for-test-lab). ### Item Added to Wishlist (Add to Wishlist) You can call this method whenever a user adds a product ([Insider product object](https://academy.insiderone.com/docs/cordova-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](https://academy.insiderone.com/docs/cordova-product-object)) | This event requires the [Insider product object](https://academy.insiderone.com/docs/cordova-product-object) to be integrated beforehand, along with its product ID, name, taxonomy, image URL, price, and currency attributes. #### Method Signature ```javascript function itemAddedToWishlist(product: object): void ``` #### Method Example ```javascript window.Insider.itemAddedToWishlist(product); ``` **itemAddedToWishlist(product: object, customParameters?: CustomParameters)** You can call this method whenever a user adds a product (Insider product object) to their wishlist, along with optional custom parameters. | Parameter | Data Type | | --- | --- | | product | Object (Insider product object) | | customParameters | Object (optional) | **Method signature** ```javascript itemAddedToWishlist(product: object, customParameters?: CustomParameters): void; ``` **Method example** ```javascript const customParameters = { source: 'product_detail', is_gift: false }; window.Insider.itemAddedToWishlist(product, customParameters); ``` ### Item Removed from Wishlist You can call this method whenever a user removes a product ([Insider product object](https://academy.insiderone.com/docs/cordova-product-object)) from their wishlist along with the following event parameters: product ID, name, taxonomy, imageURL, price, and currency. | Parameter | Data Type | | --- | --- | | productID | String | This event requires the [Insider product object](https://academy.insiderone.com/docs/cordova-product-object) to be integrated beforehand along with its product ID, name, taxonomy, image URL, price, and currency attributes. #### Method Signature ```javascript function itemRemovedFromWishlist(productID: string): void ``` #### Method Example ```javascript window.Insider.itemRemovedFromWishlist(productID); ``` **itemRemovedFromWishlist(productID: string, customParameters?: CustomParameters)** You can call this method whenever a user removes a product from their wishlist, along with optional custom parameters. | Parameter | Data Type | | --- | --- | | productID | String | | customParameters | Object (optional) | **Method signature** ```javascript itemRemovedFromWishlist(productID: string, customParameters?: CustomParameters): void; ``` **Method example** ```javascript const customParameters = { reason: 'moved_to_cart' }; window.Insider.itemRemovedFromWishlist('product_id', customParameters); ``` ### Wishlist Cleared You can call this method whenever a user removes all products from their wishlist or when the last [Insider product object](https://academy.insiderone.com/docs/cordova-product-object) is removed from the wishlist. Make sure to consider all cases and methods a user can empty their wishlist. #### Method Signature ```javascript function wishlistCleared(): void ``` #### Method Example ```javascript window.Insider.wishlistCleared(); ``` **wishlistCleared(customParameters?: CustomParameters)** You can attach optional custom parameters to this method. | Parameter | Data Type | | --- | --- | | customParameters | Object (optional) | **Method signature** ```javascript wishlistCleared(customParameters?: CustomParameters): void; ``` **Method example** ```javascript const customParameters = { reason: 'user_cleared', cleared_at: new Date() }; window.Insider.wishlistCleared(customParameters); ```