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时，您需要将我们的Maven仓库添加到您的Android应用或项目级别的 build.gradle 文件中。

repositories {
    maven {
        url "https://sdk.tapjoy.com/"
    }
}

然后您就可以安装该插件了。

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, (event: TapjoyEvent) => {
       // Handle Warning
     },
  );

  // Handle Success
} catch (error: any) {
  // Handle Failure
}

如果连接过程中出现非阻塞问题，则会发出警告。之后会显示成功。目前，此功能仅检测在ConnectFlags中发送的 UserId 问题。 完成 Tapjoy 配置后，您可以编译并运行您的应用程序了。 恭喜！Tapjoy 现已在您的应用程序中运行。

Max User Level

您可以告诉 Tapjoy 您的游戏中有多少个等级。您可以在调用 connect 之前或之后设置此值。

Tapjoy.setMaxLevel(10); 

User Segment

您可以通过调用setUserSegment来将用户标识为某个细分群体的一部分。此设置可以在调用 connect 之前或之后进行。

Tapjoy.setUserSegment(TJSegment.VIP);
Tapjoy.setUserSegment(TJSegment.Payer);
Tapjoy.setUserSegment(TJSegment.NonPayer);
Tapjoy.setUserSegment(TJSegment.Unknown);

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);
}