Skip to main content

iOS - インテグレーションガイド

Vpon SDK 基本編


  1. まず下記URLから登録済みネットワークプラットフォームを確認してください:
    台湾: http://console.vpon.com/

  2. 台湾のプラットフォームを利用する場合、以下をご利用ください。 vpadnAd.platform = @"TW";

  3. iOS8にアップデート後、ログに didImpression が確認できない場合、原因としてデフォルト設定でウィンドウの幅 x 高さが存在しない可能性が考えられます。setFrame関数をマニュアルで呼び出して調整する必要があります。didImpression が正しく実装されているかご確認ください。

概要


  • Vponバナー広告は、小さなエリアを利用し、ユーザーにクリックさせることで、ウェブサイトもしくはアプリのダウンロードページなどの情報豊富なフルスクリーンページへ遷移させます。ここではあなたのアプリへバナー広告を配信する方法をご案内します。 iOS アプリでバナー広告を表示させるためには、XcodeプロジェクトにSDKを導入し、ユーザインターフ ェースに VpadnBanner を追加するだけです。
  • If you would like to show Vpon’s ad by integrating Mediation Platform such as AdMob, DFP, MoPub, and so on, please click here to see the Sample Codes. Remember to integrate Adapter or Custom Events into your projects.

を組み合わせて使用する必要があります。

SDK の導入


Vpon provides two ways to integrate our SDK :

Streamlined, using CocoaPods

  • Please follow the CocoaPods’ install guidance if it is still uninstalled. Publisher can use CocoaPods, which is a dependency manager for Objective-C Cocoa projects, to integrate Vpon SDK simply and automatically.
  • Remind that Integrated SDK by CocoaPods only support devices in iOS version higher than 7.0.

1.Create the Podfile

Run pod init from the terminal, in the same directory as the project file (.xcodeproj). Open the Podfile which just be generated and uncomment the description about the platform version and revise it to the corresponding one.

In the Podfile, publishers also have to add the description in the target about what Vpon SDK version they want to integrate. The description depends on whether the publishers assign the version of SDK :

  • Unassigned , system will download the latest version automatically (Recommend) : input pod 'VpadnSDK'
  • Assigned (Take SDK 5.6.1 for example) : input pod 'VpadnSDK', '~>5.6.1'

2.Run pod install

Please close the project (.xcodeproj) and run pod install from the terminal in the same directory after revising the Podfile. Once the installation finishes, a new project (.xcworkspace) file will be generated. This project file should include a Pods project with new dependencies for VpadnSDK.

In the terminal, run pod repo update in the directory where the Podfile is located if you want to update to the latest Vpon SDK.


Manual, using the SDK download

Vpon provides two SDKs serving the same functions for our publishers. You should choose either of these 2 to integrate manually.

There is slight difference between these two SDKs, which we will explain in introduction of Framework SDK.

Framework SDK


Framework SDK is a dynamic library, our latest SDK within any necessary references, headers and lib, needs fewer steps, and is lighter than Fundamental SDK.

However, this convenient way is only for apps designed for iOS version higher than 7.0. If you are targeting at users with devices OS version lower than 7.0, you should definitely choose the fundamental SDK instead.

First, right-click your project and choose Add Files to your_project

Second, add VpadnSDKAdKit.framework into your project.

Remember to check whether the framework in Linked Frameworks and Libraries under General has been added.

Third, find Other Linker Flags under Build Settings and input -ObjC

Finally, import the framework:

@import VpadnSDKAdKit

Note:
Remind again that Framework SDK only support devices in iOS version higher than 7.0 and do not use this framework if you are targeting at users with devices OS version lower than 7.0.

Fundamental SDK

解凍した SDK には、Objective-C ヘッダー、実行期間のライブラリー、READMEテキストが含まれています。アプリにVpon広告を導入するためには、次の3つのステップを完了させてください。

  1. プロジェクトに libAdOn.a , VpadnBanner.h および VpadnInterstitial.h を追加します。
  2. 必要なフレームワークを追加します。
  3. Build Settings 内の Other Linker Flagsに -all_load -ObjC を追加し、また Summary の下で AdSupport を Optional に設定します。

Note: All three these steps are necessary!

SDK lib の追加

解凍した SDK には、lib ファイル 1 つ・ヘッダーファイル 2つが含まれています。

  1. Xcode 内のプロジェクト内で右クリックし、 [Add Files to “Vpadn_BannerInter_x5”…]を選択し”Vpadn_BannerInter_x5” 内でファイルを新規作成します。 IOS-add-file_vpadn.png

  2. 次に、 SDK 内で libAdOn.a , VpadnBanner.h および VpadnInterstitial.h を選択します。

Framework の追加

The SDK library references the a few iOS development frameworks.

1.Add all the following frameworks.
AdSupport,
AssetsLibrary,
AudioToolbox,
AVFoundation,
CoreFoundation,
CoreGraphics,
CoreLocation,
CoreMedia,
CoreMotion,
CoreTelephony,
EventKit,
Foundation,
MediaPlayer,
MessageUI,
MobileCoreServices,
QuartzCore,
Security,
StoreKit,
SystemConfiguration,
UIKit

これらのフレームワークを追加する場合、 プロジェクト[Vpadn_BannerInter_x5]をダブルクリックし、[Build Phases] タブ下の [Link Binary With Libraries]プルダウンメニューを開いてから、画面に表示される + ボタンで iOS SDK内のアーキテクチャを追加します。 IOS-add-frameworks_vpadn

サンプルコードのダウンロード


SDK 4 lib ファイルは、Sample codeフォルダ内にあります。 Go to download page

App Transport Security


Apple recently revised App Transport Security (ATS), to iOS10. Please refer to this link for some modification.

ヒント


より詳細な情報は、バナー広告ンタースティシャル広告メディエーションをご確認 ください。