手動での統合
SDK を手動で追加し、Offerwall 機能が有効になるようにプロジェクトを設定することで、Tapjoy Offerwall を iOS アプリに統合できます。
読み終わるまでの所要時間 3 分最終更新 10日前
SDK のダウンロード
アプリと統合するための最初のステップは、iOS SDK をダウンロード することです。SDK をプロジェクトに追加する
SDK を解凍すると、ドキュメント、ライブラリ、TapjoyEasyApp があります。 "TapjoyEasyApp" は、Tapjoy の統合を実演するサンプルプロジェクトです。Tapjoy をアプリケーションに統合する際には必要ありませんが、有用なリファレンスです。 ファイルをプロジェクトに追加するには、File (ファイル) を選択し、Add files to Project (ファイルをプロジェクトに追加) を選択します。"Libraries" フォルダーに移動し、Tapjoy.xcframeworkOther Linker Flags (OTHER_LDFLAGS)-ObjC必要なフレームワークを追加する
次のステップは、必要なフレームワークをプロジェクトに追加することです。これを行うには、プロジェクトナビゲーターでプロジェクトのアイコンをクリックし、"Build Phases" (ビルドフェーズ) を選択します。次に、"Link Binary With Libraries" (バイナリをライブラリにリンク) を展開し、セクションの左下にある "+" 記号をクリックします。フレームワークはアルファベット順に一覧表示され、CMD キーを長押しして複数のフレームワークを選択し、1 ステップで追加できます。 以下のすべてのフレームワークをプロジェクトに追加します。- AdSupport
- CFNetwork
- CoreTelephony
- StoreKit
- SystemConfiguration
- UIKit
- WebKit
- libc++
- libz
App Tracking Transparency 承認のリクエスト
アプリケーションが App Tracking Transparency を使用するように設計されている場合、IDFA へのアクセスをリクエストするダイアログを表示するには、アプリケーションで IDFA を使用するためのこの権限を説明するカスタムメッセージとともにNSUserTrackingUsageDescription<key>NSUserTrackingUsageDescription</key><string>This allows us to deliver personalized ads for you.</string>
AppTrackingTransparencyrequestTrackingAuthorizationWithCompletionHandler:requestTrackingAuthorizationobjective-c #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.アプリ公開前に無効にしてください。//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