feat(api): adding purchase track method to manually track purchases outside IAPs.

Author: milos1290

Leanplum-SDK/Classes/Constants.h

@@ -239,6 +239,7 @@ OBJC_EXPORT NSString *LP_PARAM_INBOX_MESSAGES;
 OBJC_EXPORT NSString *LP_PARAM_INBOX_MESSAGE_ID;
 OBJC_EXPORT NSString *LP_PARAM_RICH_PUSH_ENABLED;
 OBJC_EXPORT NSString *LP_PARAM_UUID;
+OBJC_EXPORT NSString *LP_PARAM_CURRENCY_CODE;
 
 OBJC_EXPORT NSString *LP_KEY_VARS;
 OBJC_EXPORT NSString *LP_KEY_MESSAGES;

Leanplum-SDK/Classes/Constants.m

@@ -174,6 +174,7 @@ - (id)init {
 NSString *LP_PARAM_INBOX_MESSAGE_ID = @"newsfeedMessageId";
 NSString *LP_PARAM_RICH_PUSH_ENABLED = @"richPushEnabled";
 NSString *LP_PARAM_UUID = @"uuid";
+NSString *LP_PARAM_CURRENCY_CODE = @"currencyCode";
 
 NSString *LP_KEY_REASON = @"reason";
 NSString *LP_KEY_STACK_TRACE = @"stackTrace";

Leanplum-SDK/Classes/Leanplum.h

@@ -550,6 +550,13 @@ typedef NS_ENUM(NSUInteger, LPTrackScreenMode) {
  */
 + (void)trackAllAppScreensWithMode:(LPTrackScreenMode)trackScreenMode;
 
+/**
+ * Manually track purchase event with currency code in your application. It is advised to use
+ * trackInAppPurchases to automatically track IAPs.
+ */
++ (void)trackPurchase:(NSString *)event withValue:(double)value
+      andCurrencyCode:(NSString *)currencyCode andParameters:(NSDictionary *)params;
+
 /**
  * Automatically tracks InApp purchase and does server side receipt validation.
  */

Leanplum-SDK/Classes/Leanplum.m

@@ -1800,6 +1800,23 @@ + (void)trackAllAppScreensWithMode:(LPTrackScreenMode)trackScreenMode;
     LP_END_TRY
 }
 
++ (void)trackPurchase:(NSString *)event withValue:(double)value
+      andCurrencyCode:(NSString *)currencyCode andParameters:(NSDictionary *)params
+{
+    RETURN_IF_NOOP;
+    LP_TRY
+    NSMutableDictionary *arguments = [NSMutableDictionary new];
+    if (currencyCode) {
+        arguments[LP_PARAM_CURRENCY_CODE] = currencyCode;
+    }
+
+    [Leanplum track:event
+          withValue:value
+            andArgs:arguments
+      andParameters:params];
+    LP_END_TRY
+}
+
 + (void)trackInAppPurchases
 {
     RETURN_IF_NOOP;