Audience Network Unity SDK操作指南 VR资源

清风 2017-09-08 17:30:18
入门指南

Audience Network Unity SDK 支持在 iOS 和 应用内使用 Unity 为发行商投放广告。Unity 适配工具可用于横幅广告、插屏广告、奖励式视频广告和原生广告。
 
请确保先阅读 Audience Network 入门指南,然后再继续操作。

前提条件
要求使用 Unity 5.0 或以上版本。

确保已安装最新的工具:
Unity
Xcode
Android Studio

在 Unity 应用中添加 Audience Network 广告
第 1 步: 下载 Audience Network Unity SDK
第 2 步: 创建和设置 Audience Network Unity 示例项目
第 3 步: 通过 Unity 项目构建 iOS 应用
第 4 步: 通过 Unity 项目构建 Android 应用

第 1 步: 下载 Audience Network SDK

Audience Network Unity SDK 是 Unity 版 Facebook SDK 的一部分。若要开始,请下载和解压缩 Unity 版 Facebook SDK。

第 2 步: 创建和设置 Audience Network Unity 示例项目

安装 Unity 及下载最新的 Audience Network Unity SDK 后,可打开 Unity 应用创建示例项目。

打开 Unity 应用,将项目命名为 AudienceNetworkUnityTutorial,然后设置项目存储位置。 
 
在 Unity 编辑器中,从菜单中依次选择 Assets(素材)、Import Package(导入包)和 Custom Package…(自定义包...),然后从 AudienceNetworkSDK 文件夹选择 audience-network-unity-sdk.unitypackagee,将插件导入项目中。
 

导入 Audience Network SDK 后,可通过 Project(项目)面板浏览 SDK 内容,如下所示:
 

在 Unity 编辑器项目面板中,应看到在 Assets 文件夹下创建的 AudienceNetwork 文件夹。 打开 Samples(示例)文件夹,您会看到 Unity 场景文件 AdViewScene、InterstitialAdScene、RewardedVideolAdScene 和 NativeAdScene。AdViewTest.cs、InterstitialAdTest.cs、RewardedVideoAdTest.cs 和 NativeAdTest.cs 是 cs 文件,用于调用 Audience Network API 来请求和加载广告内容。

双击打开 AdViewTest.cs 并搜索 YOUR_PLACEMENT_ID。 您会看到以下调用。
AdView adView = new AdView ("YOUR_PLACEMENT_ID", AdSize.BANNER_HEIGHT_50);</code> 将 YOUR_PLACEMENT_ID 替换为您自己的版位编号字符串。如果没有版位编号或不知道如何获取,请参阅入门指南。 针对 InterstitialAdTest.cs、RewardedVideoAdTest.cs 和 NativeAdTest.cs 重复此步骤。

双击 NativeAdScene,然后点击顶部面板的 Play(播放)按钮,默认情况下,可看到 Audience Network 测试广告,如下所示:
 


第 3 步: 通过 Unity 项目构建 iOS 应用

创建与 Audience Network Unity SDK 集成的 Unity 示例项目后,请继续学习如何创建可显示 Facebook Audience Network 广告的 iOS 应用。

请参阅常见问题,了解 Audience Network SDK 支持的最低操作系统版本。
在 Samples 文件夹中双击 AdViewScene,然后选择 File(文件)-> Build Settings(构建设置)。 在 Scenes In Build(待构建场景)窗口中点击 Add Open Scenes(添加开放场景)按钮,然后选择 AudienceNetwork/Samples/AdViewScene。 对 InterstitialAdScene、RewardedVideoAdScene 和 NativeAdScene 重复此步骤,如下所示: 
 

选择 iOS 平台,然后点击 Build And Run(构建并运行)。 创建 iOS 示例项目需要几秒钟。

通过 Unity 构建 Xcode 项目后,打开该项目。 点击项目文件,从 Targets(目标)菜单选择构建目标。 检查是否拥有有效捆绑标识符,如下所示:
 
 
 
Note that XCode will create a bundle identifier for your project. In this example, the bundle identifier is com.yourcompany.AudienceNetworkTutorial. You will use this bundle identifier later when you submit your app for approval as explained in Submit For Review.

Unity 原生插件不提供用于添加要关联到 iOS 项目的依赖库的 API。 您会看到以下构建错误:
 
 
1
Undefined symbols for architecture arm64:
  "_xmlXPathFreeObject", referenced from: lxml::xpath::object::object(_xmlXPathObject*) in FBAudienceNetwork(FNFMediaPresentationDescription.o)

若要修复上述构建错误,您需要在项目的 Build Settings(构建设置)页面中将“-lxml2”添加到“Other Linker Flags”(其他关联工具标记),如下所示:
 

将 StoreKit.framework 添加到 Linked Frameworks and Libraries(关联的框架和库),如下所示:
 


选择设备作为构建目标,构建并运行项目。您可以看到通过 Unity 构建的应用显示 Audience Network 广告,如下所示:
 

第 4 步: 通过 Unity 项目构建 Android 应用

Audience Network SDK 支持的最低 Android 操作系统版本是 Android SDK 的 API 版本 11。
在 Samples 文件夹中双击 AdViewScene,然后选择 File(文件)-> Build Settings(构建设置)。 在 Scenes In Build(待构建场景)窗口中点击 Add Open Scenes(添加开放场景)按钮,然后选择 AudienceNetwork/Samples/AdViewScene。 对 InterstitialAdScene、RewardedVideoAdScene 和 NativeAdScene 重复此步骤,如下所示: 
 

选择 Android 平台,然后选择 Google Android Project(Google Android 项目)和 Development Build(开发构建)选项。 

点击 Player Settings(播放器设置)。在 Other Settings(其他设置)-> Identification(标识)-> Version(版本)中,选择“Android 4.1 'Jelly Bean' (API level 11)”(Android 4.1“Jelly Bean”[API 级别 11])。
 

选择 Gradle(New)(Gradle[新版]),用于构建系统。点击 Build and Run(构建并运行)。创建 Android 示例项目需要几秒钟。

不再支持内部 Unity 版本。应使用 Gradle 完成构建版本。(在 Build Settings[构建设置]中,选择 Build System[构建系统])

打开 Android Studio,选择 Import project(导入项目)。
 

找到 Unity 构建的 Android 项目,构建 Gradle 项目。 
 

使用 Android Studio 创建 gradle 项目后,打开 AndroidManifest.xml 并添加下列元素(如缺失):
<activity android:name="com.facebook.ads.AudienceNetworkActivity" android:configChanges="keyboardHidden|orientation|screenSize" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
选择 Android 设备作为 Deployment Target(部署目标)。您可以看到通过 Unity 构建的应用显示 Audience Network 广告,如下所示: 
 


后续步骤

提交应用供审核。
我们收到您的应用或网站对某条广告的请求时,将对广告进行审核,确保其符合 Audience Network 政策和 Facebook 社区守则。详细了解 Facebook 的审核流程。
99VR视界二维码
热门推荐
Hot Recommended
在线客服