affise-attribution-lib 1.1.6 → 1.1.7

package/README.md

@@ -1,668 +1,705 @@
-# Affise Attribution React Native library
-
-- [Affise Attribution React Native library](#affise-attribution-react-native-library)
-- [Description](#description)
-  - [Quick start](#quick-start)
-  - [Integration](#integration)
-    - [Integrate npm package](#integrate-npm-package)
-    - [Initialize](#initialize)
-    - [Requirements](#requirements)
-      - [Android](#android)
-- [Features](#features)
-  - [Device identifiers collection](#device-identifiers-collection)
-  - [Events tracking](#events-tracking)
-  - [Custom events tracking](#custom-events-tracking)
-  - [Predefined event parameters](#predefined-event-parameters)
-  - [Events buffering](#events-buffering)
-  - [Advertising Identifier (google) tracking](#advertising-identifier-google-tracking)
-  - [Open Advertising Identifier (huawei) tracking](#open-advertising-identifier-huawei-tracking)
-  - [Install referrer tracking](#install-referrer-tracking)
-  - [Push token tracking](#push-token-tracking)
-  - [Reinstall Uninstall tracking](#reinstall-uninstall-tracking)
-  - [APK preinstall tracking](#apk-preinstall-tracking)
-  - [Deeplinks](#deeplinks)
-    - [Android](#android-1)
-    - [iOS](#ios)
-  - [Offline mode](#offline-mode)
-  - [Disable tracking](#disable-tracking)
-  - [Disable background tracking](#disable-background-tracking)
-  - [GDPR right to be forgotten](#gdpr-right-to-be-forgotten)
-  - [Platform specific](#platform-specific)
-    - [Get referrer](#get-referrer)
-    - [Get referrer value](#get-referrer-value)
-    - [SKAd](#skad)
-
-# Description
-
-Affise SDK is a software you can use to collect app usage statistics, device identifiers, deeplink usage, track install
-referrer.
-
-## Quick start
-
-## Integration
-
-### Integrate npm package
-
-This is a [Node.js](https://nodejs.org/en/) module available through the
-[npm registry](https://www.npmjs.com/).
-
-Installation using npm
-
-```console
-npm install affise-attribution-lib
-```
-
-Installation using yarn
-
-```console
-yarn add affise-attribution-lib
-```
-
-#### Add platform modules
-
-##### Android
-
-Add modules to android project
-
-Example `example/android/app/build.gradle`
-
-```gradle
-dependencies {
-    // Affise modules
-    implementation 'com.affise:module-advertising:1.5.4'
-    implementation 'com.affise:module-network:1.5.4'
-    implementation 'com.affise:module-phone:1.5.4'
-}
-```
-
-### Initialize
-
-After dependency is added, and project is sync with `npm install` and initialize.
-
-```typescript
-import {
-  Affise,
-  AffiseInitProperties
-} from 'affise-attribution-lib';
-
-
-export default function App() {
-
-    React.useEffect(() => {
-        Affise.init(
-            new AffiseInitProperties(
-                'Your appId', //Change to your app id
-                true, //Add your custom rule to determine if this is a production build
-                null, //Change to your partParamName
-                null, //Change to your partParamNameToken
-                null, //Change to your appToken
-                'Your secretId' //Change to your secretId
-            )
-        );
-    });
-
-    return (
-        <SafeAreaView>
-        </SafeAreaView>
-    );
-}
-```
-
-
-### Requirements
-
-#### Android
-
-Minimal Android SDK version is 21
-
-For a minimal working functionality your app needs to declare internet permission:
-
-```xml
-<manifest>
-    <uses-permission android:name="android.permission.INTERNET"/>
-</manifest>
-```
-
-OAID certificate in your project (Optional)
-`example/android/app/src/main/assets/oaid.cert.pem`
-
-# Features
-
-### Device identifiers collection
-
-To match users with events and data library is sending, these identifiers are collected:
-
-- `AFFISE_APP_ID`
-- `AFFISE_PKG_APP_NAME`
-- `AFFISE_APP_NAME_DASHBOARD`
-- `APP_VERSION`
-- `APP_VERSION_RAW`
-- `STORE`
-- `TRACKER_TOKEN`
-- `TRACKER_NAME`
-- `FIRST_TRACKER_TOKEN`
-- `FIRST_TRACKER_NAME`
-- `LAST_TRACKER_TOKEN`
-- `LAST_TRACKER_NAME`
-- `OUTDATED_TRACKER_TOKEN`
-- `INSTALLED_TIME`
-- `FIRST_OPEN_TIME`
-- `INSTALLED_HOUR`
-- `FIRST_OPEN_HOUR`
-- `INSTALL_BEGIN_TIME`
-- `INSTALL_FINISH_TIME`
-- `REFERRAL_TIME`
-- `CREATED_TIME`
-- `CREATED_TIME_MILLI`
-- `CREATED_TIME_HOUR`
-- `UNINSTALL_TIME`
-- `REINSTALL_TIME`
-- `LAST_SESSION_TIME`
-- `CONNECTION_TYPE`
-- `CPU_TYPE`
-- `HARDWARE_NAME`
-- `NETWORK_TYPE`
-- `DEVICE_MANUFACTURER`
-- `PROXY_IP_ADDRESS`
-- `DEEPLINK_CLICK`
-- `DEVICE_ATLAS_ID`
-- `AFFISE_DEVICE_ID`
-- `AFFISE_ALT_DEVICE_ID`
-- `ADID`
-- `ANDROID_ID`
-- `ANDROID_ID_MD5`
-- `MAC_SHA1`
-- `MAC_MD5`
-- `GAID_ADID`
-- `GAID_ADID_MD5`
-- `OAID`
-- `OAID_MD5`
-- `REFTOKEN`
-- `REFTOKENS`
-- `REFERRER`
-- `USER_AGENT`
-- `MCCODE`
-- `MNCODE`
-- `ISP`
-- `REGION`
-- `COUNTRY`
-- `LANGUAGE`
-- `DEVICE_NAME`
-- `DEVICE_TYPE`
-- `OS_NAME`
-- `PLATFORM`
-- `API_LEVEL_OS`
-- `AFFISE_SDK_VERSION`
-- `OS_VERSION`
-- `RANDOM_USER_ID`
-- `AFFISE_SDK_POS`
-- `TIMEZONE_DEV`
-- `LAST_TIME_SESSION`
-- `TIME_SESSION`
-- `AFFISE_SESSION_COUNT`
-- `LIFETIME_SESSION_COUNT`
-- `AFFISE_DEEPLINK`
-- `AFFISE_PART_PARAM_NAME`
-- `AFFISE_PART_PARAM_NAME_TOKEN`
-- `AFFISE_APP_TOKEN`
-- `LABEL`
-- `AFFISE_SDK_SECRET_ID`
-- `UUID`
-- `AFFISE_APP_OPENED`
-- `PUSHTOKEN`
-- `EVENTS`
-- `AFFISE_EVENTS_COUNT`
-
-### Events tracking
-
-For example, we want to track what items usually user adds to shopping cart. To send event first create it with
-following code
-
-```typescript
-import { Affise, AddToCartEvent } from 'affise-attribution-lib';
-
-class Presenter {
-  onUserAddsItemsToCart(item: string) {
-    const items = {
-      items: 'cookies, potato, milk',
-    };
-
-    Affise.sendEvent(new AddToCartEvent(items, Date.now(), 'groceries'));
-  }
-}
-```
-
-With above example you can implement other events:
-
-- `AchieveLevelEvent`
-- `AddPaymentInfoEvent`
-- `AddToCartEvent`
-- `AddToWishlistEvent`
-- `ClickAdvEvent`
-- `CompleteRegistrationEvent`
-- `CompleteStreamEvent`
-- `CompleteTrialEvent`
-- `CompleteTutorialEvent`
-- `ContentItemsViewEvent`
-- `DeepLinkedEvent`
-- `InitiatePurchaseEvent`
-- `InitiateStreamEvent`
-- `InviteEvent`
-- `LastAttributedTouchEvent`
-- `ListViewEvent`
-- `LoginEvent`
-- `OpenedFromPushNotificationEvent`
-- `PurchaseEvent`
-- `RateEvent`
-- `ReEngageEvent`
-- `ReserveEvent`
-- `SalesEvent`
-- `SearchEvent`
-- `ShareEvent`
-- `SpendCreditsEvent`
-- `StartRegistrationEvent`
-- `StartTrialEvent`
-- `StartTutorialEvent`
-- `SubscribeEvent`
-- `TravelBookingEvent`
-- `UnlockAchievementEvent`
-- `UnsubscribeEvent`
-- `UnsubscriptionEvent`
-- `UpdateEvent`
-- `ViewAdvEvent`
-- `ViewCartEvent`
-- `ViewItemEvent`
-- `ViewItemsEvent`
-
-### Custom events tracking
-
-Use any of custom events if default doesn't fit your scenario:
-
-- `CustomId01Event`
-- `CustomId02Event`
-- `CustomId03Event`
-- `CustomId04Event`
-- `CustomId05Event`
-- `CustomId06Event`
-- `CustomId07Event`
-- `CustomId08Event`
-- `CustomId09Event`
-- `CustomId10Event`
-
-### Predefined event parameters
-
-To enrich your event with another dimension, you can use predefined parameters for most common cases.
-Add it to any event:
-
-```typescript
-import {
-  Affise,
-  AddToCartEvent,
-  PredefinedParameters,
-} from 'affise-attribution-lib';
-
-class Presenter {
-  onUserAddsItemsToCart(item: string) {
-    const items = {
-      items: 'cookies, potato, milk',
-    };
-
-    const event = new AddToCartEvent(items, Date.now());
-
-    event.addPredefinedParameter(
-      PredefinedParameters.DESCRIPTION,
-      'best before 2029'
-    );
-
-    Affise.sendEvent(event);
-  }
-}
-```
-
-In examples above `PredefinedParameters.DESCRIPTION` is used, but many others is available:
-
-- `ADREV_AD_TYPE`
-- `CITY`
-- `COUNTRY`
-- `REGION`
-- `CLASS`
-- `CONTENT`
-- `CONTENT_ID`
-- `CONTENT_LIST`
-- `CONTENT_TYPE`
-- `CURRENCY`
-- `CUSTOMER_USER_ID`
-- `DATE_A`
-- `DATE_B`
-- `DEPARTING_ARRIVAL_DATE`
-- `DEPARTING_DEPARTURE_DATE`
-- `DESCRIPTION`
-- `DESTINATION_A`
-- `DESTINATION_B`
-- `DESTINATION_LIST`
-- `HOTEL_SCORE`
-- `LEVEL`
-- `MAX_RATING_VALUE`
-- `NUM_ADULTS`
-- `NUM_CHILDREN`
-- `NUM_INFANTS`
-- `ORDER_ID`
-- `PAYMENT_INFO_AVAILABLE`
-- `PREFERRED_NEIGHBORHOODS`
-- `PREFERRED_NUM_STOPS`
-- `PREFERRED_PRICE_RANGE`
-- `PREFERRED_STAR_RATINGS`
-- `PRICE`
-- `PURCHASE_CURRENCY`
-- `QUANTITY`
-- `RATING_VALUE`
-- `RECEIPT_ID`
-- `REGISTRATION_METHOD`
-- `RETURNING_ARRIVAL_DATE`
-- `RETURNING_DEPARTURE_DATE`
-- `REVENUE`
-- `SCORE`
-- `SEARCH_STRING`
-- `SUBSCRIPTION_ID`
-- `SUCCESS`
-- `SUGGESTED_DESTINATIONS`
-- `SUGGESTED_HOTELS`
-- `TRAVEL_START`
-- `TRAVEL_END`
-- `USER_SCORE`
-- `VALIDATED`
-- `ACHIEVEMENT_ID`
-- `COUPON_CODE`
-- `CUSTOMER_SEGMENT`
-- `DEEP_LINK`
-- `EVENT_START`
-- `EVENT_END`
-- `LAT`
-- `LONG`
-- `NEW_VERSION`
-- `OLD_VERSION`
-- `REVIEW_TEXT`
-- `TUTORIAL_ID`
-- `VIRTUAL_CURRENCY_NAME`
-- `PARAM_01`
-- `PARAM_02`
-- `PARAM_03`
-- `PARAM_04`
-- `PARAM_05`
-- `PARAM_06`
-- `PARAM_07`
-- `PARAM_08`
-- `PARAM_09`
-
-### Events buffering
-
-Affise library will send any pending events with first opportunity,
-but if there is no network connection or device is disabled, events are kept locally for 7 days before deletion.
-
-### Advertising Identifier (google) tracking
-
-Advertising Identifier (google) tracking is supported automatically, no actions needed
-
-### Open Advertising Identifier (huawei) tracking
-
-Open Advertising Identifier is supported automatically, no actions needed
-
-### Install referrer tracking
-
-Install referrer tracking is supported automatically, no actions needed
-
-### Push token tracking
-
-To let affise track push token you need to receive it from your push service provider, and pass to Affise library.
-First add firebase integration to your app completing theese steps: https://firebase.google.com/docs/cloud-messaging/android/client
-
-After you have done with firebase inegration, add to your cloud messaging service `onNewToken` method `Affise.addPushToken(token)`
-
-```typescript
-import { Affise } from 'affise-attribution-lib';
-import messaging from '@react-native-firebase/messaging';
-
-const getToken = async () => {
-  const token = await messaging().getToken();
-  if (token) {
-    Affise.addPushToken(token);
-  }
-};
-```
-
-### Reinstall Uninstall tracking
-
-Affise automatically track reinstall events by using silent-push technology, to make this feature work, pass push token when it is recreated by user and on you application starts up
-
-```typescript
-Affise.addPushToken(token);
-```
-
-### APK preinstall tracking
-
-SDK is also supports scenario when APK is installed not from one of application markets, such as google play, huawei appgallery or amazon appstore
-To use this feature, create file with name `partner_key` in your app assets directory, and write unique identifier inside, this key will be passed to our backend so you can track events by partner later in your Affise console.
-
-### Deeplinks
-
-Register deeplink callback right after Affise.init(..)
-
-```typescript
-Affise.init(..);
-Affise.registerDeeplinkCallback((uri) => {
-
-});
-```
-
-#### Android
-
-To integrate deeplink support in android you need:
-
-Add intent filter to `AndroidManifest.xml` as in `example/android/app/src/main/AndroidManifest.xml`,
-
-```xml
-<intent-filter android:autoVerify="true">
-    <action android:name="android.intent.action.VIEW" />
-
-    <category android:name="android.intent.category.DEFAULT" />
-    <category android:name="android.intent.category.BROWSABLE" />
-
-    <data
-        android:host="YOUR_AFFISE_APP_ID.affattr.com"
-        android:scheme="react" />
-</intent-filter>
-```
-
-#### iOS
-
-To integrate deeplink support in iOS you need:
-
-Add deeplink handler to `AppDelegate.mm` as in `example/ios/AffiseAttributionLibExample/AppDelegate.mm`
-- [React Docs](https://reactnavigation.org/docs/deep-linking/#set-up-with-bare-react-native-projects)
-
-```objective-c
-- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
-  sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
-{
-  return [RCTLinkingManager application:application openURL:url
-                      sourceApplication:sourceApplication annotation:annotation];
-}
-```
-
-Add key `CFBundleURLTypes` to `Info.plist` as in `example/ios/AffiseAttributionLibExample/Info.plist`
-
-```html
-<key>CFBundleURLTypes</key>
-<array>
-    <dict>
-        <key>CFBundleTypeRole</key>
-        <string>Editor</string>
-        <key>CFBundleURLName</key>
-        <string>YOUR_AFFISE_APP_ID.affattr.com</string>
-        <key>CFBundleURLSchemes</key>
-        <array>
-            <string>react</string>
-        </array>
-    </dict>
-</array>
-```
-
-### Offline mode
-
-In some scenarious you would want to limit Affise network usage, to pause that activity call anywhere in your application following code after Affise init:
-
-```typescript
-Affise.init(..);
-Affise.setOfflineModeEnabled(true); // to enable offline mode
-Affise.setOfflineModeEnabled(false); // to disable offline mode
-```
-
-While offline mode is enabled, your metrics and other events are kept locally, and will be delivered once offline mode is disabled.
-Offline mode is persistent as Application lifecycle, and will be disabled with process termination automaticly.
-To check current offline mode status call:
-
-```typescript
-Affise.isOfflineModeEnabled(); // returns true or false describing current tracking state
-```
-
-### Disable tracking
-
-To disable any tracking activity, storing events and gathering device identifiers and metrics call anywhere in your application following code after Affise init:
-
-```typescript
-Affise.init(..);
-Affise.setTrackingEnabled(true); // to enable tracking
-Affise.setTrackingEnabled(false); // to disable tracking
-```
-
-By default tracking is enabled.
-
-While tracking mode is disabled, metrics and other identifiers is not generated locally.
-Keep in mind that this flag is persistent until app reinstall, and don't forget to reactivate tracking when needed.
-To check current status of tracking call:
-
-```typescript
-Affise.isTrackingEnabled().then((enabled) => {
-  // returns true or false describing current tracking state
-});
-```
-
-### Disable background tracking
-
-To disable any background tracking activity, storing events and gathering device identifiers and metrics call anywhere in your application following code after Affise init:
-
-```typescript
-Affise.init(..);
-Affise.setBackgroundTrackingEnabled(true); // to enable background tracking
-Affise.setBackgroundTrackingEnabled(false); // to disable background tracking
-```
-
-By default background tracking is enabled.
-
-While background tracking mode is disabled, metrics and other identifiers is not generated locally.
-Background tracking mode is persistent as Application lifecycle, and will be re-enabled with process termination automatically.
-To check current status of background tracking call:
-
-```typescript
-Affise.isBackgroundTrackingEnabled().then((enabled) => {
-  // returns true or false describing current background tracking state
-});
-```
-
-### GDPR right to be forgotten
-
-Under the EU's General Data Protection Regulation (GDPR): An individual has the right to have their personal data erased.
-To provide this functionality to user, as the app developer, you can call
-
-```typescript
-Affise.init(..);
-Affise.forget(); // to forget users data
-```
-
-After processing such request our backend servers will delete all users data.
-To prevent library from generating new events, disable tracking just before calling Affise.forget:
-
-```typescript
-Affise.init(..);
-Affise.setTrackingEnabled(false);
-Affise.forget(); // to forget users data
-```
-
-
-### Platform specific
-
-### Get referrer
-> `Android Only`
-
-Use the next public method of SDK
-
-```typescript
-Affise.getReferrer().then((referrer) => {
-  // returns referrer
-});
-```
-
-#### Get referrer value
-> `Android Only`
-
-Use the next public method of SDK to get referrer value by
-
-```typescript
-Affise.android.getReferrerValue(ReferrerKey.CLICK_ID, (value) => {
-
-})
-```
-
-#### Referrer keys
-
-In examples above `ReferrerKey.CLICK_ID` is used, but many others is available:
-
-- `AD_ID`
-- `CAMPAIGN_ID`
-- `CLICK_ID`
-- `AFFISE_AD`
-- `AFFISE_AD_ID`
-- `AFFISE_AD_TYPE`
-- `AFFISE_ADSET`
-- `AFFISE_ADSET_ID`
-- `AFFISE_AFFC_ID`
-- `AFFISE_CHANNEL`
-- `AFFISE_CLICK_LOOK_BACK`
-- `AFFISE_COST_CURRENCY`
-- `AFFISE_COST_MODEL`
-- `AFFISE_COST_VALUE`
-- `AFFISE_DEEPLINK`
-- `AFFISE_KEYWORDS`
-- `AFFISE_MEDIA_TYPE`
-- `AFFISE_MODEL`
-- `AFFISE_OS`
-- `AFFISE_PARTNER`
-- `AFFISE_REF`
-- `AFFISE_SITE_ID`
-- `AFFISE_SUB_SITE_ID`
-- `AFFC`
-- `PID`
-- `SUB_1`
-- `SUB_2`
-- `SUB_3`
-- `SUB_4`
-- `SUB_5`
-
-
-#### SKAd
-> `iOS Only`
-
-For ios prior `16.1` first call
-```typescript
-Affise.ios.registerAppForAdNetworkAttribution((error) => {
-
-});
-```
-
-Updates the fine and coarse conversion values, and calls a completion handler if the update fails.
-Second argument coarseValue is available in iOS 16.1+
-```typescript
-Affise.ios.updatePostbackConversionValue(1, "medium", (error) => {
-
-});
-```
+# Affise Attribution React Native library
+
+<p align="left">
+    <a href="https://www.npmjs.com/package/affise-attribution-lib" alt="npm package">
+        <img src="https://img.shields.io/npm/v/affise-attribution-lib?label=affise-attribution-lib" />
+    </a>
+</p>
+
+- [Affise Attribution React Native library](#affise-attribution-react-native-library)
+- [Description](#description)
+  - [Quick start](#quick-start)
+  - [Integration](#integration)
+    - [Integrate npm package](#integrate-npm-package)
+    - [Add platform modules](#add-platform-modules)
+      - [Android](#android)
+    - [Initialize](#initialize)
+    - [Requirements](#requirements)
+      - [Android](#android-1)
+- [Features](#features)
+  - [Device identifiers collection](#device-identifiers-collection)
+  - [Events tracking](#events-tracking)
+  - [Custom events tracking](#custom-events-tracking)
+  - [Predefined event parameters](#predefined-event-parameters)
+  - [Events buffering](#events-buffering)
+  - [Advertising Identifier (google) tracking](#advertising-identifier-google-tracking)
+  - [Open Advertising Identifier (huawei) tracking](#open-advertising-identifier-huawei-tracking)
+  - [Install referrer tracking](#install-referrer-tracking)
+  - [Push token tracking](#push-token-tracking)
+  - [Reinstall Uninstall tracking](#reinstall-uninstall-tracking)
+  - [APK preinstall tracking](#apk-preinstall-tracking)
+  - [Deeplinks](#deeplinks)
+    - [Android](#android-2)
+    - [iOS](#ios)
+  - [Offline mode](#offline-mode)
+  - [Disable tracking](#disable-tracking)
+  - [Disable background tracking](#disable-background-tracking)
+  - [GDPR right to be forgotten](#gdpr-right-to-be-forgotten)
+  - [Platform specific](#platform-specific)
+    - [Get referrer](#get-referrer)
+    - [Get referrer value](#get-referrer-value)
+      - [Referrer keys](#referrer-keys)
+    - [StoreKit Ad Network](#storekit-ad-network)
+
+# Description
+
+Affise SDK is a software you can use to collect app usage statistics, device identifiers, deeplink usage, track install
+referrer.
+
+## Quick start
+
+## Integration
+
+### Integrate npm package
+
+This is a [Node.js](https://nodejs.org/en/) module available through the
+[npm registry](https://www.npmjs.com/).
+
+Installation using npm
+
+```console
+npm install affise-attribution-lib
+```
+
+Installation using yarn
+
+```console
+yarn add affise-attribution-lib
+```
+
+### Add platform modules
+
+#### Android
+
+Add modules to android project
+
+| Module | Version |
+| ------ | ------- |
+| module-advertising  | <a href="https://mvnrepository.com/artifact/com.affise/module-advertising"><img src="https://img.shields.io/maven-central/v/com.affise/module-advertising?label=latest"  alt="version" /></a> |
+| module-network  | <a href="https://mvnrepository.com/artifact/com.affise/module-network"><img src="https://img.shields.io/maven-central/v/com.affise/module-network?label=latest" alt="version" /></a> |
+| module-phone  | <a href="https://mvnrepository.com/artifact/com.affise/module-phone"><img src="https://img.shields.io/maven-central/v/com.affise/module-phone?label=latest" alt="version" /></a> |
+
+Example `example/android/app/build.gradle`
+
+```gradle
+dependencies {
+    // Affise modules
+    implementation 'com.affise:module-advertising:1.5.+'
+    implementation 'com.affise:module-network:1.5.+'
+    implementation 'com.affise:module-phone:1.5.+'
+}
+```
+
+### Initialize
+
+After dependency is added, and project is sync with `npm install` and initialize.
+
+```typescript
+import {
+  Affise,
+  AffiseInitProperties
+} from 'affise-attribution-lib';
+
+
+export default function App() {
+
+    React.useEffect(() => {
+        Affise.init(
+            new AffiseInitProperties(
+                'Your appId', //Change to your app id
+                true, //Add your custom rule to determine if this is a production build
+                null, //Change to your partParamName
+                null, //Change to your partParamNameToken
+                null, //Change to your appToken
+                'Your secretId' //Change to your secretId
+            )
+        );
+    });
+
+    return (
+        <SafeAreaView>
+        </SafeAreaView>
+    );
+}
+```
+
+### Requirements
+
+#### Android
+
+Minimal Android SDK version is 21
+
+For a minimal working functionality your app needs to declare internet permission:
+
+```xml
+<manifest>
+    <uses-permission android:name="android.permission.INTERNET"/>
+</manifest>
+```
+
+OAID certificate in your project (Optional)
+`example/android/app/src/main/assets/oaid.cert.pem`
+
+# Features
+
+## Device identifiers collection
+
+To match users with events and data library is sending, these identifiers are collected:
+
+- `AFFISE_APP_ID`
+- `AFFISE_PKG_APP_NAME`
+- `AFFISE_APP_NAME_DASHBOARD`
+- `APP_VERSION`
+- `APP_VERSION_RAW`
+- `STORE`
+- `TRACKER_TOKEN`
+- `TRACKER_NAME`
+- `FIRST_TRACKER_TOKEN`
+- `FIRST_TRACKER_NAME`
+- `LAST_TRACKER_TOKEN`
+- `LAST_TRACKER_NAME`
+- `OUTDATED_TRACKER_TOKEN`
+- `INSTALLED_TIME`
+- `FIRST_OPEN_TIME`
+- `INSTALLED_HOUR`
+- `FIRST_OPEN_HOUR`
+- `INSTALL_BEGIN_TIME`
+- `INSTALL_FINISH_TIME`
+- `REFERRAL_TIME`
+- `CREATED_TIME`
+- `CREATED_TIME_MILLI`
+- `CREATED_TIME_HOUR`
+- `UNINSTALL_TIME`
+- `REINSTALL_TIME`
+- `LAST_SESSION_TIME`
+- `CONNECTION_TYPE`
+- `CPU_TYPE`
+- `HARDWARE_NAME`
+- `NETWORK_TYPE`
+- `DEVICE_MANUFACTURER`
+- `PROXY_IP_ADDRESS`
+- `DEEPLINK_CLICK`
+- `DEVICE_ATLAS_ID`
+- `AFFISE_DEVICE_ID`
+- `AFFISE_ALT_DEVICE_ID`
+- `ADID`
+- `ANDROID_ID`
+- `ANDROID_ID_MD5`
+- `MAC_SHA1`
+- `MAC_MD5`
+- `GAID_ADID`
+- `GAID_ADID_MD5`
+- `OAID`
+- `OAID_MD5`
+- `REFTOKEN`
+- `REFTOKENS`
+- `REFERRER`
+- `USER_AGENT`
+- `MCCODE`
+- `MNCODE`
+- `ISP`
+- `REGION`
+- `COUNTRY`
+- `LANGUAGE`
+- `DEVICE_NAME`
+- `DEVICE_TYPE`
+- `OS_NAME`
+- `PLATFORM`
+- `API_LEVEL_OS`
+- `AFFISE_SDK_VERSION`
+- `OS_VERSION`
+- `RANDOM_USER_ID`
+- `AFFISE_SDK_POS`
+- `TIMEZONE_DEV`
+- `LAST_TIME_SESSION`
+- `TIME_SESSION`
+- `AFFISE_SESSION_COUNT`
+- `LIFETIME_SESSION_COUNT`
+- `AFFISE_DEEPLINK`
+- `AFFISE_PART_PARAM_NAME`
+- `AFFISE_PART_PARAM_NAME_TOKEN`
+- `AFFISE_APP_TOKEN`
+- `LABEL`
+- `AFFISE_SDK_SECRET_ID`
+- `UUID`
+- `AFFISE_APP_OPENED`
+- `PUSHTOKEN`
+- `EVENTS`
+- `AFFISE_EVENTS_COUNT`
+
+## Events tracking
+
+For example, we want to track what items usually user adds to shopping cart. To send event first create it with
+following code
+
+```typescript
+import { Affise, AddToCartEvent } from 'affise-attribution-lib';
+
+class Presenter {
+  onUserAddsItemsToCart(item: string) {
+    const items = {
+      items: 'cookies, potato, milk',
+    };
+
+    Affise.sendEvent(new AddToCartEvent(items, Date.now(), 'groceries'));
+  }
+}
+```
+
+With above example you can implement other events:
+
+- `AchieveLevelEvent`
+- `AddPaymentInfoEvent`
+- `AddToCartEvent`
+- `AddToWishlistEvent`
+- `ClickAdvEvent`
+- `CompleteRegistrationEvent`
+- `CompleteStreamEvent`
+- `CompleteTrialEvent`
+- `CompleteTutorialEvent`
+- `ContentItemsViewEvent`
+- `DeepLinkedEvent`
+- `InitiatePurchaseEvent`
+- `InitiateStreamEvent`
+- `InviteEvent`
+- `LastAttributedTouchEvent`
+- `ListViewEvent`
+- `LoginEvent`
+- `OpenedFromPushNotificationEvent`
+- `PurchaseEvent`
+- `RateEvent`
+- `ReEngageEvent`
+- `ReserveEvent`
+- `SalesEvent`
+- `SearchEvent`
+- `ShareEvent`
+- `SpendCreditsEvent`
+- `StartRegistrationEvent`
+- `StartTrialEvent`
+- `StartTutorialEvent`
+- `SubscribeEvent`
+- `TravelBookingEvent`
+- `UnlockAchievementEvent`
+- `UnsubscribeEvent`
+- `UnsubscriptionEvent`
+- `UpdateEvent`
+- `ViewAdvEvent`
+- `ViewCartEvent`
+- `ViewItemEvent`
+- `ViewItemsEvent`
+
+## Custom events tracking
+
+Use any of custom events if default doesn't fit your scenario:
+
+- `CustomId01Event`
+- `CustomId02Event`
+- `CustomId03Event`
+- `CustomId04Event`
+- `CustomId05Event`
+- `CustomId06Event`
+- `CustomId07Event`
+- `CustomId08Event`
+- `CustomId09Event`
+- `CustomId10Event`
+
+## Predefined event parameters
+
+To enrich your event with another dimension, you can use predefined parameters for most common cases.
+Add it to any event:
+
+```typescript
+import {
+  Affise,
+  AddToCartEvent,
+  PredefinedParameters,
+} from 'affise-attribution-lib';
+
+class Presenter {
+  onUserAddsItemsToCart(item: string) {
+    const items = {
+      items: 'cookies, potato, milk',
+    };
+
+    const event = new AddToCartEvent(items, Date.now());
+
+    event.addPredefinedParameter(
+      PredefinedParameters.DESCRIPTION,
+      'best before 2029'
+    );
+
+    Affise.sendEvent(event);
+  }
+}
+```
+
+In examples above `PredefinedParameters.DESCRIPTION` is used, but many others is available:
+
+- `ADREV_AD_TYPE`
+- `CITY`
+- `COUNTRY`
+- `REGION`
+- `CLASS`
+- `CONTENT`
+- `CONTENT_ID`
+- `CONTENT_LIST`
+- `CONTENT_TYPE`
+- `CURRENCY`
+- `CUSTOMER_USER_ID`
+- `DATE_A`
+- `DATE_B`
+- `DEPARTING_ARRIVAL_DATE`
+- `DEPARTING_DEPARTURE_DATE`
+- `DESCRIPTION`
+- `DESTINATION_A`
+- `DESTINATION_B`
+- `DESTINATION_LIST`
+- `HOTEL_SCORE`
+- `LEVEL`
+- `MAX_RATING_VALUE`
+- `NUM_ADULTS`
+- `NUM_CHILDREN`
+- `NUM_INFANTS`
+- `ORDER_ID`
+- `PAYMENT_INFO_AVAILABLE`
+- `PREFERRED_NEIGHBORHOODS`
+- `PREFERRED_NUM_STOPS`
+- `PREFERRED_PRICE_RANGE`
+- `PREFERRED_STAR_RATINGS`
+- `PRICE`
+- `PURCHASE_CURRENCY`
+- `QUANTITY`
+- `RATING_VALUE`
+- `RECEIPT_ID`
+- `REGISTRATION_METHOD`
+- `RETURNING_ARRIVAL_DATE`
+- `RETURNING_DEPARTURE_DATE`
+- `REVENUE`
+- `SCORE`
+- `SEARCH_STRING`
+- `SUBSCRIPTION_ID`
+- `SUCCESS`
+- `SUGGESTED_DESTINATIONS`
+- `SUGGESTED_HOTELS`
+- `TRAVEL_START`
+- `TRAVEL_END`
+- `USER_SCORE`
+- `VALIDATED`
+- `ACHIEVEMENT_ID`
+- `COUPON_CODE`
+- `CUSTOMER_SEGMENT`
+- `DEEP_LINK`
+- `EVENT_START`
+- `EVENT_END`
+- `LAT`
+- `LONG`
+- `NEW_VERSION`
+- `OLD_VERSION`
+- `REVIEW_TEXT`
+- `TUTORIAL_ID`
+- `VIRTUAL_CURRENCY_NAME`
+- `PARAM_01`
+- `PARAM_02`
+- `PARAM_03`
+- `PARAM_04`
+- `PARAM_05`
+- `PARAM_06`
+- `PARAM_07`
+- `PARAM_08`
+- `PARAM_09`
+
+## Events buffering
+
+Affise library will send any pending events with first opportunity,
+but if there is no network connection or device is disabled, events are kept locally for 7 days before deletion.
+
+## Advertising Identifier (google) tracking
+
+Advertising Identifier (google) tracking is supported automatically, no actions needed
+
+## Open Advertising Identifier (huawei) tracking
+
+Open Advertising Identifier is supported automatically, no actions needed
+
+## Install referrer tracking
+
+Install referrer tracking is supported automatically, no actions needed
+
+## Push token tracking
+
+To let affise track push token you need to receive it from your push service provider, and pass to Affise library.
+First add firebase integration to your app completing theese steps: [Firebase Docs](https://firebase.google.com/docs/cloud-messaging/android/client)
+
+After you have done with firebase inegration, add to your cloud messaging service `onNewToken` method `Affise.addPushToken(token)`
+
+```typescript
+import { Affise } from 'affise-attribution-lib';
+import messaging from '@react-native-firebase/messaging';
+
+const getToken = async () => {
+  const token = await messaging().getToken();
+  if (token) {
+    Affise.addPushToken(token);
+  }
+};
+```
+
+## Reinstall Uninstall tracking
+
+Affise automatically track reinstall events by using silent-push technology, to make this feature work, pass push token when it is recreated by user and on you application starts up
+
+```typescript
+Affise.addPushToken(token);
+```
+
+## APK preinstall tracking
+
+SDK is also supports scenario when APK is installed not from one of application markets, such as google play, huawei appgallery or amazon appstore
+To use this feature, create file with name `partner_key` in your app assets directory, and write unique identifier inside, this key will be passed to our backend so you can track events by partner later in your Affise console.
+
+## Deeplinks
+
+Register deeplink callback right after Affise.init(..)
+
+```typescript
+Affise.init(..);
+Affise.registerDeeplinkCallback((uri) => {
+
+});
+```
+
+### Android
+
+To integrate deeplink support in android you need:
+
+Add intent filter to `AndroidManifest.xml` as in `example/android/app/src/main/AndroidManifest.xml`,
+
+```xml
+<intent-filter android:autoVerify="true">
+    <action android:name="android.intent.action.VIEW" />
+
+    <category android:name="android.intent.category.DEFAULT" />
+    <category android:name="android.intent.category.BROWSABLE" />
+
+    <data
+        android:host="YOUR_AFFISE_APP_ID.affattr.com"
+        android:scheme="react" />
+</intent-filter>
+```
+
+### iOS
+
+To integrate deeplink support in iOS you need:
+
+Add deeplink handler to `AppDelegate.mm` as in `example/ios/AffiseAttributionLibExample/AppDelegate.mm`
+
+- [React Docs](https://reactnavigation.org/docs/deep-linking/#set-up-with-bare-react-native-projects)
+
+```objective-c
+- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
+  sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
+{
+  return [RCTLinkingManager application:application openURL:url
+                      sourceApplication:sourceApplication annotation:annotation];
+}
+```
+
+Add key `CFBundleURLTypes` to `Info.plist`
+
+Example: `example/ios/AffiseAttributionLibExample/Info.plist`
+
+```xml
+<key>CFBundleURLTypes</key>
+<array>
+    <dict>
+        <key>CFBundleTypeRole</key>
+        <string>Editor</string>
+        <key>CFBundleURLName</key>
+        <string>YOUR_AFFISE_APP_ID.affattr.com</string>
+        <key>CFBundleURLSchemes</key>
+        <array>
+            <string>react</string>
+        </array>
+    </dict>
+</array>
+```
+
+## Offline mode
+
+In some scenarious you would want to limit Affise network usage, to pause that activity call anywhere in your application following code after Affise init:
+
+```typescript
+Affise.init(..);
+Affise.setOfflineModeEnabled(true); // to enable offline mode
+Affise.setOfflineModeEnabled(false); // to disable offline mode
+```
+
+While offline mode is enabled, your metrics and other events are kept locally, and will be delivered once offline mode is disabled.
+Offline mode is persistent as Application lifecycle, and will be disabled with process termination automaticly.
+To check current offline mode status call:
+
+```typescript
+Affise.isOfflineModeEnabled(); // returns true or false describing current tracking state
+```
+
+## Disable tracking
+
+To disable any tracking activity, storing events and gathering device identifiers and metrics call anywhere in your application following code after Affise init:
+
+```typescript
+Affise.init(..);
+Affise.setTrackingEnabled(true); // to enable tracking
+Affise.setTrackingEnabled(false); // to disable tracking
+```
+
+By default tracking is enabled.
+
+While tracking mode is disabled, metrics and other identifiers is not generated locally.
+Keep in mind that this flag is persistent until app reinstall, and don't forget to reactivate tracking when needed.
+To check current status of tracking call:
+
+```typescript
+Affise.isTrackingEnabled().then((enabled) => {
+  // returns true or false describing current tracking state
+});
+```
+
+## Disable background tracking
+
+To disable any background tracking activity, storing events and gathering device identifiers and metrics call anywhere in your application following code after Affise init:
+
+```typescript
+Affise.init(..);
+Affise.setBackgroundTrackingEnabled(true); // to enable background tracking
+Affise.setBackgroundTrackingEnabled(false); // to disable background tracking
+```
+
+By default background tracking is enabled.
+
+While background tracking mode is disabled, metrics and other identifiers is not generated locally.
+Background tracking mode is persistent as Application lifecycle, and will be re-enabled with process termination automatically.
+To check current status of background tracking call:
+
+```typescript
+Affise.isBackgroundTrackingEnabled().then((enabled) => {
+  // returns true or false describing current background tracking state
+});
+```
+
+## GDPR right to be forgotten
+
+Under the EU's General Data Protection Regulation (GDPR): An individual has the right to have their personal data erased.
+To provide this functionality to user, as the app developer, you can call
+
+```typescript
+Affise.init(..);
+Affise.forget(); // to forget users data
+```
+
+After processing such request our backend servers will delete all users data.
+To prevent library from generating new events, disable tracking just before calling Affise.forget:
+
+```typescript
+Affise.init(..);
+Affise.setTrackingEnabled(false);
+Affise.forget(); // to forget users data
+```
+
+## Platform specific
+
+### Get referrer
+
+> `Android Only`
+
+Use the next public method of SDK
+
+```typescript
+Affise.getReferrer().then((referrer) => {
+  // returns referrer
+});
+```
+
+### Get referrer value
+
+> `Android Only`
+
+Use the next public method of SDK to get referrer value by
+
+```typescript
+Affise.android.getReferrerValue(ReferrerKey.CLICK_ID, (value) => {
+
+})
+```
+
+#### Referrer keys
+
+In examples above `ReferrerKey.CLICK_ID` is used, but many others is available:
+
+- `AD_ID`
+- `CAMPAIGN_ID`
+- `CLICK_ID`
+- `AFFISE_AD`
+- `AFFISE_AD_ID`
+- `AFFISE_AD_TYPE`
+- `AFFISE_ADSET`
+- `AFFISE_ADSET_ID`
+- `AFFISE_AFFC_ID`
+- `AFFISE_CHANNEL`
+- `AFFISE_CLICK_LOOK_BACK`
+- `AFFISE_COST_CURRENCY`
+- `AFFISE_COST_MODEL`
+- `AFFISE_COST_VALUE`
+- `AFFISE_DEEPLINK`
+- `AFFISE_KEYWORDS`
+- `AFFISE_MEDIA_TYPE`
+- `AFFISE_MODEL`
+- `AFFISE_OS`
+- `AFFISE_PARTNER`
+- `AFFISE_REF`
+- `AFFISE_SITE_ID`
+- `AFFISE_SUB_SITE_ID`
+- `AFFC`
+- `PID`
+- `SUB_1`
+- `SUB_2`
+- `SUB_3`
+- `SUB_4`
+- `SUB_5`
+
+### StoreKit Ad Network
+
+> `iOS Only`
+
+For ios prior `16.1` first call
+
+```typescript
+Affise.ios.registerAppForAdNetworkAttribution((error) => {
+  // Handle error
+});
+```
+
+Updates the fine and coarse conversion values, and calls a completion handler if the update fails.
+Second argument coarseValue is available in iOS 16.1+
+
+```typescript
+Affise.ios.updatePostbackConversionValue(1, "medium", (error) => {
+  // Handle error
+});
+```
+
+Configure your app to send postback copies to Affise:
+
+Add key `NSAdvertisingAttributionReportEndpoint` to `Info.plist`
+Set key value to `https://affise-skadnetwork.com/`
+
+Example: `example/ios/AffiseAttributionLibExample/Info.plist`
+
+```xml
+<key>CFBundleURLTypes</key>
+<array>
+    <dict>
+      <key>NSAdvertisingAttributionReportEndpoint</key>
+      <string>https://affise-skadnetwork.com/</string>
+    </dict>
+</array>
+```