Usage-iOS.md

Example Usage

Record an event

An example of recording a User Event called Product Viewed.

CleverTap.SharedInstance()?.RecordEvent("Product Viewed");

Record Charged Event

An example of recording a Charged Event, more details here.

var chargedDetails = new NSDictionary(
  new NSString("Total Amount"), new NSNumber(100)
);

var item1 = new NSDictionary(
 new NSString("Product Name"), new NSString("Hacking with Swift"),
 new NSString("ProductID"), new NSNumber(556),
 new NSString("Price"), new NSNumber(1000)
);
var item2 = new NSDictionary(
 new NSString("Product Name"), new NSString("Programming in Objective C"),
 new NSString("ProductID"), new NSNumber(956),
 new NSString("Price"), new NSNumber(700)
);

var items = new[] { item1, item2 };
CleverTap.SharedInstance()?.RecordChargedEventWithDetails(chargedDetails, items);

Update a user profile

• Using pushProfile

var profileData = new NSDictionary(
  new NSString("Name"), new NSString("Jack Montana"),
  new NSString("Identity"), new NSString("61026032"),
  new NSString("Email"), new NSString("Jack Montana"),
  new NSString("Phone"), new NSString("14155551234"),
  new NSString("Gender"), new NSString("F"),
  new NSString("DOB"), new NSDate()
);
CleverTap.SharedInstance()?.ProfilePush(profileData);

• Using onUserLogin

var profileData = new NSDictionary(
  new NSString("Name"), new NSString("Jack Montana"),
  new NSString("Identity"), new NSString("61026032"),
  new NSString("Email"), new NSString("Jack Montana"),
  new NSString("Phone"), new NSString("14155551234"),
  new NSString("Gender"), new NSString("F"),
  new NSString("DOB"), new NSDate()
);
CleverTap.SharedInstance()?.OnUserLogin(profileData);

Note: Please go through our documentation on handling user profile.

App Inbox

Initialize the CleverTap App Inbox Method

CleverTap.SharedInstance()?.InitializeInboxWithCallback((bool success) => {
    if (success) {
        Console.WriteLine("App Inbox Initialised.");
     }
});

Present App Inbox

var style = new CleverTapInboxStyleConfig();
var tags = new[] {
    new NSString("Tag1"),
    new NSString("Tag2")
};
style.MessageTags = tags;
style.Title = "App Inbox";
style.BackgroundColor = UIColor.LightGray;

CleverTap.SharedInstance()?.InitializeInboxWithCallback(_ =>
{
    CleverTapInboxViewController inboxVC = CleverTap.SharedInstance().NewInboxViewControllerWithConfig(style, null);
    var navController = new UINavigationController(inboxVC);
    if (inboxVC == null)
    {
        Console.WriteLine("CleverTap Inbox View Controller is null.");
    }
    else
    {
        NavigationController.PresentModalViewController(navController, true);
    }
});

     

---

iOS (Optional) - only required for iOS Simulator builds

The following is required to prevent crashes when running on iOS simulator.

1. Right-click on your iOS project and select Options.
2. Select Build > iOS Build, then make sure iPhoneSimulator is selected under “Platform:” at the top.
3. Under Additional mtouch arguments: enter --registrar:static.