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
を受け取った場合は、以下のポストインストールフックを 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.8.1 の Up to Next Major を選択
または以下のコードを Package.swift
の dependencies
部分に追加します。
dependencies: [
.package(url: "https://github.com/ROKT/rokt-sdk-ios.git", .upToNextMajor(from: "4.8.1"))
]
Objective-C 統合に関する注意: iOS 用 Rokt SDK は 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を初期化する
任意のViewController
で使用する前にiOS向けRokt SDKを初期化してください。applicationDidFinishLaunching
ハンドラからinit
メソッドを呼び出すことをお勧めします。
アカウントに関連付けられたRoktアカウントIDについては、Roktにお問い合わせください。統合をテストするには、以下の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 のデバッグログを有効にします。
次のステップ
次のステップは、統合のユースケースに依存します。詳細については、これらのリソースを参照してください: