快速入门
将 Tapjoy Unity 插件包导入项目,配置 SDK 密钥,然后将 Tapjoy 游戏对象添加到第一个场景中以开始集成。
阅读时间2 分钟最后更新于 5 天前
最低要求
- React Native:0.71.6
- Node 14 或更高版本
- Ruby 2.7.6
- iOS:13.0
- Android:5.0 (API 21)
SDK 集成
为了与应用集成,第一步是安装 Tapjoy React Native 插件。我们支持 NPM 和 Yarn。NPM
使用 NPM 时,您需要将 Maven 代码仓库添加到 Android 应用或项目级别 build.gradle 文件中。然后即可安装插件。repositories { maven { url "https://sdk.tapjoy.com/" }}
npm install tapjoy-react-native-sdk
Yarn
然后,可以将 Tapjoy 导入您的应用程序以使用该插件:yarn add tapjoy-react-native-sdk
import {Tapjoy, TJPlacement} from 'tapjoy-react-native-sdk'
添加应用权限(适用于 Android)
(可选)将ACCESS_WIFI_STATE<manifest ...> ... <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> ...</manifest>
连接到 Tapjoy
我们初始化 Offerwall SDK 的方法是使用 connect 调用。在应用启动后尽快执行此调用。连接期间出现非阻塞问题时将发出警告。随后仍将显示成功。目前,此功能仅用于检测在 ConnectFlags 中发送的 UserId 的相关问题。 完成 Tapjoy 的配置后,即可构建和运行您的应用程序。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}
Logging
可使用以下方法来获取和设置日志记录级别。// Set logging levelTapjoy.setLoggingLevel(TJLoggingLevel.Debug);// Get logging levelvar loggingLevel = await Tapjoy.getLoggingLevel();
最大用户等级
您可以告诉 Tapjoy 您的游戏中有多少关卡。此值可以在调用 connect 之前或之后设置。Tapjoy.setMaxLevel(10);
用户细分段
您可以通过调用setUserSegmentTapjoy.setUserSegment(TJSegment.VIP);Tapjoy.setUserSegment(TJSegment.Payer);Tapjoy.setUserSegment(TJSegment.NonPayer);Tapjoy.setUserSegment(TJSegment.Unknown);
请求应用追踪透明度授权
如果应用程序需要使用应用追踪透明度框架,为了显示 IDFA 访问权限请求对话框,请更新 Info.plist,在其中包含 NSUserTrackingUsageDescription 键以及自定义消息(描述在应用程序中需要此权限才能使用 IDFA)。 接下来安装react-native-tracking-transparency导入库,然后显示权限对话框: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);}