iOS SDK インテグレーション
CocoaPods または手動メソッドを使用して LevelPlay SDK を iOS アプリケーションに統合し、キー
読み終わるまでの所要時間 19 分最終更新 6日前
LevelPlay SDK は、CocoaPods、Swift Package Manager、および SDK を統合するための手動ダウンロードメカニズムをサポートします。
前提条件
iOS バージョン サポートはネットワークごとに定義されます。LevelPlay 広告と LevelPlay メディエーションは、iOS バージョン 12 以上、および Xcode バージョン 15.4 以上をサポート。
iOS 14との互換性のあるLevelPlayは、SKAdNetworkアトリビューションをサポートするSDK 7以降をリリースしました。
SDK をプロジェクトに加える
CocoaPods
CocoaPodsは、Objective-CとSwiftの依存関係マネージャーであり、SDKのインテグレーション プロセスを自動化および合理化します。詳細については、 CocoaPods のドキュメント「 Getting Started and Using CocoaPods 」を参照してください。
LevelPlay SDK を CocoaPods と統合するには、Podfile に以下の行を入力します。
pod 'IronSourceSDK','9.5.0.0'
プロジェクトで Swift を使用していない場合は、「プロジェクト」>「ビルド設定」>「リンク」>「Runpath 検索パス」に移動し、以下のコードを追加します。
// needs to be first on the list /usr/lib/swift
Swift Package Manager
プロジェクトにパッケージの依存関係を追加するには、以下の手順を実行します。
- Xcode で、「ファイル」>「パッケージ依存関係を追加」を選択します。
- 表示されるプロンプトで、以下のパッケージ URL を検索します。
https://github.com/ironsource-mobile/LevelPlay-Swift-Package - 依存関係の規則で、Branch (分岐) を選択します。
- テキストフィールドに と入力します。
main
メディエーションネットワークアダプタパッケージの追加
各メディエーションネットワークには、ironsourceモバイルGitHub組織によってホストされている独自のアダプターSwiftパッケージがあります。アダプタ リポジトリは、命名形式のを使用します。例えば、Unity Ads アダプタは リポジトリに、AdMob アダプタは リポジトリにあります。
LevelPlay-<Network>-Adapter-Swift-PackageLevelPlay-UnityAds-Adapter-Swift-PackageLevelPlay-AdMob-Adapter-Swift-Packageメディエーション ネットワーク アダプタ パッケージをプロジェクトに追加するには、以下の手順を実行します。
- ironsource モバイル GitHub 組織で、追加するネットワークのアダプタ リポジトリを探します。
- リポジトリ URL をコピーします。
- Xcode で、「ファイル」>「パッケージ依存関係を追加」を選択します。
- 表示されるプロンプトに、アダプタリポジトリの URL を入力します。
- 依存関係の規則で、**Exact Version (**完全版) を選択します。
- プロジェクトの LevelPlay SDK バージョンと互換性のあるタグ付きアダプタバージョンを入力します。
互換性のあるバージョンを選択するには、「 最低アダプタおよびネットワーク SDK バージョン 」セクションと関連するアダプタ変更履歴を参照してください。追加するメディエーション ネットワークごとに、これらの手順を繰り返します。
アダプタとネットワーク SDK の最小バージョン
|
|
|
|---|---|---|
Unity Ads | 5.8.1 | 4.16.5 |
AppLovin | 5.7.1 | 13.6.2 |
BidMachine | 5.7.1 | 3.6.1 |
Digital Turbine | 5.8.1 | 8.4.6 |
Google AdMob | 5.10.1 | 13.2.0 |
HyprMX | 5.3.1 | 6.4.6 |
LY Adネットワーク | 5.4.1 | 3.0.1 |
Meta | 5.3.1 | 6.21.1 |
Mintegral | 5.18.1 | 8.1.0 |
MobileFuse | 5.2.0 | 1.11.0 |
MyTarget | 5.11.1 | 5.41.0 |
Ogury | 5.5.1 | 5.2.1 |
Pangle | 5.28.1 | 7.9.1.1 |
ブードゥー教 | 5.2.1 | 3.15.1 |
Vungle | 5.10.1 | 7.7.4 |
ヤンデックス | 5.9.1 | 8.1.0 |
手動ダウンロード
LevelPlay SDK をプロジェクトに手動で追加するには、以下の手順を実行します。
- iOS SDK バージョン 9.5.0 をダウンロードします。
- SDK を解凍し、Xcode プロジェクトにを追加します。
IronSource.framework - のビルド設定に以下のリンカー フラグを追加します。ターゲット > ビルド設定 > リンク > その他のリンカーフラグ: -ObjC
- Import libraries - "z","sqlite3.0"
- Import frameworks - "JavaScriptCore","WebKit","AdSupport","SystemConfiguration"
LevelPlay メディエーションアプリケーション
インテグレーション デモアアプリケーションは、LevelPlay Mediation をアプリケーションに統合する方法を示しています。
プロパティ リスト ファイルの更新
SKAdNetworkサポート
SDK 7 以降を使用している場合に Ironsource ネットワークワーク広告のディスプレイを有効にするには、アプリケーションのリスト(Info.plist) に Ironsource 広告ネットワーク ID が含まれていることを確認します。
-
Xcode のプロジェクトナビゲーターで、Info.plist を選択します。
-
プロパティリストエディタでキーの横にある Add (+) を選択し、Return を選択します。
-
キー名 SKAdNetworkItems を入力します。
-
「**種類」**列で、配列を選択します。
-
ディクショナリ項目を作成してから、単一の文字列項目を作成します。
-
キー名 SKAdNetworkIdentifier と以下のキー値を入力します。su67r6k2v3.skadnetwork
次のコードを使用して、Info.plist ファイルに SKAdNetworkIdentifier を追加することもできます。
<key>SKAdNetworkItems</key><array> <dict> <key>SKAdNetworkIdentifier</key> <string>su67r6k2v3.skadnetwork</string> </dict></array>
プロパティのリストを編集する方法の詳細については、Xcode のドキュメント を参照してください。
Universal SKAN レポート
宣伝対象のアプリケーションのすべてのデマンドソースからインストール検証の成功ポストバックのコピーを受け取るには、アプリケーションのInfo.plistファイルにNSAdvertisingAttributionReportEndpointキーを追加します。
- Xcode のプロジェクトナビゲーターで、Info.plist を選択します。
- プロパティリストエディタでキーの横にある Add (+) を選択し、Return を選択します。
- キー名 NSAdvertisingAttributionReportEndpoint を入力します。
- 「種類」列で、文字列を選択します。
- 以下の URL を入力します。
https://postbacks-is.com/
Universal SKAN レポートの詳細については、Add SKAdNetwork IDs manually (SKAdNetwork ID の手動追加) を参照してください。
アプリケーション転送のセキュリティ設定
すべてのメディエーション ネットワークで LevelPlay 広告配信のサポートを中断しないようにするには、Info.plist ファイルに以下の変更を加えます。
- プラス記号を選択してディクショナリを追加します。このディクショナリをトップレベルのキーに追加してください。
NSAppTransportSecurity- このディクショナリ内で、というブーリアンを追加し、タブを選択して
NSAllowsArbitraryLoadsに設定します。YES
- このディクショナリ内で、
- Info.plist ファイルに以外の例外が含まれていないことを確認します。競合が発生する可能性があるためです。
NSAllowsArbitraryLoads - アプリケーション転送のセキュリティの詳細については、Apple ドキュメントを参照してください。
LevelPlay SDK の初期化
必要なファイルのインポート
#import "IronSource/IronSource.h"
SDK の初期化
LevelPlay SDK を初期化するには、以下の手順を実行します。
- 完了ハンドラーの成功と失敗を定義します。
- 必要に応じて appKey とユーザー ID を使用して LevelPlay init API を呼び出します。
サーバー間のコールバック(ユーザーに報酬を与えるため)または広告品質ユーザージャーニーを使用している場合は、初期化リクエスト ビルダーの一部としてユーザーIDを追加します。
// キーフォーマットでリクエストビルダーを作成します。ユーザー ID がある場合は追加LPMInitRequestBuilder *requestBuilder = [[LPMInitRequestBuilder alloc] initWithAppKey:@"appKey"];[requestBuilder withUserId:@"UserId"];// Build the initial requestLPMInitRequest *initRequest = [requestBuilder build];// Initialize LevelPlay with the prepared request[LevelPlay initWithRequest:initRequest 完了:^(LPMConfiguration *_Nullable config, NSError *_Nullable error){ if(error) { // There was an error on initialization.必要なアクションを実行するか再試行してください } else { // Initialization was successful.広告オブジェクトの作成、広告のロード、その他のタスクの実行ができるようになりました }}];
初期化結果
- Success:初期化期化が正常に完了したときにトリガーされます。この通知を受け取ったら、広告を作成してロードできます。
- エラー:設定が正常に取得されず、広告をロードできませんでした。推奨されるベストプラクティスは、インターネット接続が利用可能なとき、または失敗の理由が解決されたときに、後で LevelPlay SDK を初期化してみることです。
インテグレーションの確認
LevelPlay インテグレーションテストスイートを使用して、アプリケーションのインテグレーションのテスト、プラットフォーム設定の確認、構成したネットワークに関連する広告のレビューを行います。
アプリケーションでテストスイートを有効にするには、初期化を設定する前に setMetaData API を呼び出します。
[LevelPlay setMetaDataWithKey:@"is_test_suite" value:@"enable"];
メディエーションの初期化が完了したら、以下のメソッドを呼び出してテストスイートを起動します。
[LevelPlay launchTestSuite:self];
次のステップ
- 以下のインテグレーションガイドを参照して、広告フォーマットを実装します。
- 動画リワード広告、インタースティシャル広告、バナー広告をアプリケーションに統合します。iOS のメディエーションネットワーク を参照してください。