Report mobile monitoring custom events and attributes

To track purchases in your app, use recordCustomEvent to create an event type (such as "UserAction") and associate attributes such as "name" (with value "Purchase"), price, quantity, and SKU.

Create an event on iOS:

BOOL purchaseRecorded = [NewRelic recordCustomEvent:@"UserAction" attributes:@{@"name": @"Purchase", @"sku": @"12345LPD", @"quantity": @1, @"unitPrice": @99.99, @"total": @99.99}];

Create an event on Android:

Map<String, Object> userActionAttributes = new HashMap<String, Object>();

userActionAttributes.put("name", "Purchase"); 

userActionAttributes.put("sku", "12345LPD");

userActionAttributes.put("quantity", 1);

userActionAttributes.put("unitPrice", 99.99);

userActionAttributes.put("total", 99.99);

boolean userActionRecorded = NewRelic.recordCustomEvent("UserAction", userActionAttributes);

New Relic reports a custom event of type UserAction and name Purchase, which allows you to query all purchases made in your app in the last day:

SELECT * from UserAction where name = 'Purchase' since 1 day ago

Replace deprecated recordEvent method:

As of Android agent version 5.12.0 and iOS agent version 5.12.0, use the recordCustomEvent method to create these custom events. If you have replaced the deprecated recordEvent method for your custom events, be sure to also replace its corresponding NRQL query with the new format.

Look for queries used with recordEvent method, such as:

SELECT * from Mobile where category = 'Custom' and name = 'Purchase' since 1 day ago

Replace them with the query format used with recordCustomEvent:

SELECT * from UserAction where name = 'Purchase' since 1 day ago

You can create a custom attribute to track a custom user identifier across the session, and then query for all that user's interactions. To add an attribute for the userId, call the setUserId method:

Set the userId on iOS:

BOOL userIdWasSet = [NewRelic setUserId:@"jsmith"];

Set the userId on Android:

boolean userIdWasSet = NewRelic.setUserId("jsmith");

With this attribute, you can use a WHERE clause to see all actions performed by that username in the last day:

SELECT * from Mobile WHERE userId = 'jsmith' since 1 day ago

You can create a custom attribute to track a store id across the session, and then query for all that store's interactions. To add an attribute for the storeId, call the setAttribute method:

Set the storeId on iOS:

BOOL attributeSet = [NewRelic setAttribute:@"storeId" value:@"NY0531"];

Set the storeId on Android:

boolean attributeSet = NewRelic.setAttribute("storeId", "NY0531");

With this attribute, you can use a WHERE clause to see all actions performed by that storeId in the last day:

SELECT * from Mobile WHERE storeId = 'NY0531' since 1 day ago

You can use custom attributes to track the number of times that a specific action occurs in your application. For example, you can track the number of times a button was clicked or the number of times a level was completed in a game.

To track completing a game level, call incrementAttribute with no value specified. This creates an attribute with a default value of 1:

Create a counter on iOS:

BOOL levelIncremented = [NewRelic incrementAttribute@"level"];

Create a counter on Android:

boolean levelIncremented = NewRelic.incrementAttribute("level");

Each subsequent call to incrementAttribute adds 1 to the attribute level:

Increment a counter on iOS:

levelIncremented = [NewRelic incrementAttribute@"level"];

Increment a counter on Android:

levelIncremented = NewRelic.incrementAttribute("level");

To reset the level back to 1 or 0, call setAttribute:

Reset a counter on iOS:

levelReset = [NewRelic setAttribute:@"level" value:@1];

Reset a counter on Android:

levelReset = NewRelic.setAttribute("level", 1);

When querying, use this level attribute to filter your data. For example, if you have a username and level attribute, use the max() function to find the highest level the user had reached:

SELECT max(level) from Mobile where username = 'jsmith'