Vungle (SDK v.1.0 - v.4.1) - Corona 入门指南

本指南介绍了如何快速集成我们的 Corona plugin 插件。请访问我们的 Corona 示例应用程序 看看各部分如何相互配合。

目录

  1. 更新构建设置
  2. 初始化 Vungle
  3. 播放广告
  4. 高级设置

开始之前的几个注意事项……

  • 广告不能在 Corona 模拟器中工作。您需要构建到设备来测试我们的广告。
  • Vungle Corona 插件仅支持:
    • iOS 7+ 和支持 32 位和 64 位的应用程序
    • Android 3.0(Honeycomb - API 版本 11)或更高版本

  • 集成需要 Vungle 帐户,所以如果您目前还没有该账号的话,请创建 Vungle 帐户

  • 如果您尚未执行此操作,请前往我们的 dashboard将您的应用程序添加到帐户中。这样您就能获得应用程序 ID,您要使用 SDK 将该应用程序 ID 添加至您的应用程序中。它是您的应用程序页面上红色的部分。
 

现在我们开始吧。 我们需要 4 个步骤才能启动并运行:

1.更新 build.settings

要使用此插件,请将一个条目添加至 build.settings插件表中。添加后,构建服务器将在构建阶段集成该插件。您不需要下载任何东西,Vungle 会自动包含在您的项目中:

设置 = {
        插件 = {
                ["CoronaProvider.ads.vungle"] = {
                        publisherId = "com.vungle"
                },
        },
}

iOS

对于 iOS,请将以下内容添加到您的 plist(位于 build.settings 中):

iphone = { 
plist= {
NSAppTransportSecurity =
{
NSAllowsArbitraryLoads = true },
}
}

Android

对于 Android,使用此插件时会自动添加以下权限/功能:

android = {
        usesPermissions = {
                "android.permission.INTERNET",
         },
},

2.初始化 Vungle

Vungle 广告可通过 Corona 的广告库进行访问。您需要导入广告,然后在项目的核心文件中尽早初始化 Vungle:

main.lua:

-- 使用 Vungle Ads 
local ads = require "ads"

导入任何文件-- 您需要将其更改为您的应用程序 ID
appID = "Test_iOS";

--广告将在 init
ads.init( "vungle", appID );
上开始缓存

3.播放广告!

当您准备播放视频时,只需调用 ads.show。您需要传入广告类型 - “插页式”或“奖励推广式”:

ads.show( "interstitial" );

或者

ads.show( "incentivized" );

这也将返回一个布尔值,具体取决于缓存广告的可用性。

另请注意,ads.hide 无法使用 - 与其他广告提供商不同,Vungle 视频广告在用户关闭时会隐藏。

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

高级设置

这些高级设置也包括在示例应用程序中。

1.播放广告选项

现在您已经投放了广告,您可能需要将这些可选参数传递给 ads.show 来自定义体验:

isAnimated (Bool)

此参数仅适用于 iOS。如果是 (默认),视频广告将以幻灯片效果转换。如果是,它会立即出现。

isAutoRotation (Bool)

如果是 (默认),视频广告将根据设备的方向自动旋转。如果是,它将使用广告的首选方向。这只是 Android。对于 iOS,请看看方向密匙。

orientations (Bool) (api.type.Integer)

具有可能的方向值的位。默认值为 UIInterfaceOrientationMaskAll

isBackButtonEnabled (Bool)

此参数仅适用于 Android。如果是,Android 后退按钮将停止播放视频广告,并显示后贴片广告。如果是(默认),播放期间将禁用后退按钮。请注意,后贴片广告始终启用后退按钮 - 按下后,退出广告并返回到应用程序。

isSoundEnabled (Bool)

如果是(默认),则视频广告播放期间将启用声音,具体取决于设备的声音设置。如果是,视频播放开始时为静音。请注意,用户可以在播放过程中将声音设置为静音或取消静音。

username (String)

此参数仅适用于“奖励推广”广告单元类型。指定时,它表示您希望在服务器到服务器回调中接收的用户标识符,以奖励用户完成的视频广告视图。

例如:

local adShown = ads.show( "interstitial"{ isAnimated=falseisBackButtonEnabled=true } )

 

2.事件监听器

或者,您也可以将事件监听器传递到 ads.init。

ads.init( providerName, appId [, adListener] )

它会通知您这些事件:

adStart

  • name: adsRequest
  • provider: vungle
  • 类型:adStart
  • isError: ,如果广告开始播放;如果广告无法播放,则为
  • 回答:为什么 isError时广告无法播放的原因

adView

  • name: adsRequest
  • provider: vungle
  • 类型:adView
  • isError:假
  • totalAdSeconds:视频的总长度(以秒为单位)
  • secondsWatched:用户的最长视图的长度(以秒为单位)
  • isCompletedView:,如果用户观看 80% 的视频;其他情况为

adEnd

  • name: adsRequest
  • provider: vungle
  • 类型:adEnd
  • isError:假
  • wasCallToActionClicked: 如果用户点击了号召性用语(通常为“下载”),为;其他情况为

cachedadavailable

  • name: adsRequest
  • provider: vungle
  • 类型:cachedAdAvailable
  • isError:假

例如:

局部函数 vungleAdListener(事件 )
如果 ( event.type == "adStart" and event.isError ) ,则
-- 广告尚未完成缓存,不会播放
end
,如果 ( event.type == "adStart" and not event.isError ),则
-- 广告将播放
end
,如果 ( event.type == "cachedAdAvailable" ) ,则
-- 广告已完成缓存,随时可以播放
end
,如果 ( event.type == "adView" ) 则
-- 广告已完成
end
,如果 ( event.type == "adEnd" ) 则
-- 广告体验已关闭 - 这是
-- 恢复您的应用程序的好地方,
end
结束

 

3.附加函数

vungle.isAdAvailable()

Vungle 会下载并缓存下一个视频广告,以获得最佳的用户体验。该函数返回一个布尔值,具体取决于缓存广告的可用性。

vungle.getVersionString()

以字符串形式返回插件和底层 SDK 版本号。

vungle.showCacheFiles()

将 Vungle 缓存中的文件列表写入日志。此功能仅适用于 iOS。

仅限 iOS:应用程序传输安全

iOS 9 引入了 ATS(应用程序传输安全)度量。必须更新部署在 iOS 9 上的应用程序以解决 ATS 测量;参考 针对 iOS 9 准备应用程序以获取说明。

Google Play 服务

如果定位 Android 并使用 Corona SDK 2014.2264 或更高版本,您还需要将 Google Play 服务添加至插件表:

设置 = {
        插件 = {
                ["plugin.google.play.services"] = {
                        publisherId = "com.coronalabs"
                },
        },
}

 

还有其它问题?提交请求

评论