base on AppsFlyer Unity Plugin <img src="https://massets.appsflyer.com/wp-content/uploads/2018/06/20092440/static-ziv_1TP.png" width="400" > # appsflyer-unity-plugin [](https://opensource.org/licenses/MIT) [](https://img.shields.io/github/v/release/AppsFlyerSDK/appsflyer-unity-plugin) [](https://github.com/AppsFlyerSDK/appsflyer-unity-plugin/actions/workflows/main.yml) [](https://github.com/af-margot/appsflyer-unity-plugin-beta/actions/workflows/checksums_files.yml) 🛠 In order for us to provide optimal support, please contact AppsFlyer support through the Customer Assistant Chatbot for assistance with troubleshooting issues or product guidance. </br> To do so, please follow [this article](https://support.appsflyer.com/hc/en-us/articles/23583984402193-Using-the-Customer-Assistant-Chatbot) ## 📖 The Unity documentation also be found [here](https://dev.appsflyer.com/hc/docs/unity-plugin) ### <a id="plugin-build-for"> This plugin is built for - Android AppsFlyer SDK v6.17.3 - Android Purchase Connector 2.1.1 - iOS AppsFlyer SDK v6.17.7 - iOS Purchase Connector 6.17.7 --- ## 📌 Important: Two Versions of Unity Plugin v6.17.7 We have released **two** versions of the AppsFlyer Unity plugin to support teams at different stages of migrating to **Google Play Billing Library v8.0.0**. ### Option A — `v6.17.7` (Billing Library v8) - **What’s included:** Support for **Google Play Billing Library 8.0.0** on Android (Android Purchase Connector version - 2.2.0). - **Impact:** This version may introduce **breaking changes** for apps that have **not yet migrated** to the Billing v8 APIs. - **Unity IAP requirement:** If you choose this option, update **Unity IAP (`com.unity.purchasing`) to version 5.0.0 or newer** (we recommend the latest 5.x). Unity IAP 4.x does **not** include Billing v8. ### Option B — `v6.17.72` (Billing Library v7) - **Purpose:** For developers **not ready** to adopt Billing v8. - **Bundled SDKs:** **iOS SDK 6.17.7** and **Android SDK 6.17.3**. - **Impact:** Lets you update the AppsFlyer SDKs without changing your existing (pre‑v8) billing integration. --- ## <a id="new-in-6171"> 🎉 New in 6.17.1 - Purchase Connector Integration - Starting from version 6.17.1, the **Purchase Connector is now integrated directly into the main AppsFlyer Unity plugin**. You no longer need to download, import, or maintain a separate Purchase Connector package. - If you were previously using the standalone Purchase Connector from a separate repository, simply remove any references to `using AppsFlyerConnector;` from your codebase, as its functionality is now included in the main plugin under the `AppsFlyerSDK` namespace. - The Purchase Connector now supports **StoreKit 2** for iOS 15+ alongside the existing StoreKit 1 support. - For detailed migration instructions and new features, see our [Purchase Connector documentation](/docs/purchase-connector.md). --- ## <a id="breaking-changes-6175"> ❗❗ Breaking changes when updating to 6.17.5 ❗❗ - **In-App Purchase Validation API Changes**: The `validateAndSendInAppPurchase` method signatures have been updated for better type safety and cleaner code. - **V2 Methods (Recommended)**: New overloads using structured data classes (`AFPurchaseDetailsAndroid`/`AFSDKPurchaseDetailsIOS`) are now the recommended approach. - **Legacy Methods (Deprecated)**: The old string-based parameter methods are now deprecated but maintained for backward compatibility. - **Migration Required**: If you're using the old `validateAndSendInAppPurchase` methods, consider migrating to the V2 versions for better maintainability. - For detailed API documentation and migration examples, see our [API reference](/docs/API.md). --- ## <a id="breaking-changes"> ❗❗ Breaking changes when updating to 6.12.20 ❗❗ - Starting from version 6.12.20, we have changed the way we distribute the plugin via UPM. The UPM branches will no longer hold a dependency for `com.google.external-dependency-manager` as it was proved to cause issues in different versions of Unity - to be clear, this dependency is still required to utilize our plugin, we just can't distribute the plugin with it in UPM form as the EDM4U dependency is [not available via UPM for quite a while already](https://github.com/googlesamples/unity-jar-resolver/issues/434#issuecomment-827028132) but is still available via `.unitypackage` or `.tgz` files, if you use UPM to fetch our plugin - [please download a suitable version of EDM4U](https://github.com/googlesamples/unity-jar-resolver) so you will be able to resolve the dependencies, or opt for [an installation without EDM4U](https://github.com/AppsFlyerSDK/appsflyer-unity-plugin/blob/master/docs/Installation.md#installation-without-unity-jar-resolver). --- ## <a id="breaking-changes"> ❗❗ Breaking changes when updating to 6.6.0 ❗❗ - Starting version 6.6.0, there is no more need to differentiate between iOS and Android APIs. All APIs must be called with `AppsFlyer` class (even if the API is only iOS or Android). - Please take into consideration that since version 6.6.0, most of the APIs require `initSDK` to be called prior to using them, and since version 6.10.10 only a handful of APIs will properly work when called prior to initialization: `setIsDebug`, `setCurrencyCode`, `setHost`, `disableSKAdNetwork`. Example: Before 6.6.0: ```c# #if UNITY_IOS && !UNITY_EDITOR AppsFlyeriOS.waitForATTUserAuthorizationWithTimeoutInterval(60); #endif ``` --- After 6.6.0: ```c# #if UNITY_IOS && !UNITY_EDITOR AppsFlyer.waitForATTUserAuthorizationWithTimeoutInterval(60); #endif ``` --- ## <a id="strict-mode"> Strict Mode The plugin supports a Strict Mode which completely removes the IDFA collection functionality and AdSupport framework dependencies. Use the Strict Mode when developing apps for kids, for example. More information about how to install the Strict Mode is available [here](/docs/Installation.md). ### <a id="init-sdk-deeplink"> AD_ID permission for Android In v6.8.0 of the AppsFlyer SDK, we added the normal permission com.google.android.gms.permission.AD_ID to the SDK's AndroidManifest, to allow the SDK to collect the Android Advertising ID on apps targeting API 33. If your app is targeting children, you need to revoke this permission to comply with Google's Data policy. You can read more about it [here](https://dev.appsflyer.com/hc/docs/install-android-sdk#the-ad_id-permission). --- ## <a id="plugin-build-for"> 🚀 Getting Started - [Installation](/docs/Installation.md) - [Integration](/docs/BasicIntegration.md) - [Test integration](/docs/Testing.md) - [In-app events](/docs/InAppEvents.md) - [Send Consent for DMA Compliance](/docs/DMAConsent.md) - [Uninstall measurement](/docs/UninstallMeasurement.md) ## <a id="plugin-build-for"> 💰 Purchase Connector - [Purchase Connector (ROI360)](/docs/purchase-connector.md) ## <a id="plugin-build-for"> 🔗 Deep Linking - [Integration](/docs/DeepLinkIntegrate.md) - [Unified Deep Link (UDL)](/docs/UnifiedDeepLink.md) - [User invite](/docs/UserInvite.md) ## <a id="plugin-build-for"> 🧪 Sample App - [ButterFlyer](https://github.com/AppsFlyerSDK/appsflyer-unity-sample-app) ---- ### [API reference](/docs/API.md) ### [Troubleshooting](/docs/Troubleshooting.md) ", Assign "at most 3 tags" to the expected json: {"id":"7983","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"