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
を追加- Up to Next Major を選択し、バージョンを 4.5.0 に設定
または、以下のコードを Package.swift
の dependencies
部分に追加します。
dependencies: [
.package(url: "https://github.com/ROKT/rokt-sdk-ios.git", .upToNextMajor(from: "4.5.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 の初期化
任意の ViewController
で使用する前に、iOS 用 Rokt SDK を初期化します。applicationDidFinishLaunching
ハンドラーから init
メソッドを呼び出すことをお勧めします。
アカウントに関連付けられた Rokt アカウント ID については、Rokt にお問い合わせください。統合をテストするために、以下の Rokt アカウント ID を使用できますが、本番環境でのローンチ前に、これを一意の Rokt アカウント ID に置き換える必要があります。
SDK の初期化
iOS アプリケーション用 Rokt SDK は、Rokt パートナーがオーバーレイまたは埋め込みプレースメントを表示するため、または Rokt 広告主がキャンペーンのコンバージョンを記録するために使用できます。iOS 用 Rokt SDK は CocoaPods を使用してデプロイされます。
SDK のすべてのユースケースは、アプリケーションに SDK を統合および初期化するための同じ初期手順に従います。大まかな手順は次のとおりです:
- CocoaPod/Swift Package Manager を使用してワークスペースを設定する
Rokt-Widget
を追加する- pod/パッケージをインストールする
- 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;
}
デバッグ
Rokt.setLoggingEnabled(enable: true)
API を使用して、Rokt SDK からのデバッグログを有効にします。
次のステップ
次のステップは、統合のユースケースによって異なります。詳細については、以下のリソースを確認してください: