iOS SDK 統合手順

この記事では、iOS SDK v9.x を Xcode プロジェクトに統合する方法について説明します。 さまざまな広告タイプの表示手順については、「 iOS SDK の広告ユニット」を参照してください。

要件

  • アプリは iOS 15.0 以降をターゲットにする必要があります。
  • 広告を要求するには、有効なプレースメント ID を使用します。 サポートされている広告ユニットでは、代わりに有効なメンバー ID とインベントリ コードを使用できます。

インストール

重要

Swift パッケージ マネージャー (SPM) は、iOS SDK を統合するための主要な推奨方法です。 CocoaPods のサポートは、次の SDK リリースで廃止されます。

インストール方法の選択:

メソッド 状態
Swift パッケージ マネージャー 推奨
XCFramework 手動統合
カルタゴ 代替統合
CocoaPods サポート終了

Swift パッケージ マネージャー

  1. プロジェクトを Xcode で開きます。

  2. プロジェクト ナビゲーターでプロジェクトを選択し、[ Package Dependencies] を選択します。

  3. [ + ] ボタンを選択して、パッケージの依存関係を追加します。

    Xcode の [パッケージ依存関係] ウィンドウのスクリーンショット。

  4. 検索ボックスに次のパッケージの URL を入力し、 Return キーを押します。

    https://github.com/appnexus/mobile-sdk-ios-spm

    Xcode に入力された iOS SDK パッケージの URL のスクリーンショット。

  5. プロジェクトに合ったバージョン設定を選択します。 新しいプロジェクトの場合は、[ 次のメジャー バージョンまで] を選択します。 次に、[ パッケージの追加] を選択します。

  6. [Choose package Products for mobile-sdk-ios-spm ] ウィンドウで、[ AppNexusSDK とアプリ ターゲット] を選択します。 次に、[ パッケージの追加] を選択します。

    Xcode での AppNexusSDK 製品の選択のスクリーンショット。

  7. AppNexusSDK が [パッケージの依存関係] の下に表示されていることを確認します。

代替のインストール方法

これらの方法は、Swift パッケージ マネージャー がプロジェクトの要件を満たしていない場合にのみ使用してください。

XCFramework

iOS SDK v9.14.0 をダウンロードします。 ZIP ファイルには、次のフレームワークとリソース バンドルが含まれています。 一般的な統合には AppNexusSDK を使用します。

フレームワーク 説明
AppNexusSDK すべての広告タイプをサポートします。
AppNexusNativeSDK このフレームワークは、 iOS 上のネイティブ広告のみをサポートします。
AppNexusNativeMacOSSDK このフレームワークは、 macOS のネイティブ広告のみをサポートします。
ANSmartAdapter スマート広告サーバー用のメディエーション アダプター。
ANGoogleAdapter Google の AdMob 用のメディエーション アダプター。
ANFacebookCSRAdapter Facebook Audience Network 用のクライアント側レンダリング アダプター。
ANVungleAdapter Vungle のメディエーション アダプター。
ANSDKResources.bundle これには、SDK が利用する必要なファイルが含まれています。

  1. アプリの Xcode プロジェクトまたはワークスペースを開きます。

  2. アプリ ターゲットの [全般 ] 設定ページに移動します。

  3. AppNexusSDKを使用するには、AppNexusSDK.xcframeworkとANSDKResources.bundleを追加します。

  4. AppNexusSDK.xcframeworkをインポートするには:

    • プロジェクトのターゲット設定に移動します。
    • [ ターゲット>全般] に移動します。
    • [フレームワーク、ライブラリ、埋め込みコンテンツ] セクションの下にある [+] ボタンをクリックします。
    • [Add Other ]、[Add Files] の順にクリックします。
    • AppNexusSDK.xcframeworkファイルを選択し、[開く] をクリックします。

    Xcode で AppNexusSDK XCFramework を追加するスクリーンショット。

  5. ANSDKResources.bundleを含めるには:

    • ターゲット>ビルド フェーズに移動します。
    • [ Copy Bundle Resources ] 行を展開し、 + アイコンをクリックします。
    • ANSDKResources.bundleファイルを選択し、[開く] をクリックします。

    Xcode に ANSDKResources バンドルを追加するスクリーンショット。

カルタゴ

カルタゴに慣れていない場合は、 カルタゴのドキュメントを参照してください。 Carthage をインストールしたら、次の手順に従います。

  1. ターミナルを開き、プロジェクトのルート ディレクトリに移動します。 カートファイルの作成:

    touch Cartfile

  2. Xcode で Cartfile を開きます。

    open -a Xcode Cartfile

  3. カート ファイルに次の行を追加します。

    binary "https://adsdkprod.azureedge.net/mobile/ios/releases/carthage/AppNexusSDK.json"
binary "https://adsdkprod.azureedge.net/mobile/ios/releases/carthage/OMSDK_Microsoft.json"

    ヒント

    Cartfileではまっすぐの引用符を使用します。 Carthage では、一部のテキスト エディターによって挿入されたスマート引用符が認識されません。

  4. Cartfile を保存し、依存関係を更新します。

    carthage update --use-xcframeworks

  5. Target>General>Embedded バイナリにAppNexusSDKDynamic.xcframeworkとOMSDK_AppNexus.xcframeworkを追加します。

  6. アプリケーション ターゲットの場合は、[ 署名 & 埋め込み] を選択します。 その他のターゲットの場合は、[ 埋め込みしない] を選択します。

CocoaPods

警告

CocoaPods のサポートは、次の SDK リリースで廃止されます。 新しい統合には Swift パッケージ マネージャー を使用します。

CocoaPods に慣れていない場合は、 CocoaPods のドキュメントを参照してください。 CocoaPods をインストールしたら、次の手順を実行します。

  1. Terminal で、プロジェクトのルートディレクトリに移動し、Podfile を作成します。

    pod init

  2. Podfile を開き、プラットフォームのバージョンを 15.0 に設定して、ターゲットに AppNexusSDK を追加します。

    platform :ios, '15.0'
project 'FunBanner'

target 'FunBanner' do
  pod 'AppNexusSDK'
end

  3. Podファイルを保存し、依存関係をインストールします。

    pod install

  4. 開いている Xcode プロジェクトを閉じて、生成された .xcworkspace ファイルを開きます。

  • 最終更新: