手动集成
手动添加 SDK 并配置项目以启用 Offerwall 功能，即可将 Tapjoy Offerwall 集成到 iOS 应用中。
阅读时间5 分钟最后更新于 5 天前
下载 SDK
为了与应用集成，第一步是下载 iOS SDK 本身。将 SDK 添加到您的项目中
解压缩 SDK 后，您将发现有文档、库和 TapjoyEasyApp。 “TapjoyEasyApp”是一个用于演示 Tapjoy 集成方法的示例项目。您将 Tapjoy 集成到自己的应用程序中时并不需要这个示例项目，但可以将它作为有用的参考。 要将文件添加到项目中，请选择“File（文件）”和“Add files to Project（将文件添加到项目中）”。导航到“Libraries”文件夹，然后选择Tapjoy.xcframeworkOther Linker Flags (OTHER_LDFLAGS)-ObjC添加需要的框架
下一步是将需要的框架添加到您的项目中。为此，请单击 Project Navigator（项目导航器）中的项目图标，然后选择“Build Phases（构建阶段）”，展开“Link Binary With Libraries（链接二进制文件与库）”，然后单击该部分左下角的“+”符号。框架按字母顺序列出，可以按住 CMD 键来选择多个框架，从而在一个步骤中添加所有这些框架。 将以下所有框架添加到您的项目中：- AdSupport
- CFNetwork
- CoreTelephony
- StoreKit
- SystemConfiguration
- UIKit
- WebKit
- libc++
- libz
请求应用追踪透明度授权
如果应用程序需要使用应用追踪透明度框架，为了显示 IDFA 访问权限请求对话框，请更新 Info.plist，在其中包含NSUserTrackingUsageDescription<key>NSUserTrackingUsageDescription</key><string>This allows us to deliver personalized ads for you.</string>
AppTrackingTransparencyrequestTrackingAuthorizationWithCompletionHandler:requestTrackingAuthorization#import <AppTrackingTransparency/AppTrackingTransparency.h> ... - (void)fetchTrackingAuthorization { [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) { // Call the Offerwall connect function here. }]; }
连接到 Tapjoy
下一步是将 Tapjoy connect 代码添加到您的应用程序中。这段关键代码将在应用程序中“激活”Offerwall SDK。注意
Tapjoy connect 调用极其重要，因为如果未能正确实现，Tapjoy 的所有产品或功能都将无法使用。
application:didFinishLaunchingWithOptions- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(tjcConnectSuccess:) name:TJC_CONNECT_SUCCESS object:nil]; [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(tjcConnectFail:) name:TJC_CONNECT_FAILED object:nil]; [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(tjcConnectWarning:) name:TJC_CONNECT_WARNING object:nil]; //Turn on Tapjoy debug mode [Tapjoy setLoggingLevel:TJLoggerLevelDebug]; //Only enable debug mode for development.Disable it before publishing your app. //If you are using Self-Managed currency, you need to set a user ID using the connect flags. NSDictionary *connectFlags = @{TJC_OPTION_USER_ID : @"<USER_ID_HERE>"}; [Tapjoy connect:@"SDK_KEY_GOES_HERE" options:connectFlags]; //If you are not using connect flags, you can omit them [Tapjoy connect:@"SDK_KEY_GOES_HERE"]; return YES;}
setLoggingLevel连接通知
为了在 Tapjoy 成功连接、已连接但有警告或连接失败时收到相关通知，您需要实现我们先前设置为选择器的方法。当连接过程中出现非阻塞问题时，connectWarningconnectSuccess- (void)tjcConnectSuccess:(NSNotification *)notifyObj { NSLog(@"Tapjoy connect succeeded"); }- (void)tjcConnectFail:(NSNotification *)notifyObj { NSLog(@"Tapjoy connect failed");}- (void)tjcConnectWarning:(NSNotification *)notifyObj { NSError *error = notifyObj.userInfo[TJC_CONNECT_USER_INFO_ERROR]; NSError *underlyingError = error.userInfo[NSUnderlyingErrorKey];}
在 Tapjoy 后台中，如果单击顶部导航栏中的“Analytics（分析）”，然后单击左侧导航栏中的“Real-time（实时）”选项卡，则会在运行应用程序后不久显示应用程序的活动。2020-01-29 16:01:55.422 Storyteller Roller[25869:1433019] [TJLog level: 4] Connect success with type:0