iOS SDK を初期化する
始める前に
このガイドでは、CocoaPods または Swift Package Manager に精通し、iOS 開発のための依存関係のインストール方法を知っていることを前提としています。詳細については、CocoaPods' または Swift Package Manager's のユーザーガイドを確認してください。
CocoaPods ガイド
この CocoaPods チュートリアルを使用してワークスペースをセットアップします。
Rokt-Widget
ポッドをポッドファイルに追加します:
pod 'Rokt-Widget'
- ポッドをインストールします:
pod install
DT_TOOLCHAIN_DIR cannot be used to evaluate LIBRARY_SEARCH_PATHS use TOOLCHAIN_DIR instead
エラーが表示される場合は、以下の post install フックを Podfile に追加してください:
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
xcconfig_path = config.base_configuration_reference.real_path
xcconfig = File.read(xcconfig_path)
xcconfig_mod = xcconfig.gsub(/DT_TOOLCHAIN_DIR/, "TOOLCHAIN_DIR")
File.open(xcconfig_path, "w") { |file| file << xcconfig_mod }
end
end
end
Swift Package Manager ガイド
Xcode で:
- File > Add Package Dependencies に進む
https://github.com/ROKT/rokt-sdk-ios.git
を追加- 4.7.0 で Up to Next Major を選択
または、以下のコードを Package.swift
の dependencies
部分に追加します。
dependencies: [
.package(url: "https://github.com/ROKT/rokt-sdk-ios.git", .upToNextMajor(from: "4.7.0"))
]
Objective-C 統合についての注意: Rokt SDK for iOS は Swift を使用して実装されています。Objective-C を使用している場合は、フレームワークからブリッジングヘッダーファイルを
.h/.m
ファイルにインポートする必要があります。
#import <Rokt_Widget/Rokt_Widget-Swift.h>
インストール中に問題が発生し、SWIFT_VERSION が定義されていないというエラーが表示される場合は、ユーザー定義変数 SWIFT_VERSION
を追加してください。この変数は iOS SDK バージョン 2.0 以上の場合は "5" に設定してください。iOS SDK バージョン 1.2.1 の場合は "4.2" に設定してください。
iOS向けRokt SDKの初期化
Rokt SDKを利用する前に、iOSで初期化してください。この初期化は、ViewController
を使用する前に行う必要があります。applicationDidFinishLaunching
ハンドラからinit
メソッドを呼び出すことをお勧めします。
Roktにお問い合わせいただき、アカウントに関連付けられているRoktアカウントIDを取得してください。統合のテストを行うために、以下のRoktアカウントIDを使用することができますが、これを本番環境での起動前にあなた独自のRoktアカウントIDに置き換える必要があります。
SDKの初期化
iOSアプリケーション向けのRokt SDKは、Roktのパートナーがオーバーレイまたは埋め込みのプレースメントを表示するため、またはRoktの広告主がキャンペーンのコンバージョンを記録するために利用できます。iOS向けのRokt SDKはCocoaPodsを使ってデプロイされています。
SDKのすべてのユースケースは、アプリケーションへのインテグレーションと初期化のために最初に同じ手順に従います。これらの手順は大まかに以下の通りです:
- CocoaPod/Swift Package Managerを使用してワークスペースをセットアップ
Rokt-Widget
を追加- ポッド/パッケージをインストール
- Rokt SDKを初期化
これらの手順に続いて、SDKのexecute
メソッドを必要なユースケースに合わせて様々に活用できます。
テスト用RoktアカウントID: 222
- Swift
- Objective-C
//file => AppDelegate.swift
import Rokt_Widget
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// 次を実行するとデモ統合が表示されます。あなたの統合を表示するには、インテグレーションテストタグID(222)をあなた独自のRoktタグIDに置き換えてください
Rokt.initWith(roktTagId: "222")
return true
}
//file => AppDelegate.m
#import <Rokt_Widget/Rokt_Widget-Swift.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// アプリケーション起動後のカスタマイズのためのオーバーライドポイント。
[Rokt initWithRoktTagId:@"222"];
return YES;
}
初期化ステータスの受信
バージョン 4.6.0
から、Rokt SDK は初期化ステータスを受け取る2つの方法を提供します:
初期化時の任意のコールバック
初期化が完了したときにステータスを通知するためのコールバックが Rokt.initWith
メソッドにあります。
Rokt.initWith(roktTagId: "222") { status in
print("Rokt初期化がステータスで完了しました: \(status)")
}
グローバルイベントAPI
SDKはまた、Rokt.globalEvents
APIを通じてステータスを提供します。
Rokt.globalEvents() { roktEvent in
if let initEvent = roktEvent as? RoktEvent.InitComplete {
print("Rokt初期化がステータスで完了しました: \(initEvent.success)")
}
}
デバッグ
Rokt.setLoggingEnabled(enable: true)
APIを使用して、Rokt SDKからのデバッグログを有効にします。
次のステップ
次のステップは、統合のユースケースに依存します。詳細については、これらのリソースを確認してください: