ドキュメント

サポート

Offerwall

収益化の開始

ユーザー獲得の開始

Unity SDK の統合

Offerwall

クイックスタート

CocoaPods または Swift Package Manager を使用して Tapjoy Offerwall を iOS アプリに統合し、Offerwall の機能をすぐに有効にすることができます。
読み終わるまでの所要時間 3 分最終更新 10日前

SDK の統合

CocoaPods

CocoaPods は Objective-C と Swift の依存関係マネージャーです。 Tapjoy を使用するには、プロファイルに追加します。 
    platform :ios, '13.0'source 'https://github.com/CocoaPods/Specs.git'use_frameworks!target 'MyApp' do    pod 'TapjoySDK'end
CocoaPods を使用して統合する場合は、静的または動的フレームワークのオプションがあります。デフォルトは静的です。以下をプロファイルに追加して、動的フレームワークを選択できます。 
pod 'TapjoySDK/Dynamic'

Swift Package Manager

SDK v13.4.0 以降では、Swift Package Manager をサポートしています。 File (ファイル) > Add Packages Dependancies (パッケージ依存関係を追加) に移動します。右上の検索バーにリポジトリ 
https://github.com/Tapjoy/swift-packages.git
を貼り付け、Add Package (パッケージを追加) を選択します。

App Tracking Transparency 承認のリクエスト

アプリケーションが App Tracking Transparency を使用するように設計されている場合、IDFA へのアクセスをリクエストするダイアログを表示するには、アプリケーションで IDFA を使用するためのこの権限を説明するカスタムメッセージとともに 
NSUserTrackingUsageDescription
キーを加えて Info.plist を更新します。 例を次に示します。 
<key>NSUserTrackingUsageDescription</key><string>This allows us to deliver personalized ads for you.</string>
NSUserTrackingUsageDescription キーを含む情報プロパティリスト
 以下のスクリーンショットに示すように、使用目的の説明テキストが App Tracking Transparency 許可ダイアログの一部として表示されます。
iOS App Tracking Transparency 許可ダイアログ
 
AppTrackingTransparency
フレームワークをプロジェクトに追加し、
requestTrackingAuthorizationWithCompletionHandler:
を呼び出して承認プロンプトを表示します。Tapjoy に接続する前に
requestTrackingAuthorization
完了ハンドラーを待機することをお勧めします。これにより、すべてのリクエストで予期される IDFA 値を使用していることが保証されます。
#import <apptrackingtransparency apptrackingtransparency.h> ... - (void)fetchTrackingAuthorization { [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) { // Call the Offerwall connect function here. }]; }

Tapjoy への接続

次のステップは、アプリケーションに Tapjoy Connect のコードを追加することです。このコードのキー ビットは、アプリケーションで Offerwall SDK を "オン" にします。 Tapjoy Connect 呼び出しを実装するには、統合するアプリケーション用の Offerwall SDK キーが必要です。これを見つけるには、Tapjoy ダッシュボードでアプリケーションに移動し、上部ナビゲーションバーにある "Settings" (設定) ボタンをクリックします。"App Settings" (アプリ設定) に移動すると、ページの下部に SDK キーがあります。 次に、以下のコードスニペットをアプリケーションのアプリデリゲートファイルの 
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.アプリ公開前に無効にしてください。//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
は、接続呼び出しの前に定義する必要があります。接続フラグを使用してユーザー ID を設定することをお勧めします。そうすると、AppLaunch 配置が呼び出されたときに正しいユーザー ID を取得できるようになります。 詳細については、次の SDK リファレンスを参照してください: Objective C および C++。

接続の通知

Tapjoy の接続が終了したとき、接続されたが警告があるとき、または接続に失敗したときに通知を受け取るには、前にセレクターとして設定したメソッドを実装する必要があります。
connectWarning
コールバックは、接続中にノンブロッキングの問題がある場合に発生します (その後に 
connectSuccess
も発生します)。この機能は現在、ConnectFlags で送信されたときに UserId の問題のみを検出します。
- (void)tjcConnectSuccess:(NSNotification *)notifyObj { NSLog(@"Tapjoy connect succeeded"); }- (void)tjcConnectFail:(NSNotification *)notifyObj { NSError *error = notifyObj.userInfo[TJC_CONNECT_USER_INFO_ERROR]; NSInteger code = error.code; NSString *message = error.localizedDescription; NSString *underlyingErrorMessage = underlyingError != nil ? [NSString stringWithFormat:@" - %li %@", underlyingError.code, underlyingError.localizedDescription] : @""; NSLog(@"%@", underlyingErrorMessage); }- (void)tjcConnectWarning:(NSNotification *)notifyObj { NSError *error = notifyObj.userInfo[TJC_CONNECT_USER_INFO_ERROR]; NSError *underlyingError = error.userInfo[NSUnderlyingErrorKey]; }
次に、アプリケーションをコンパイルして実行します。すべてを正しく実行していれば、コンソールに以下のような出力が表示されます。 
        2020-01-29 16:01:55.422 App Name[25869:1433019] [TJLog level: 4] Connect success with type:0

最大ユーザーレベル

Tapjoy にゲーム内のレベル数を伝えることができます。この値は、connect を呼び出す前または後に設定できます。
[Tapjoy setMaxLevel:10];

ユーザーセグメント

setUserSegment
を呼び出すことで、ユーザーをセグメントの一部として識別できます。これは connect を呼び出す前または後に設定できます。
[Tapjoy setUserSegment:TJSegmentVIP]; [Tapjoy setUserSegment:TJSegmentPayer]; [Tapjoy setUserSegment:TJSegmentNonPayer]; [Tapjoy setUserSegment:TJSegmentUnknown]