メインコンテンツまでスキップ

iOS SDK の初期化 (レガシー)

始める前に​

このガイドは、CocoaPods または Swift Package Manager に精通しており、iOS 開発のための依存関係のインストール方法を知っていることを前提としています。詳細については、CocoaPods または Swift Package Manager のユーザーガイドを参照してください。

CocoaPods ガイド​

CocoaPods の チュートリアル を使用してワークスペースをセットアップします。

  1. Rokt-Widget ポッドをポッドファイルに追加します:
pod 'Rokt-Widget'
  1. ポッドをインストールします:
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.x.x に設定

または、以下のコードを Package.swift の dependencies 部分に追加します。

dependencies: [
    .package(url: "https://github.com/ROKT/rokt-sdk-ios.git", .upToNextMajor(from: "4.x.x"))
]

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の初期化​

iOS向けRokt SDKは、任意のViewControllerで使用する前に初期化してください。applicationDidFinishLaunchingハンドラーからinitメソッドを呼び出すことをお勧めします。

注意

ご自身のアカウントに関連付けられたRoktアカウントIDについては、Roktにお問い合わせください。統合をテストするために、以下のRoktアカウントIDを使用できますが、本番環境でのリリース前に、これをあなたのユニークなRoktアカウントIDに置き換える必要があります。

SDKの初期化​

iOSアプリケーション向けRokt SDKは、Roktのパートナーがオーバーレイまたは埋め込みプレースメントを表示するため、またはRoktの広告主がキャンペーンのコンバージョンを記録するために使用できます。iOS向けRokt SDKはCocoaPodsを使用してデプロイされます。

SDKのすべてのユースケースは、アプリケーションにSDKを統合し初期化するための同じ初期ステップに従います。大まかなステップは以下の通りです：

  1. CocoaPod/Swift Package Managerを使用してワークスペースをセットアップ
  2. Rokt-Widgetを追加
  3. ポッド/パッケージをインストール
  4. Rokt SDKを初期化

これらのステップに続いて、SDKのexecuteメソッドを様々な方法で使用し、必要なユースケースに適合させることができます。

テスト用RoktアカウントID: 222

//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
}

初期化ステータスの受信​

バージョン 4.6.0 から、Rokt SDK は初期化のステータスを受け取るための2つの方法を提供します：

初期化時のオプションコールバック​

Rokt.initWith メソッドには、初期化が完了したときに通知し、ステータスを返すコールバックがあります。

Rokt.initWith(roktTagId: "222") { status in
    print("Rokt init completed with status: \(status)")
}

グローバルイベントAPI​

SDKはまた、Rokt.globalEvents APIを通じてステータスを提供します。

Rokt.globalEvents() { roktEvent in
    if let initEvent = roktEvent as? RoktEvent.InitComplete {
        print("Rokt init completed with status: \(initEvent.success)")
    }
}

デバッグ​

Rokt.setLoggingEnabled(enable: true) API を使用して、Rokt SDK からのデバッグログを有効にします。

次のステップ​

次のステップは、統合のユースケースに依存します。詳細については、以下のリソースを確認してください。

この記事は役に立ちましたか？
Last updated Oct 29, 2025