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

iOS SDKの初期化

始める前に​

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

CocoaPodsガイド​

このCocoaPodsのtutorialを使用してワークスペースをセットアップします。

  1. podファイルに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で:

  • ファイル > パッケージ依存関係を追加 に移動します
  • https://github.com/ROKT/rokt-sdk-ios.gitを追加します
  • 4.6.1の次のメジャーまでを選択します

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

dependencies: [
    .package(url: "https://github.com/ROKT/rokt-sdk-ios.git", .upToNextMajor(from: "4.6.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"に設定する必要があります。

Rokt SDK for iOS の初期化​

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

注意

あなたのアカウントに関連付けられた Rokt アカウント ID については Rokt に連絡してください。統合をテストするために、以下の Rokt アカウント ID を使用できますが、プロダクション環境で開始する前に、あなた固有の Rokt アカウント ID に置き換える必要があります。

SDK の初期化​

Rokt の iOS アプリケーション用 SDK は、Rokt パートナーがオーバーレイまたは埋め込みプレースメントを表示するため、または Rokt 広告主がキャンペーンの変換を記録するために使用できます。Rokt SDK for iOS は 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からのデバッグログを有効にします。

次のステップ​

次のステップは、統合のユースケースによって異なります。これらのリソースをチェックして、詳細情報を確認してください：

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