The Tenjin React Native Plugin allows users to track events and installs in their iOS/Android apps. To learn more about Tenjin and our product offering, please visit https://www.tenjin.com.
On iOS:
For AppTrackingTransparency, be sure to update your project .plist
file and add NSUserTrackingUsageDescription
along with the text message you want to display to users. This library is only available in iOS 14.0+. For further information on this, you can check our iOS documentation
$ npm install react-native-tenjin --save
$ react-native link react-native-tenjin
import Tenjin from 'react-native-tenjin';
You need to initialize the plugin before doing calling any of the other methods available, for this, you would need the api key provided on Tenjin's dashboard:
Tenjin.initialize(apiKey)
Parameters:
-
apiKey
: String
Tenjin.connect()
Tenjin.setAppStore(type)
Parameters:
-
type
: String, possible values (googleplay, amazon, other)
Tenjin.optIn()
Tenjin.optOut()
Tenjin.optIn(parameters)
Parameters:
-
parameters
: Array
Tenjin.optOut(parameters)
Parameters:
-
parameters
: Array
Tenjin.optInOutUsingCMP()
Tenjin.optOutGoogleDMA()
Tenjin.optInGoogleDMA()
transactionWithReceipt(productName, currencyCode, quantity, unitPrice, transactionId, receipt)
Parameters:
-
productName
: String -
currencyCode
: String -
quantity
: Number -
unitPrice
: Number -
transactionId
: String -
receipt
: String (Base 64)
Tenjin.eventWithName(name)
Parameters:
-
name
: String
Tenjin.eventWithNameAndValue(name, value)
Parameters:
-
name
: String -
value
: String
Tenjin.getAttributionInfo(
(success) => {
console.log(`Attibution info found! ${success}`);
},
() => {
console.error(`Attribution info failed`);
}
)
Parameters:
-
successCallback
: Callback -
errorCallback
: Callback
Tenjin.appendAppSubversion(subversion)
Parameters:
-
subversion
: Number
Tenjin.setCustomerUserId(userId)
Parameters:
-
userId
: string
Tenjin.getCustomerUserId()
Returns: callback -> string
Tenjin.getAnalyticsInstallationId()
Returns: callback -> string
Tenjin.eventAdImpressionAdMob(json)
Parameters:
-
json
: JSON
Tenjin.eventAdImpressionAppLovin(json)
Parameters:
-
json
: JSON
Tenjin.eventAdImpressionHyperBid(json)
Parameters:
-
json
: JSON
Tenjin.eventAdImpressionIronSource(json)
Parameters:
-
json
: JSON
Tenjin.eventAdImpressionTopOn(json)
Parameters:
-
json
: JSON
Tenjin.eventAdImpressionTradPlus(json)
Parameters:
-
json
: JSON
Tenjin.setGoogleDMAParametersWithAdPersonalization(adPersonalization, adUserData)
Parameters:
-
adPersonalization
: Boolean -
adUserData
: Boolean
As part of SKAdNetwork, we created a wrapper method for updatePostbackConversionValue(conversionValue: Integer)
.
Our method will register the equivalent SKAdNetwork methods and also send the conversion values to our servers.
updatePostbackConversionValue(conversionValue: Integer)
6 bit value should correspond to the in-app event and shouldn’t be entered as binary representation but 0-63 integer.
As of iOS 16.1, which supports SKAdNetwork 4.0, you can now send coarseValue
(String, with possible variants being "low", "medium" or "high") and lockWindow
(Boolean) as parameters on the update postback method:
updatePostbackConversionValue(conversionValue: Integer, coarseValue: String)
updatePostbackConversionValue(conversionValue: Integer, coarseValue: String, lockWindow: Bool)
-
For iOS version 16.1+ which supports SKAdNetwork 4.0, you can call this method as many times as you want and can make the conversion value lower or higher than the previous value.
-
For iOS versions lower than 16.1 supporting SKAdnetWork versions lower than 4.0, you can call this method and our SDK will automatically detect the iOS version and update
conversionValue
only.
If you have any issues with the plugin integration or usage, please contact us to support@tenjin.com