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

iOS SDK を初期化する

開始する前に​

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

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 を追加
  • 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の全ての利用ケースでは、アプリケーションへの統合と初期化は同じ初期ステップに従います。大まかに言うと、これらのステップは次のとおりです:

  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 の初期化がステータス: \(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 のデバッグログを有効にします。

次のステップ​

次のステップは、統合のユースケースに依存します。詳細については、これらのリソースを参照してください:

この記事は役に立ちましたか？