快速入门

1. 控制面板集成指南

在Tapjoy控制面板中内置的集成指南,可以帮助您完成Tapjoy SDK 集成。如果愿意,可以使用此入门指南文档作为参考,也可以直接转到适用于您应用程序的集成指南

2. SDK集成

A. Cocoapods (推荐 )

CocoaPods是Objective-C和Swift的依赖项管理器。 我们建议使用CocoaPods来使Tapjoy SDK保持最新。

要使用Tapjoy,只需将其添加到您的Podfile中即可:

    platform :ios, '9.0'
    source 'https://github.com/CocoaPods/Specs.git'

    use_frameworks!

    target 'MyApp' do
        pod 'TapjoySDK'
    end

B. Swift

如果您使用Swift,您需要创建一个bridging头文件

  1. 创建一个头文件并命名为: "[ProjectName]-Bridging-Header.h"
  2. 添加 #import "Tapjoy/Tapjoy.h 到都文件中.
  3. 到build settings, 找到"bridging header" 并设置文件路径。您也可以直接拖拽到您的工程中。

3. Connect to Tapjoy

下一步是将Tapjoy connect代码添加到您的应用中。 这是在您应用中使用Tapjoy SDK的关键步骤。

Tapjoy connect 调用非常重要,如果实现不正确,Tapjoy的任何产品和功能都将不能使用。

为了实现Tapjoy connect 调用,您需要您要集成应用的Tapjoy SDK Key. 在您应用的Tapjoy 控制面板中,点击顶部导航栏的“设置”-“应用设置”,您可以在页面底部找到SDK key。

在您的应用的delegate文件didFinishLaunchingWithOptions: method中添加以下代码::

Objective-C
Swift
- (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];

    //Turn on Tapjoy debug mode
    [Tapjoy setDebugEnabled:YES]; //Only enable debug mode for development. Disable it before publishing your app.

    //If you are using Self-Managed currency, you would set your own user ID here.
    [Tapjoy setUserID:@"A_UNIQUE_USER_ID"];
    
    //The Tapjoy connect call
    [Tapjoy connect:@"Your-iOS-SDK-Key-from-the-dashboard-goes-here"];

    return YES;
}

用您的SDK Key替换"Your-SDK-Key-iOS-from-the-dashboard-here"。

setDebugEnabled 和 setUserID要定义在connect 调用之前。在connect 之前设置user ID可以保证Applaunch展示位调用时可以返回正确的user ID。对于Push2Earn展示位同样需要这样设置。

我们SDK参考文档:Obective CC++

Connect Notifications

为了收到连接成功与否的消息,您还需要添加在您应用的Delegate类中添加如下代码:

Objective-C
Swift
- (void)tjcConnectSuccess:(NSNotification *)notifyObj 
{
    NSLog(@"Tapjoy connect succeeded");
}

- (void)tjcConnectFail:(NSNotification *)notifyObj 
{
    NSLog(@"Tapjoy connect failed");
}

现在可以编译并运行您的应用。如果Connect成功,可以看到以下Log:

2020-01-29 16:01:55.422 Storyteller Roller[25869:1433019] [TJLog level: 4] Connect success with type:0

在Tapjoy 控制面板中,在顶部导航栏里点击“分析” ,然后在左侧导航栏里点击“实时分析”,您可以在看到您应用的实时数据。

恭喜!Tapjoy SDK已经可以和您的应用正常工作。