Merge pull request #16 from logicwind/dev

Dev

Author: bhavesh-lw

CHANGELOG.md

@@ -0,0 +1,74 @@
+## 0.3.11
+
+- Fixed Apple TVOS crash issue.
+- Enhanced Debug Logging
+- Added trackGoal method. With trackGoal, you can track when a visitor completes a specific objective.
+
+## 0.3.10
+
+- Fixed crash issue related to not passing dimention parameter.
+
+## 0.3.9
+
+- Fixed the crash issue on trackMedia function while pass dimension option.
+
+## 0.3.8
+
+- Refined dimensions data passing
+
+## 0.3.7
+
+- Added trackCustomDimension method for track individual custom dimension tracking
+
+## 0.3.6
+
+- Fixed issue in custom dimension tracking.
+
+## 0.3.5
+
+- Added custom dimension property in media tracking
+
+## 0.3.4
+
+- Added trackCampaign method. Using which you can track generic and matomo UTM attribution
+
+## 0.3.3
+
+- Added support to pass matomo auth-token.
+- Sometime facing issue related to authentication for older events. More info [Here](https://matomo.org/faq/how-to/faq_30835/)
+
+## 0.3.2
+
+- Media tracking progress's attribute typo fix.
+
+## 0.3.1
+
+- Media tracking added.
+- Use trackMediaEvent method to track audio and video related details
+
+## 0.3.0
+
+- Added enableTracking & disableTracking methods to opt in or opt out of tracking. Replacement of setIsOptedOut method.
+- Updated readme.
+**~~~~~ BREAKING CHANGES ~~~~~**
+- Removed setIsOptedOut and added 2 separate methods (enableTracking, disableTracking) to work independently
+
+## 0.2.2
+
+- Crash fixes. case: when trying to track event before initialising of tracker.
+- Can start new session now using startSession method.
+- Can enable logs using setLogger method.
+
+## 0.2.1
+
+- Compilation error fixed on android platform
+
+## 0.2.0
+
+- React-native plugin for Matomo Analytics. Developed based on `matomo-sdk-android` and `matomo-sdk-ios`.
+- The plugin should allow you to track screens, events, searches, impressions, users, visitors, etc.
+
+## 0.1.0
+
+- React-native plugin for Matomo Analytics. Developed based on `matomo-sdk-android` and `matomo-sdk-ios`.
+- The plugin should allow you to track screens, events, searches, impressions, users, visitors, etc.

README.md

@@ -505,6 +505,34 @@ trackCustomDimension({
 
 ```
 
+### trackGoal()
+
+With trackGoal, you can track when a visitor completes a specific objective on your website, such as signing up for a newsletter, completing a purchase, or clicking a call-to-action. Each goal is defined in the Matomo dashboard with a unique Goal ID, and can optionally include a revenue value to track the monetary impact of conversions.
+
+Using trackGoal, you can measure how many users convert on a specific goal, analyze conversion rates, and understand which pages, campaigns, or referrers are driving those conversions.
+
+A goal can be triggered with a simple call by passing the required Goal ID, and optionally a revenue amount. Make sure your goal is configured in the Matomo Goals settings before tracking. Learn more about [how to set up goals in Matomo.](https://matomo.org/faq/reports/create-a-goal-in-matomo/)
+
+* Goal Id (Recommended): `goalId`
+<br>The unique ID of the goal you defined in the Matomo dashboard.</br>
+
+* Revenue (Optional): `revenue`
+<br>The monetary value associated with the goal conversion (e.g., purchase amount)</br>
+
+#### Example
+
+```js
+
+trackGoal(
+  2, // goalId
+  49.99, // revenue
+  [
+      { key: "1", value: "CheckoutSuccess" }
+  ]
+);
+
+```
+
 
 
 ## Methods
@@ -573,7 +601,7 @@ Click on “Create new token”
 
 
 ## react-native-matomo-tracker is crafted mindfully at [Logicwind](https://www.logicwind.com?utm_source=github&utm_medium=github.com-logicwind&utm_campaign=react-native-matomo-tracker)
-We are a 130+ people company developing and designing multiplatform applications using the Lean & Agile methodology. To get more information on the solutions that would suit your needs, feel free to get in touch by [email](mailto:[email protected]) or through or [contact form](https://www.logicwind.com/book-call?utm_source=github&utm_medium=github.com-logicwind&utm_campaign=react-native-matomo-tracker)!
+We are a 130+ people company developing and designing multiplatform applications using the Lean & Agile methodology. To get more information on the solutions that would suit your needs, feel free to get in touch by [email](mailto:[email protected]) or through or [contact form](https://www.logicwind.com/contact-us?utm_source=github&utm_medium=github.com-logicwind&utm_campaign=react-native-matomo-tracker)!
 
 We will always answer you with pleasure 😁
 

ios/ReactNativeMatomoTracker.mm

@@ -25,11 +25,11 @@ @interface RCT_EXTERN_MODULE(ReactNativeMatomoTracker, NSObject)
 
 RCT_EXTERN_METHOD(trackScreens)
 
-RCT_EXTERN_METHOD(trackGoal:(NSInteger)goalId withRevenue:(float *)revenue)
+RCT_EXTERN_METHOD(trackGoal:(NSInteger)goalId withRevenue:(NSNumber *)revenue withActionDimensions:(NSArray<NSDictionary *> *)actionDimensions)
 
 RCT_EXTERN_METHOD(setVisitorId:(NSString *)id)
 
-RCT_EXTERN_METHOD(setIsOptedOut:(BOOL)isOptedOut)
+// RCT_EXTERN_METHOD(setIsOptedOut:(BOOL)isOptedOut) 
 
 RCT_EXTERN_METHOD(setLogger)