Quickstart

1. 最低版本要求

  • React Native: 0.71.6
  • Node 14 or newer
  • Ruby 2.7.6
  • iOS: 12.4
  • Android: 5.0 (API 21)

2. SDK集成

第一步是安装Tapjoy React Native Plugin. 我们支持NPM和Yarn.

NPM

npm install tapjoy-react-native-sdk

Yarn

yarn add tapjoy-react-native-sdk

您可以在您的应用中导入plugin:

import {Tapjoy, TJPlacement} from 'tapjoy-react-native-sdk'

添加应用权限 (for Android)

ACCESS_WIFI_STATE 权限是可选的,可以将其添加到您的manifest:

<manifest ...>
  ...
  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
  ...
</manifest>

3. 连接Tapjoy

调用connect意味着初始化Tapjoy SDK。建议在您的应用启动时调用初始化。

try {

    let sdkKey = Platform.OS === 'ios' ? 'ios-sdk-key' : 'android-sdk-key'
    let flags: object = {TJC_OPTION_USER_ID: 'userId'};

    await Tapjoy.connect(sdkKey, flags);

} catch (error) {
    console.error(error);            
}

现在您就可以尝试编译运行您的应用了。

在Tapjoy控制面板,您点击在顶层导航栏中“分析”,在左侧菜单栏中点击“实时”,您可以看到您应用运行相关的活动信息。

4. 请求 App Tracking Transparency authorization

如果您的应用使用 App Tracking Transparency, 来请求使用IDFA,您需要在Info.plist配置NSUserTrackingUsageDescription key和自定义的描述信息。

然后安装react-native-tracking-transparency package:

yarn add react-native-tracking-transparency

导入并展示请求对话框:

import {
    getTrackingStatus,
    requestTrackingPermission,
} from 'react-native-tracking-transparency';

...

let trackingStatus = await getTrackingStatus();
if (trackingStatus === 'authorized' || trackingStatus === 'unavailable') {
    await Tapjoy.connect(sdkKey, flags);
}else{
    trackingStatus = await requestTrackingPermission();
    await Tapjoy.connect(sdkKey, flags);
}