文档

支持

快速入门

在 Flutter 中设置 Tapjoy,包括导入插件、添加 SDK 密钥并在应用中初始化,以便您可以快速开始请求广告位。
阅读时间2 分钟最后更新于 5 天前

最低要求

  • Flutter:3.3.0
  • Dart:3.0.0
  • iOS:13.0
  • Android:5.0 (API 21)

SDK 集成

为了与应用集成,第一步是安装 Tapjoy Flutter 插件。

Pub.dev

flutter pub add tapjoy_offerwall

添加 Offerwall Maven 代码仓库 (Android)

将 Offerwall Maven 代码仓库和 Offerwall SDK 依赖项添加到您的 android/app/build.gradle 文件中。
repositories { maven { name "Tapjoy's maven repo" url "https://sdk.tapjoy.com/" }}dependencies { implementation 'com.tapjoy:tapjoy-android-sdk:14.4.0'}
然后,可以将 Tapjoy 导入您的应用程序以使用该插件:
import 'package:tapjoy_offerwall/tapjoy_offerwall.dart';

连接到 Tapjoy

我们初始化 Offerwall SDK 的方法是使用 connect 调用。在应用启动后尽快执行此调用。
final Map<String, dynamic> optionFlags = {};Tapjoy.connect( sdkKey: 'SDK_KEY', options: optionFlags, onConnectSuccess: () async { }, onConnectFailure: (int code, String? error) async { }, onConnectWarning: (int code, String? warning) async { });
完成 Tapjoy 的配置后,即可构建和运行您的应用程序。

Logging

可使用以下方法来获取和设置日志记录级别。
// Set logging levelTapjoy.setLoggingLevel(TJLoggingLevel.debug)// Get logging levelvar loggingLevel = await Tapjoy.getLoggingLevel();

最大用户等级

您可以告诉 Tapjoy 您的游戏中有多少关卡。此值可以在调用 connect 之前或之后设置。
Tapjoy.setMaxLevel(10);

用户细分段

您可以通过调用
setUserSegment
将用户标识为某个细分段的一部分。此设置可以在调用 connect 之前或之后进行。
Tapjoy.setUserSegment(TJSegment.nonPayer);Tapjoy.setUserSegment(TJSegment.payer);Tapjoy.setUserSegment(TJSegment.vip);Tapjoy.setUserSegment(TJSegment.unknown);

请求应用追踪透明度授权

如果应用程序需要使用应用追踪透明度框架,为了显示 IDFA 访问权限请求对话框,请更新 Info.plist,在其中包含 NSUserTrackingUsageDescription 键以及自定义消息(描述在应用程序中需要此权限才能使用 IDFA)。 接下来安装
app_tracking_transparency
flutter pub add app_tracking_transparency
导入库,然后显示权限对话框:
import 'package:app_tracking_transparency/app_tracking_transparency.dart';...final status = await AppTrackingTransparency.requestTrackingAuthorization();