Add trackPurchaseEvent to RN GA target

docs/targets/react-native-google-analytics.md

@@ -35,6 +35,7 @@ const gaMiddleware = createMiddleware(eventsMap, ga);
 
 * [`screenView`](#screenview)
 * [`event`](#event)
+* [`purchase`](#purchase)
 * [`timing`](#timing)
 * [`socialInteraction`](#socialinteraction)
 * [`user`](#user)
@@ -84,6 +85,41 @@ const someEvent = trackEvent((action, prevState, nextState) => {
 
 <br>
 
+#### purchase
+##### Docs:
+ * https://developers.google.com/analytics/devguides/collection/ios/v3/ecommerce
+
+```js
+import { trackPurchase } from 'redux-beacon/targets/rn/google-analytics';
+
+const somePurchaseEvent = trackPurchase((action, prevState, nextState) => {
+  return {
+    product: { /* fill me in */
+      id: /* fill me in */,
+      name: /* fill me in */,
+      category: /* (optional) */,
+      brand: /* (optional) */,
+      variant: /* (optional) */,
+      price: /* (optional) */,
+      quantity: /* (optional) */,
+      couponCode: /* (optional) */,
+    },
+    transaction: { /* fill me in */
+      id: /* fill me in */,
+      affiliation: /* (optional) */,
+      revenue: /* (optional) */,
+      tax: /* (optional) */,
+      shipping: /* (optional) */,
+      couponCode: /* (optional) */,
+    },
+    action: /* fill me in */,
+    category: /* fill me in */,
+  };
+});
+```
+
+<br>
+
 #### timing
 ##### Docs:
 https://developers.google.com/analytics/devguides/collection/ios/v3/usertimings

src/targets/react-native/google-analytics/__tests__/google-analytics.test.js

@@ -225,6 +225,34 @@ describe('Target: React Native Google Analytics', () => {
       );
     });
 
+    it('calls trackPurchaseEvent for purchase hitType', () => {
+      const events = [
+        {
+          hitType: 'purchase',
+          product: { id: '123', name: 'variable' },
+          transaction: { id: '123' },
+          eventCategory: 'ecommerce',
+          eventAction: 'purchase',
+        },
+      ];
+
+      const tracker = {
+        trackPurchaseEvent: jest.fn(),
+      };
+
+      const trackingId = 'UA-XXXXXX-Y';
+      const trackerConstructor = () => tracker;
+      const target = GoogleAnalytics(trackingId, trackerConstructor);
+      target(events);
+
+      expect(tracker.trackPurchaseEvent).toHaveBeenCalledWith(
+        events[0].product,
+        events[0].transaction,
+        events[0].eventCategory,
+        events[0].eventAction
+      );
+    });
+
     it('calls trackException for exception hitType', () => {
       const events = [
         {

src/targets/react-native/google-analytics/google-analytics.js

@@ -37,14 +37,14 @@ export function GoogleAnalytics(trackingId, GoogleAnalyticsTracker) {
               event.eventCategory,
               event.eventAction,
               options,
-              event.customDimensionDict,
+              event.customDimensionDict
             );
           } else {
             tracker.trackEventWithCustomDimensionValues(
               event.eventCategory,
               event.eventAction,
               {},
-              event.customDimensionDict,
+              event.customDimensionDict
             );
           }
           break;
@@ -58,7 +58,7 @@ export function GoogleAnalytics(trackingId, GoogleAnalyticsTracker) {
         case 'pageviewCustomDimensions': {
           tracker.trackScreenViewWithCustomDimensionValues(
             event.page,
-            event.customDimensionDict,
+            event.customDimensionDict
           );
           break;
         }
@@ -75,7 +75,7 @@ export function GoogleAnalytics(trackingId, GoogleAnalyticsTracker) {
             tracker.trackTiming(
               event.timingCategory,
               event.timingValue,
-              options,
+              options
             );
           } else {
             tracker.trackTiming(event.timingCategory, event.timingValue);
@@ -87,7 +87,7 @@ export function GoogleAnalytics(trackingId, GoogleAnalyticsTracker) {
           tracker.trackSocialInteraction(
             event.socialNetwork,
             event.socialAction,
-            event.socialTarget,
+            event.socialTarget
           );
           break;
         }
@@ -102,6 +102,54 @@ export function GoogleAnalytics(trackingId, GoogleAnalyticsTracker) {
           break;
         }
 
+        case 'purchase': {
+          const productOptions = {};
+          const optionalProductOptions = [
+            'category',
+            'brand',
+            'variant',
+            'price',
+            'quantity',
+            'couponCode',
+          ];
+
+          const transactionOptions = {};
+          const optionalTransactionOptions = [
+            'affiliation',
+            'revenue',
+            'tax',
+            'shipping',
+            'couponCode',
+          ];
+
+          optionalProductOptions.forEach(option => {
+            if (event.product[option] !== undefined) {
+              productOptions[option] = event.product[option];
+            }
+          });
+
+          optionalTransactionOptions.forEach(option => {
+            if (event.transaction[option] !== undefined) {
+              transactionOptions[option] = event.transaction[option];
+            }
+          });
+
+          tracker.trackPurchaseEvent(
+            {
+              id: event.product.id, // required
+              name: event.product.name, // required
+              ...productOptions,
+            },
+            {
+              id: event.transaction.id, // required
+              ...transactionOptions,
+            },
+            event.eventCategory, // required
+            event.eventAction // required
+          );
+          break;
+        }
+
         case 'exception': {
           tracker.trackException(event.exDescription, event.exFatal);
           break;