Plugin update to 6.17.1

Podspec hotfix, readme update, plugin update

Author: al-af

Docs/RN_PurchaseConnector.md

@@ -38,14 +38,15 @@ For more information please check the following pages:
     - [Subscription Purchase Data Source](#subscription-purchase-data-source)
     - [In-App Purchase Data Source](#in-app-purchase-data-source)
   - [Platform-Specific Implementation](#platform-specific-implementation)
+  - [Logging Consumable Transactions](#logging-consumable-transactions)
   - [Important Notes](#important-notes)
 
 ## <a id="important-note"></a>Important Note ⚠️ ⚠️
 
 The Purchase Connector feature of the AppsFlyer SDK depends on specific libraries provided by Google and Apple for managing in-app purchases:
 
--   For Android, it depends on the  [Google Play Billing Library](https://developer.android.com/google/play/billing/integrate) (Supported versions: 5.x.x - 6.x.x).
--   For iOS, it depends on  [StoreKit](https://developer.apple.com/documentation/storekit).
+-   For Android, it depends on the  [Google Play Billing Library](https://developer.android.com/google/play/billing/integrate) (Supported versions: 5.x.x - 7.x.x).
+-   For iOS, it depends on  [StoreKit](https://developer.apple.com/documentation/storekit) (Supported versions: StoreKit1 and StoreKit2 (beta)).
 
 However, these dependencies aren't actively included with the SDK. This means that the responsibility of managing these dependencies and including the necessary libraries in your project falls on you as the consumer of the SDK.
 
@@ -125,6 +126,7 @@ For example:
     logSubscriptions: true,
     logInApps: true,
     sandbox: true,
+    storeKitVersion: StoreKitVersion.SK2
   });
 
   // purchaseConnector1 and purchaseConnector2 point to the same instance
@@ -149,9 +151,10 @@ Start the SDK instance to observe transactions. </br>
 
         appsFlyer.startSdk();
         const purchaseConnectorConfig: PurchaseConnectorConfig = AppsFlyerPurchaseConnectorConfig.setConfig({
-            logSubscriptions: true,
-            logInApps: true,
-            sandbox: true,
+          logSubscriptions: true,
+          logInApps: true,
+          sandbox: true,
+          storeKitVersion: StoreKitVersion.SK2
         });
 
         //Create the object
@@ -318,15 +321,20 @@ Add following keep rules to your  `proguard-rules.pro`  file:
 
 ## <a id="full-code-example"></a>Full Code Example
 ```javascript
-const purchaseConnectorConfig: PurchaseConnectorConfig = AppsFlyerPurchaseConnectorConfig.setConfig({
+import appsFlyer, {
+  StoreKitVersion,
+  AppsFlyerPurchaseConnector,
+  AppsFlyerPurchaseConnectorConfig,
+} from 'react-native-appsflyer';
+
+const purchaseConnectorConfig = AppsFlyerPurchaseConnectorConfig.setConfig({
     logSubscriptions: true,
     logInApps: true,
     sandbox: true,
+    storeKitVersion: StoreKitVersion.SK2
   });
 
-  AppsFlyerPurchaseConnector.create(
-    purchaseConnectorConfig,
-  );
+  AppsFlyerPurchaseConnector.create(purchaseConnectorConfig);
 
 const handleValidationSuccess = (validationResult) => {
     console.log('>> ValidationSuccess: ', validationResult);
@@ -417,14 +425,13 @@ AppsFlyerPurchaseConnector.setPurchaseRevenueDataSource({
 ```javascript
 // Set additional parameters for StoreKit2 purchases
 AppsFlyerPurchaseConnector.setPurchaseRevenueDataSourceStoreKit2({
-  products: [
-    { product_id: 'com.app.subscription.monthly' },
-    { product_id: 'com.app.subscription.yearly' }
-  ],
-  transactions: [
-    { transaction_id: 'transaction123' },
-    { transaction_id: 'transaction456' }
-  ]
+  additionalParameters: {
+    user_id: '12345',
+    user_type: 'premium',
+    purchase_source: 'app_store',
+    custom_param1: 'value1',
+    custom_param2: 'value2'
+  }
 });
 ```
 
@@ -469,7 +476,7 @@ When implementing these data sources in your app, you should consider the platfo
 
 ```javascript
 import { Platform } from 'react-native';
-import AppsFlyerPurchaseConnector from 'react-native-appsflyer-plugin';
+import { AppsFlyerPurchaseConnector } from 'react-native-appsflyer';
 
 const setupPurchaseDataSources = () => {
   if (Platform.OS === 'ios') {
@@ -484,12 +491,11 @@ const setupPurchaseDataSources = () => {
 
     // iOS StoreKit2 data source (iOS 15.0+)
     AppsFlyerPurchaseConnector.setPurchaseRevenueDataSourceStoreKit2({
-      products: [
-        { product_id: 'com.app.subscription.monthly' }
-      ],
-      transactions: [
-        { transaction_id: 'transaction123' }
-      ]
+      additionalParameters: {
+        user_id: '12345',
+        user_type: 'premium',
+        purchase_source: 'app_store'
+      }
     });
   } else if (Platform.OS === 'android') {
     // Android subscription data source
@@ -513,6 +519,59 @@ const setupPurchaseDataSources = () => {
 };
 ```
 
+
+### <a id="logging-consumable-transactions"></a>Logging Consumable Transactions
+
+On iOS 15 and above, consumable in-app purchases are handled via StoreKit 2. The behavior depends on your iOS version:
+
+- **On iOS 18 and later:**  
+  Apple introduced a new Info.plist flag: `SKIncludeConsumableInAppPurchaseHistory`.  
+  - If you set `SKIncludeConsumableInAppPurchaseHistory` to `YES` in your Info.plist, automatic collection will happen.
+  - If the flag is not present or is set to `NO`, you must manually log consumable transactions as shown below.
+
+- **On iOS 15–17:**  
+  Consumable purchases must always be logged manually.
+
+To manually log consumable transactions, use the `logConsumableTransaction` method after finishing the transaction:
+
+```javascript
+import { Platform } from 'react-native';
+import { AppsFlyerPurchaseConnector } from 'react-native-appsflyer';
+
+// Purchase update listener
+purchaseUpdatedListener((purchase) => {
+  console.log("🛒 Purchase updated:", purchase.productId, "Transaction ID:", purchase.transactionId);
+  const isConsumable = consumablesItems.includes(purchase.productId);
+  
+  finishTransaction({ purchase, isConsumable })
+    .then((res) => {
+      console.log("✅ finishTransaction success:", res);
+      console.log("🔍 Expecting AppsFlyer validation callback for:", purchase.productId);
+      
+      // Log consumable transaction for iOS
+      if (Platform.OS === 'ios' && isConsumable && purchase.transactionId) {
+        AppsFlyerPurchaseConnector.logConsumableTransaction(purchase.transactionId);
+        console.log("📝 Consumable transaction logged:", purchase.transactionId);
+      }
+    })
+    .catch((error) => {
+      console.warn("❌ Error finishing transaction:", error);
+    });
+});
+```
+
+### Method Signature
+
+```javascript
+AppsFlyerPurchaseConnector.logConsumableTransaction(transactionId: string): void
+```
+
+**Parameters:**
+- `transactionId` (string): The unique transaction identifier from the App Store transaction
+
+**Note:** This method is iOS-specific and should only be called on iOS devices. On Android, consumable transactions are automatically handled by the Purchase Connector.
+
+
 ### <a id="important-notes"></a>Important Notes
 
 1. **iOS StoreKit2**: The StoreKit2 data source is only available on iOS 15.0 and later. Make sure to check the iOS version before using it.
@@ -525,10 +584,11 @@ const setupPurchaseDataSources = () => {
 
 ```javascript
 // 1. Create the connector
-await AppsFlyerPurchaseConnector.create({
+AppsFlyerPurchaseConnector.create({
   logSubscriptions: true,
   logInApps: true,
-  sandbox: __DEV__
+  sandbox: __DEV__,
+  storeKitVersion: StoreKitVersion.SK2
 });
 
 // 2. Set up data sources
@@ -537,5 +597,3 @@ setupPurchaseDataSources();
 // 3. Start observing transactions
 await AppsFlyerPurchaseConnector.startObservingTransactions();
 ```
-
-4. **Validation**: The parameters you set will be included in the purchase events sent to AppsFlyer. You can verify this in the AppsFlyer dashboard under the purchase events section.

README.md

@@ -13,40 +13,18 @@
 ### <a id="plugin-build-for"> This plugin is built for
 
 - Android AppsFlyer SDK **v6.17.0**
-- iOS AppsFlyer SDK **v6.17.0**
+- iOS AppsFlyer SDK **v6.17.1**
 - Tested with React-Native **v0.62.0** (older versions might be supported)
 
-## <a id="breaking-changes"> ❗❗ Breaking changes when updating to v6.x.x❗❗
-- From version `6.16.2`, `AppsFlyerConsent.forGDPRUser` and `AppsFlyerConsent.forNonGDPRUser` have been **deprecated**. Use the new `AppsFlyerConsent` constructor instead. See [Deprecation Notice](/Docs/RN_CMP.md#deprecation-notice).
+## <a id="release-updates"> Release Updates
 
-- From version `6.15.1`, upgraded to targetSDKVersion 34, Java 17, and Gradle 8.7 in [AppsFlyer Android SDK v6.15.1](https://support.appsflyer.com/hc/en-us/articles/115001256006-AppsFlyer-Android-SDK-release-notes).
+- Starting with version 6.17.1 the plugin supports the Purchase Connector for validating and measuring Subscription and In-app purchase events. Integration guide can be found [here](https://github.com/AppsFlyerSDK/appsflyer-react-native-plugin/blob/master/Docs/RN_PurchaseConnector.md).
 
-- From version `6.15.1`, iOS Minimum deployment target is set to 12.0.
+- Starting with version `6.16.2`, `AppsFlyerConsent.forGDPRUser` and `AppsFlyerConsent.forNonGDPRUser` have been **deprecated**. Use the new `AppsFlyerConsent` constructor instead. See [Deprecation Notice](/Docs/RN_CMP.md#deprecation-notice).
 
-- From version `6.3.0`, we use `xcframework` for iOS platform. Then you need to use cocoapods version >= 1.10
+- Starting with version `6.15.1`, upgraded to targetSDKVersion 34, Java 17, and Gradle 8.7 in [AppsFlyer Android SDK v6.15.1](https://support.appsflyer.com/hc/en-us/articles/115001256006-AppsFlyer-Android-SDK-release-notes).
 
-- From version `6.2.30`, `logCrossPromotionAndOpenStore` api will register as `af_cross_promotion` instead of `af_app_invites` in your dashboard.<br>
-  Click on a link that was generated using `generateInviteLink` api will be register as `af_app_invites`.
-
-- From version `6.0.0` we have renamed the following APIs:
-
-| Old API                       | New API                       |
-| ----------------------------- | ----------------------------- |
-| trackEvent                    | logEvent                      |
-| trackLocation                 | logLocation                   |
-| stopTracking                  | stop                          |
-| trackCrossPromotionImpression | logCrossPromotionImpression   |
-| trackAndOpenStore             | logCrossPromotionAndOpenStore |
-| setDeviceTrackingDisabled     | anonymizeUser                 |
-| AppsFlyerTracker              | AppsFlyerLib                  |
-
-And removed the following ones:
-
-- trackAppLaunch -> no longer needed. See new init guide
-- sendDeepLinkData -> no longer needed. See new init guide
-- enableUninstallTracking -> no longer needed. See new uninstall measurement guide
-
-If you have used 1 of the removed APIs, please check the integration guide for the updated instructions.
+- Starting with version `6.15.1`, iOS Minimum deployment target is set to 12.0.
 
 ---
 

android/src/main/java/com/appsflyer/reactnative/RNAppsFlyerConstants.java

@@ -6,7 +6,7 @@
 
 public class RNAppsFlyerConstants {
 
-    final static String PLUGIN_VERSION = "6.17.01";
+    final static String PLUGIN_VERSION = "6.17.1";
     final static String NO_DEVKEY_FOUND = "No 'devKey' found or its empty";
     final static String UNKNOWN_ERROR = "AF Unknown Error";
     final static String SUCCESS = "Success";

index.d.ts

@@ -216,18 +216,12 @@ declare module "react-native-appsflyer" {
 
   //PurchaseRevenueDataSourceSK1
   export interface PurchaseRevenueDataSource {
-    purchaseRevenueAdditionalParametersForProducts?: (
-      products: any[], // SKProduct array
-      transactions: any[] // SKPaymentTransaction array
-    ) => { [key: string]: any } | null;
+    additionalParameters?: { [key: string]: any };
   }
 
   // PurchaseRevenueDataSourceStoreKit2
   export interface PurchaseRevenueDataSourceStoreKit2 {
-    purchaseRevenueAdditionalParametersStoreKit2ForProducts: (
-      products: any[], // AFSDKProductSK2 array
-      transactions: any[] // AFSDKTransactionSK2 array
-    ) => { [key: string]: any } | null;
+    additionalParameters?: { [key: string]: any };
   }
 
   // Android interfaces

ios/PCAppsFlyer.m

@@ -148,14 +148,12 @@ @implementation PCAppsFlyer
 // Delegate method for StoreKit1
 - (NSDictionary *)purchaseRevenueAdditionalParametersForProducts:(NSSet<SKProduct *> *)products 
                                                    transactions:(NSSet<SKPaymentTransaction *> *)transactions {
-    // Simply return the parameters that were set from React Native
     return self.purchaseRevenueParams;
 }
 
 // Delegate method for StoreKit2
 - (NSDictionary<NSString *, id> *)purchaseRevenueAdditionalParametersStoreKit2ForProducts:(NSSet<AFSDKProductSK2 *> *)products 
                                                            transactions:(NSSet<AFSDKTransactionSK2 *> *)transactions {
-    // Simply return the parameters that were set from React Native
     return self.purchaseRevenueStoreKit2Params;
 }
 

ios/RNAppsFlyer.h

@@ -22,7 +22,7 @@
 @end
 
 
-static NSString *const kAppsFlyerPluginVersion      = @"6.17.01";
+static NSString *const kAppsFlyerPluginVersion      = @"6.17.1";
 static NSString *const NO_DEVKEY_FOUND              = @"No 'devKey' found or its empty";
 static NSString *const NO_APPID_FOUND               = @"No 'appId' found or its empty";
 static NSString *const NO_EVENT_NAME_FOUND          = @"No 'eventName' found or its empty";

react-native-appsflyer.podspec

@@ -36,13 +36,13 @@ Pod::Spec.new do |s|
   # AppsFlyerFramework
   if defined?($RNAppsFlyerStrictMode) && ($RNAppsFlyerStrictMode == true)
     Pod::UI.puts "#{s.name}: Using AppsFlyerFramework/Strict mode"
-    s.dependency 'AppsFlyerFramework/Strict', '6.17.0'
+    s.dependency 'AppsFlyerFramework/Strict', '6.17.1'
     s.xcconfig = {'GCC_PREPROCESSOR_DEFINITIONS' => '$(inherited) AFSDK_NO_IDFA=1' }
   else
     if !defined?($RNAppsFlyerStrictMode)
       Pod::UI.puts "#{s.name}: Using default AppsFlyerFramework. You may require App Tracking Transparency. Not allowed for Kids apps."
       Pod::UI.puts "#{s.name}: You may set variable `$RNAppsFlyerStrictMode=true` in Podfile to use strict mode for kids apps."
     end
-    s.dependency 'AppsFlyerFramework', '6.17.0'
+    s.dependency 'AppsFlyerFramework', '6.17.1'
   end
 end