{"id":21478249,"url":"https://github.com/appsflyersdk/adobeairextension-appsflyer","last_synced_at":"2025-07-15T11:30:37.820Z","repository":{"id":1541889,"uuid":"14856423","full_name":"AppsFlyerSDK/AdobeAirExtension-AppsFlyer","owner":"AppsFlyerSDK","description":"Adobe Air Extension for AppsFlyer","archived":false,"fork":false,"pushed_at":"2024-05-15T07:42:50.000Z","size":341549,"stargazers_count":24,"open_issues_count":9,"forks_count":22,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-05-15T23:02:36.371Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AppsFlyerSDK.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2013-12-02T08:11:59.000Z","updated_at":"2024-05-15T07:36:28.000Z","dependencies_parsed_at":"2024-04-25T09:30:51.255Z","dependency_job_id":"e1d7c726-43d0-4992-aad3-df322c0ebcf0","html_url":"https://github.com/AppsFlyerSDK/AdobeAirExtension-AppsFlyer","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AppsFlyerSDK%2FAdobeAirExtension-AppsFlyer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AppsFlyerSDK%2FAdobeAirExtension-AppsFlyer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AppsFlyerSDK%2FAdobeAirExtension-AppsFlyer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AppsFlyerSDK%2FAdobeAirExtension-AppsFlyer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AppsFlyerSDK","download_url":"https://codeload.github.com/AppsFlyerSDK/AdobeAirExtension-AppsFlyer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226033200,"owners_count":17563127,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-23T11:17:24.920Z","updated_at":"2024-11-23T11:17:28.398Z","avatar_url":"https://github.com/AppsFlyerSDK.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AppsFlyer Adobe Air extension \n\nIn order for us to provide optimal support, we would kindly ask you to submit any issues to support@appsflyer.com\n\n*When submitting an issue please specify your AppsFlyer sign-up (account) email , your app ID , production steps, logs, code snippets and any additional relevant information.*\n\n## Table of content\n\n- [v6 Breaking changes](#v6-breaking-changes)\n- [Plugin info](#plugin-info)\n- [Installation](#installation)\n  - [Notes for Android apps](#android_notes)\n  - [Notes for iOS apps](#ios_notes)\n- [Usage](#Usage)\n- [Deep Linking](#dl)\n- [IMEI And Android ID Collection  (Android Only)](#imei-id)\n- [API Methods](#api-methods)\n- [Changelog](#changelog)\n\n---\n\n## \u003ca id=\"v6-breaking-changes\"\u003e ❗ v6 Breaking Changes\n\nWe have renamed the following APIs:\n\n| Old API                       | New API                       |\n| ------------------------------|-------------------------------|\n| trackEvent                    | logEvent                      |\n| startTracking                 | start                         |\n| stopTracking                  | stop                          |\n| isTrackingStopped             | isStopped                     |\n| setCustomerIdAndTrack         | startWithCUID                 |\n| validateAndTrackInAppPurchase | validateAndLogInAppPurchase   |\n\nAnd removed the following ones:\n\n- trackAppLaunch -\u003e no longer needed. See new init guide\n- sendDeepLinkData -\u003e no longer needed\n\nIf you have used 1 of the removed APIs, please check the integration guide for the updated instructions\n\n## \u003ca id=\"plugin-info\"\u003e Plugin info\n\nSupported platforms:\n\n- Android\n- iOS 12+\n\nBased on:\n\n- iOS AppsFlyerSDK **v6.14.3**\n- Android AppsFlyerSDK **v6.14.0**\n\nBuilt with:\n\n- SWF-version = 44\n- AIR SDK version = 50.2.3\n\n---\n\n## \u003ca id=\"installation\"\u003e Installation\nDownload the [AppsFlyerAIRExtension.ane](https://github.com/AppsFlyerSDK/AdobeAirExtension-AppsFlyer/blob/master/bin/AppsFlyerAIRExtension.ane \"AppsFlyerAIRExtension.ane\") file from the bin folder\nAdd the ANE to your project and make sure the IDE is marked to package it.\n\nIf the following was not added automatically please add it to the APP_NAME-app.xml:\n\n```\n\u003cextensions\u003e \n\t\u003cextensionID\u003ecom.appsflyer.adobeair\u003c/extensionID\u003e \n\u003c/extensions\u003e\n```\n\n### \u003ca id=\"android_notes\"\u003e **Special instructions for Android applications:**\n\u003cdetails\u003e\n\t\n- On AppsFlyer's dashboard you will need to add \"air.\" prefix to the package name as this is added automatically by Air.  For example -  an app with the package name \"**com.test.android**\"  ,  should set the app id on AppsFlyer's Dashboard as \"**air.com.test.android**\".\n\n- Add the following permissions to Android Manifest (in the app description `APP_NAME-app.xml`):  \n```\n\u003cuses-permission android:name=\"android.permission.INTERNET\"/\u003e\n\u003cuses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\"/\u003e\n\u003cuses-permission android:name=\"android.permission.ACCESS_WIFI_STATE\"/\u003e\n\u003cuses-permission android:name=\"com.google.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE\" /\u003e\n```\n- Add the following metatag to Android Manifest within the application tag (in the app description `APP_NAME-app.xml`):  \n`\u003cmeta-data android:name=\"com.google.android.gms.version\" android:value=\"@integer/google_play_services_version\" /\u003e`\n\nAs a result, you should see your Manifest like this:\n\n![image](https://user-images.githubusercontent.com/50541317/88154121-047b8100-cc0f-11ea-9647-5dae37e9817f.png)\n\n\n**IMPORTANT If you use AIR SDK \u003c v33.1.1.856**  \n\nDue to some limitations in the [ADT](https://help.adobe.com/en_US/air/build/WS5b3ccc516d4fbf351e63e3d118666ade46-7fd9.html)\nbundled with AIR SDK \u003c 33.1.1.856, after APK is built it is missing some important files.\n\nTo add those files (with the help of **automated** script):\n \n 1. Place into single directory of your choice:\n- apk file\n- keystore that was used to sign the apk\n- [af_apk_fix.sh script](https://github.com/AppsFlyerSDK/AdobeAirExtension-AppsFlyer/blob/master/bin/af_apk_fix.sh)  \n\n2. Run `./af_apk_fix.sh` and enter requested info when prompted\n\nHere is what the script is doing. In case of any issues you can perform those steps **manually**: \n\n1. Decode the apk using [apktool](https://ibotpeaches.github.io/Apktool/). This will create app_name folder.  \n   `apktool d app_name.apk`\n2. Download\n   the [AppsFlyer SDK jar/aar](https://repo.maven.apache.org/maven2/com/appsflyer/af-android-sdk/6.5.4/af-android-sdk-6.5.4.aar)\n   of the same version that was used in the apk\n3. Extract files `a-` and `b-` from the jar (by renaming jar into a zip) and place them into the folder with the\n   decompiled apk to `app_name/unknown/com/appsflyer/internal`\n\n4. Edit `apktool.yml` by adding these lines under `unknownFiles:` like in the screenshot below:\n```\ncom/appsflyer/internal/b-: '0'\ncom/appsflyer/internal/a-: '0'\n```\n\n![image](https://user-images.githubusercontent.com/50541317/87637508-05ae3900-c74b-11ea-8a22-9757c088c4c4.png)\n\n\n5. Build the apk back (will appear under `app_name/dist` folder)  \n   `apktool b app`\n\n6. Zipalign the apk\n   `zipalign -p -f -v 4 app_name/dist/app_name.apk app_name/dist/app_name-aligned.apk`\n\n7. Sign the apk\n   `apksigner sign -v --ks myKeystore.jks --ks-key-alias myKey --out app_name/dist/app_name-aligned-signed.apk app_name/dist/app_name-aligned.apk`\n\n8. Verify signature\n   `apksigner verify app_name/dist/app_name-aligned-signed.apk`\n\n9. Verify zipalignment  \n   `zipalign -c -v 4 app_name/dist/app_name-aligned-signed.apk`\n\n10. Your apk `app_name/dist/app_name-aligned-signed.apk` is ready to use!\n\n\u003c/details\u003e\n\n### \u003ca id=\"ios_notes\"\u003e **Special instructions for iOS applications:**\n\u003cdetails\u003e\nIf you use Strict mode ANE, make sure not to call any IDFA related APIs listed below. They are still present in the ActionScript, but will cause an app to crash if invoked.\n\n- `waitForATTUserAuthorization(timeout:int):void;`\n\u003c/details\u003e\n\n---\n\n## \u003ca id=\"Usage\"\u003e Usage\nImport the AppsFlyer Extension into your project:\n\n```\nimport AppsFlyerInterface;\n```\n\nConstruct the AppsFlyer interface:\n\n```\nprivate static var appsFlyer: AppsFlyerInterface; \nappsFlyer = new AppsFlyerInterface();\n```\n\n(Optional) If you want to perform deep linking or access AppsFlyer conversion data from the application, register Conversion Listener:\n\n```\nappsFlyer.registerConversionListener();\n```\n\nSet the Developer key and iOS app ID and Initialise the SDK:\n\n```\nappsFlyer.init(\"DevKey\", \"iOSAppID\");\n```\n\nInitialise session reporting (automatically report app launches and background-to-foreground transitions) with DevKey and iOS app ID:\n\n```\nappsFlyer.start(\"DevKey\", \"iOSAppID\");\n```\n\n### Note:\nIf you don't target iOS as a platform, specifying `iOSAppID` ID is not required\n\n---\n\n## \u003ca id=\"dl\"\u003e Deep Linking\n\t\n#### \u003ca id=\"dl-su\"\u003eSetting up  Deep Links in Adobe Air applications\n**Android:** Create an `intent-filter` in the Android-Manifest.xml containing the required scheme/host/path properties. For additional reading on App-Links in Adobe Air: https://www.adobe.com/devnet/air/articles/android-app-links.html\n\n**iOS:** Using `URI schemes`. For additional reading on URI schemes in iOS: https://help.adobe.com/en_US/air/build/WSfffb011ac560372f7e64a7f12cd2dd1867-8000.html#WS901d38e593cd1bac354f4f7b12e260e3e67-8000  \n\n**More on DeepLinks and AppsFlyer:** [OneLink™ Overview](https://support.appsflyer.com/hc/en-us/articles/115005248543-OneLink-Overview) \n\n### \u003ca id=\"dl-cb\"\u003eReceiving Deep Link Callbacks\nIn order to receive the relevant AppsFlyer information from the deep link used, register the following event listeners:\n```\nappsFlyer.addEventListener(AppsFlyerEvent.APP_OPEN_ATTRIBUTION, eventHandler); // success \nappsFlyer.addEventListener(AppsFlyerEvent.ATTRIBUTION_FAILURE, eventHandler); // error \n```\nAnd handle the response in a corresponding event handler:\n```\nprivate function eventHandler(event:AppsFlyerEvent):void {\n\tlog(\"AppsFlyer event: \" + event.type + \"; \\nData: \" + event.data);\n}\n```\n\n### \u003ca id=\"df\"\u003eDeferred Deep Links (get Conversion Data)\nIn order to receive the conversion data for the current install, register the following event listeners:\n```\nappsFlyer.addEventListener(AppsFlyerEvent.INSTALL_CONVERSATION_DATA_LOADED, eventHandler); // success\nappsFlyer.addEventListener(AppsFlyerEvent.INSTALL_CONVERSATION_FAILED, eventHandler); //error\n```\nAnd handle the response in a corresponding event handler:\n```\nprivate function eventHandler(event:AppsFlyerEvent):void {\n\tlog(\"AppsFlyer event: \" + event.type + \"; \\nData: \" + event.data);\n}\n```\n\n---\n\n##  \u003ca id=\"imei-id\"\u003e IMEI And Android ID Collection  (Android Only)\nBy default, IMEI and Android ID are not collected by the SDK if the OS version is higher than KitKat (4.4) and the device contains Google Play Services.\n\nTo explicitly send these IDs to AppsFlyer, developers can use the following APIs and place it before initialising the SDK.\n\nIf the app does NOT contain Google Play Services, the IMEI and Android ID are collected by the SDK. However, **apps with Google play services should avoid IMEI collection as this is in violation of the Google Play policy**.\n\n#### Enable / Disable IMEI collection (disabled by default)\n\n```\nappsFlyer.setCollectIMEI(bool);\n```\n\n#### Manually setting IMEI Data \n\n```\nappsFlyer.setImeiData(\"imeiString\");\n```\n\n#### Enable / Disable Android ID collection (disabled by default)\n\n```\nappsFlyer.setCollectAndroidID(bool);\n```\n\n#### Manually setting Android ID Data\n\n```\nappsFlyer.setAndroidIdData(\"AndroidIDString\");\n```\n\n---\n\n## \u003ca id=\"api-methods\"\u003e API Methods\n\n### \u003ca id=\"event-logging\"\u003e Logging In-App Events\nIn-App  Events can be logged using the `logEvent(\"eventName\", \"eventValue\") API.\nFor Example: \n\t\n```\nvar param:String = \"Deposit\";\nvar value:String = '{\"amount\":10, \"FTDLevel\":\"-\"}';\nappsFlyer.logEvent(param, value);         \n```\n\n### \u003ca id=\"appUserId\"\u003e Setting App User ID\n\t\n```\nappsFlyer.setAppUserId(\"user_id_as_used_in_the_app\");\n```\n\n### \u003ca id=\"appUserEmail\"\u003e Setting App User Email\n\n```\nappsFlyer.setUserEmails(\"example@example.com\");\n```\n\n### \u003ca id=\"currency\"\u003e Setting  Currency\n\n```\nappsFlyer.setCurrency(\"USD\");\n```\n\n### \u003ca id =\"opt\"\u003e Stop (Opt-Out)\nIn some extreme cases you might want to shut down all SDK reporting due to legal and privacy compliance. This can be achieved with the stop() API. Once this API is invoked, our SDK will no longer communicate with our servers and stop functioning.\n\n```\nappsFlyer.stop();\n```\n\n###  \u003ca id=\"debugLogs\"\u003e Enable / Disable AppsFlyer Debug-Logs\n\n```\nappsFlyer.setDebug(bool);\n```\n\n**Important :** do not release the application to the AppStore / Google Play with debug logs enabled.\n\n---\n\n## \u003ca id=\"changelog\"\u003eChangelog\nYou can find the release changelog [here](https://appsflyer.zendesk.com/hc/en-us/articles/207032226).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappsflyersdk%2Fadobeairextension-appsflyer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fappsflyersdk%2Fadobeairextension-appsflyer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappsflyersdk%2Fadobeairextension-appsflyer/lists"}