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

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 エラーが表示される場合は、以下の post install フックを 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.7.0 で Up to Next Major を選択

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

dependencies: [
    .package(url: "https://github.com/ROKT/rokt-sdk-ios.git", .upToNextMajor(from: "4.7.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の初期化​

Rokt SDKを利用する前に、iOSで初期化してください。この初期化は、ViewControllerを使用する前に行う必要があります。applicationDidFinishLaunchingハンドラからinitメソッドを呼び出すことをお勧めします。

注意

Roktにお問い合わせいただき、アカウントに関連付けられているRoktアカウントIDを取得してください。統合のテストを行うために、以下の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からのデバッグログを有効にします。

次のステップ​

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

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