Vungle - iOS SDK 入门指南 v. 1.0 - v. 4.1

按照这个简单的指南,将我们的 SDK 集成到您的应用程序,以便您可以开始获利!这里引用的源代码可以在我们的公共 GitHub 存储库中获得。

目录

开始之前...…
1.将 Vungle 框架添加到您的 Xcode 项目
2.删除 iOS 状态栏
3. 应用程序传输安全 (ATS)
4.添加代码
高级设置

开始之前……

  • Vungle iOS SDK 仅支持 iOS 7+,并支持 32 位和 64 位应用程序
  • 集成需要 Vungle 账号,所以如果您目前还没有该账号的话,请创建 Vungle 帐户
  • 我们最新发布的 iOS SDK 版本(自 4.0.8 版本以来)支持最新的 Xcode 8.0。请确保您使用 Xcode 8.0 或更高版本,以确保顺利集成。
  • 如果您尚未执行此操作,请前往我们的dashboard将您的应用程序添加到帐户中。这样您就能获得应用程序 ID,您要使用 SDK 将该应用程序 ID 添加至您的应用程序中。例如在图像中,它用红色圆圈标记并可以在您的应用程序页面上找到。针对新的应用程序,它可以与报告 API ID 相匹配。对于使用“搜索”创建的应用程序,应用程序 ID 和报告 API ID 可能有所不同,这一点没错。(为了协调这一点,报告 API “密匙”可在用户帐户详情页上找到。)
 

现在我们开始吧。  

Vungle iOS SDK 未包含在我们链接的示例代码中。从 Vungle dashboard 下载 ,解压缩归档文件并按照以下步骤操作。

1.将 Vungle 框架添加到您的 Xcode 项目

有两种方法可以将 Vungle 添加到 Xcode 项目中:使用 Cocoapods 或手动集成。

Cocoapods

如果您熟悉 Cocoapods,您可以通过添加

pod "VungleSDK-iOS"

到您的 Podfile 将 Vungle 快速添加到您的项目中。 之后 pod install快速运行应可以为您的项目更新到最新版本的 iOS SDK! 此时,您可以跳到我们指南中的步骤 2。

手动集成

1a. 将 VungleSDK.embeddedFramework 添加到您的项目

找到解压后的文件,然后拖动 &将 VungleSDK.embeddedFramework 目录放到 Frameworks 下的 Xcode 中。

注意事项:VungleSDK.embeddedframework 文件夹应添加为一个组(黄色文件夹),而不是作为参考(蓝色文件夹)。

1b. 添加其他必需的框架

Vungle SDK 需要一些其他本地框架来链接到您的项目,因此请点击您的项目,并前往:

General > Linked Frameworks and Libraries

许多这些框架已经包括在内,因为它们是大多数 Xcode 项目的默认框架,但请务必添加以下任何尚未包含在内的框架:

  • AdSupport.framework
  • AudioToolbox.framework
  • AVFoundation.framework
  • CFNetwork.framework
  • CoreGraphics.framework
  • CoreMedia.framework
  • Foundation.framework
  • libz.dylib 或 libz.tbd
  • libsqlite3.dylib 或 libsqlite3.tbd
  • MediaPlayer.framework
  • QuartzCore.framework
  • StoreKit.framework
  • SystemConfiguration.framework
  • UIKit.framework
  • WebKit.framework

同时应该检查 VungleSDK 框架是否出现在链接框架和库下面。如果先前的拖动 & 拖放步骤没有自动链接,我们可以通过点击 '+' 然后'添加其他'手动添加它。

1c. 添加 -ObjC 链接器标志

这可以通过导航到构建设置并将 -ObjC 添加到其他链接器标志(位于链接部分)

 

2.删除 iOS 状态栏

这不是必需的步骤,但建议采取该步骤,因为牵制状态栏可以确保 Vungle 的广告互动和演示可以顺利进行。要删除状态栏,请打开 Info.pList 并添加密匙 “查看基于控制器的状态栏外观” 并将其设置为“No”

3.应用程序传输安全 (ATS)

从 iOS 9(使用 Xcode 7 构建)开始,应用程序传输安全性需要通过 HTTPS 保护的应用程序所做的所有网络流量。您可以在我们的 Vungle iOS 10 过渡指南中阅读更多有关它的信息。Vungle iOS SDK 已完全准备好进行 ATS 更改,并且所有来自 Vungle SDK 的流量将在 2017 年 1 月 1 日之前使用 HTTPS。在此之前,我们建议您将 NSAllowsArbitraryLoads 值设置为 YES

4. 添加代码!

4a. 初始化 SDK

务必尽快初始化 SDK,以确保广告已为用户及时预先缓存。 对于我们的示例项目(以及我们对所有 iOS 项目的建议),我们会将初始化调用添加到主 AppDelegate 上的 didFinishLaunchingWithOptions 方法。

注意:如果您尝试导入 VungleSDK.h 并且找不到它,请删除该引用并再次添加它,并选择“根据需要复制项目”选项。

  • AppDelegate.h:
#import <VungleSDK/VungleSDK.h>
  • AppDelegate.m : didFinishLaunchingWithOptions:
NSString* appID = @"Your AppID Here";
VungleSDK* sdk = [VungleSDK sharedSDK];
//启动 vungle 发布商库
[sdk startWithAppId:appID];

4b. 在您的 ViewControllers 中播放广告

使用之前在 AppDelegate 的 didFinishLaunchingWithOptions 中初始化 SDK,我们只需添加以下代码段到顶部呈现 ViewController 来向用户呈现广告

注意: startWithAppId 方法应只调用一次。调用它的次数超过一次可能导致未定义的行为。

4c. 在最顶层的 ViewController 类中显示广告

  • #import <VungleSDK/VungleSDK.h>
    
    ...
    VungleSDK* sdk = [VungleSDK sharedSDK];
    NSError *error;
    [sdk playAd:self error:&error];
    

    NSError 参数将被更新,以便在广告演示过程中发生问题时可以包含任何错误信息。

注意: playAd 方法的 ViewController 应该是视图层次结构中最顶层的 ViewController,否则会导致未定义的行为。

4d. 继续播放音频

请访问我们的高级设置指南订阅播放事件。这些可用于取消暂停音频、恢复游戏等。

注意

  • 测试模式: 当您的应用程序处于测试模式时,您将无法下载任何通告的应用程序。此外,Dashboard 不会报告展示次数。这是因为测试广告仅用于验证您是否已正确集成 SDK。一旦您的应用程序在活动模式下可用,即可使用此功能。

  • 重播按钮:Vungle 已经移除了适用于 SDK 版本高于 4.0.x 中的 iOS 终端卡重播按钮。如果按钮保留在广告单元上,其重放功能将无法再使用。

高级设置

如果您对一些更高级的 Vungle iOS SDK 详情(定制、事件监听器等)感兴趣,请随时访问我们的高级设置指南

还有其它问题?提交请求

评论