IOS 和 Android Unity游戏引擎的集成AdMob新版教程

如果您使用Unity 游戏引擎，则可以使用官方支持的插件在 Unity 开发环境中编写脚本，以将横幅广告和插页式广告投放到 Android或 IOS游戏中。

一:要求:
1:Unity 4或更高版本
2:Google移动广告SDK

二:将插件导入到游戏中
1:在Unity 编辑器中打开您的项目。选择“Assets”（资源）→“Import Package”（导入程序包）→“Custom Package”（自定义程序包）并找到您下载的GoogleMobileAdsPlugin.unitypackage文件。

2:确保选择所有文件，然后点击Import（导入）。

三:我已经拥有AndroidManifest.xml文件

如果您的项目已经有Assets/Plugins/Android/AndroidManifest.xml文件，您可以选择不从GoogleMobileAds.unitypackage导入此文件，但您需要先更新该清单文件，以将unityplayer.ForwardNativeEventsToDalvik元数据标记添加到 Unity 主活动中（以下突出显示的内容）：

<activity android:name="com.unity3d.player.UnityPlayerNativeActivity"
android:label="@string/app_name">

<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />

</intent-filter>
<meta-data android:name="unityplayer.UnityActivity" android:value="true" />

<meta-data android:name="unityplayer.ForwardNativeEventsToDalvik"
android:value="true" />

</activity>
在Unity主活动中，将unityplayer.ForwardNativeEventsToDalvik标记设置为true可确保广告是可以点击的。

您还需要按照快速入门指南中的介绍对清单文件做出更改。

四:运行您的项目
根据您的平台完成以下相应步骤，将Android和IOS版本的Google移动广告SDK 导入到项目中。完成这些步骤后，请参阅Unity 插件API部分，详细了解如何使用插件请求横幅广告和插页式广告。

五:Android
1:此插件要求项目中包含Google Play服务库。将整个<android_SDK>/extras/Google/Google_play_services/libproject/Google-play-services_lib/文件夹添加到 Unity 项目的Assets/Plugins/Android文件夹中。

2:转到“File”（文件）→“Build Settings”（构建设置），选择Android平台，然后选择Build and Run（构建并运行）。

您已为Android 导入了该插件！

六:IOS
1:转到“File”（文件）→“Build Settings”（构建设置），依次选择 IOS 平台和Build（构建）。这将会导出 Xcode项目。


2:打开导出的Xcode项目，并按照IOS快速入门指南中的手动导入部分来添加 Google移动广告SDK。

3:在Xcode中，转到“Product”（产品）→“Run”（运行）以运行您的项目。

现在您已为IOS成功导入该插件！

七：Unity 插件 API
您可以在Google移动广告插件中使用常用的C# API来请求横幅广告和插页式广告。这段代码只需编写一次即可，然后可以分别部署到 Android设备和IOS设备中。

1:基本的横幅广告请求
以下是创建和加载横幅广告所需的最少代码。

using GoogleMobileAds.API;
…
private void RequestBanner()
{
#if UNITY_ANDROID
string adUnitId = "INSERT_ANDROID_BANNER_AD_UNIT_ID_HERE";

#elif UNITY_IPHONE
string adUnitId = "INSERT_IOS_BANNER_AD_UNIT_ID_HERE";

#else
string adUnitId = "unexpected_platform";

#endif

// Create a 320x50 banner at the top of the screen.
BannerView bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Top);

// Create an empty ad request.
AdRequest request = new AdRequest.Builder().Build();

// Load the banner with the request.
bannerView.LoadAd(request);

}

AdPosition枚举会指定横幅广告的展示位置。

请注意，不同广告单元的使用方式要取决于具体的平台。具体来说，在使用 AdMob 时，您需要使用IOS广告单元在 IOS设备上发送广告请求，使用Android广告单元在Android设备上发送广告请求。

2:基本的插页式广告请求
以下是加载插页式广告所需的最少代码。
using GoogleMobileAds.API;
…
private void RequestInterstitial()
{
#if UNITY_ANDROID
string adUnitId="INSERT_ANDROID_INTERSTITIAL_AD_UNIT_ID_HERE";

#elif UNITY_IPHONE
string adUnitId="INSERT_IOS_INTERSTITIAL_AD_UNIT_ID_HERE";

#else
string adUnitId="unexpected_platform";

#endif

 // Initialize an InterstitialAd.
InterstitialAd interstitial = new InterstitialAd(adUnitId);
// Create an empty ad request.
AdRequest request = new AdRequest.Builder().Build();

// Load the interstitial with the request.
interstitial.LoadAd(request);

}

与横幅广告不同，插页式广告需要显式展示。请在游戏的适当停止点（例如当前关卡结束时）检查插页式广告是否已准备好进行展示。展示插页式广告的一个好时机是在游戏结束时：
private void GameOver()
{
  if (interstitial.IsLoaded()) {
    interstitial.Show();
  }

}

3:自定义广告尺寸
您可以为广告指定一个自定义的尺寸而不使用AdSize常量。
AdSize adSize = new AdSize(250, 250);
BannerView bannerView = new BannerView(adUnitId, adSize, AdPosition.Bottom);

4:测试广告
我们建议您在开发过程中请求测试广告，以免产生不当的广告展示。要请求测试广告，请在构建广告请求时将加密的设备 ID 添加到AddTestDevice方法。无论是 Android 还是IOS，当您的应用运行并发送有效请求时，此 ID只能在日志中找到。

以下说明了如何在构建广告请求时加入测试设备。
AdRequest request = new AdRequest.Builder()
.AddTestDevice(AdRequest.TestDeviceSimulator)       // Simulator.
.AddTestDevice("2077ef9a63d2b398840261c8221a0c9b") // My test iPod Touch 5.
.Build();

5:广告请求定位
要向广告请求提供额外的定位信息，请在构建请求时设置这些定位参数。此广告请求示例显示了可以使用哪些定位方法。

AdRequest request = new AdRequest.Builder().SetGender(Gender.Male)
.SetBirthday(new DateTime(1985, 1, 1))
.TagForChildDirectedTreatment(true)
.AddExtra("excl_cat", "cars,sports") // Category exclusions for DFP.
.Build();

6:广告事件
BannerView和InterstitialAd都包含您可以注册的相同广告事件。这些事件是EventHandler类型。以下示例说明如何在横幅广告上设置广告事件：
private void RequestBanner(){

BannerView bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Top);

// Called when an ad request has successfully loaded.
bannerView.AdLoaded += HandleAdLoaded;

// Called when an ad request failed to load.
bannerView.AdFailedToLoad += HandleAdFailedToLoad;

// Called when an ad is clicked.
bannerView.AdOpened += HandleAdOpened;

// Called when the user is about to return to the app after an ad click.
bannerView.AdClosing += HandleAdClosing;

// Called when the user returned from the app after an ad click.
bannerView.AdClosed += HandleAdClosed;

// Called when the ad click caused the user to leave the application.
bannerView.AdLeftApplication += HandleAdLeftApplication;

}

public void HandleAdLoaded(object sender, EventArgs args)
{
    print("HandleAdLoaded event received.");
    // Handle the ad loaded event.
}

AdFailedToLoad事件包含特殊的事件参数。该事件会传递一个AdFailedToLoadEventArgs实例，此实例具有一个说明错误内容的Message。

public void HandleAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
print("Interstitial Failed to load: " + args.Message);
  // Handle the ad failed to load event.

};
您只需注册自己感兴趣的事件。

7:显示和隐藏横幅广告
默认情况下，横幅广告是可见的。要暂时隐藏横幅广告，请调用：
bannerView.Hide();
要重新显示该广告，请调用：
bannerView.Show();

8:清除横幅广告和插页式广告
当完成BannerView或InterstitialAd后，请在放弃对其的引用之前调用Destroy()方法。
bannerView.Destroy();

interstitial.Destroy();
这会通知插件应该将此对象作为垃圾进行收集。不调用此方法将导致内存泄漏。

八:AdMob 中介支持
要使用Unity 插件执行中介功能，您必须按照中介快速入门指南 (Android|IOS) 中的介绍，为每个第三方广告网络下载并添加SDK和适配器库。以下是针对不同设备的不同操作：

1:对于Android，将所需的库添加到项目的Assets/Plugins/Android目录中。

2:对于IOS，将所需的库添加到Xcode项目中，该项目是您为IOS构建项目时由 Unity 生成的。

九:DFP 广告管理系统支持
正如Unity Plugin API中所述，Unity插件支持DFP 广告单元、自定义广告尺寸和自定义定位。
该插件当前不支持更高级的 DFP 功能，如多个广告尺寸、应用事件和手动展示次数计数。

Unity是由Unity Technologies开发的一个让玩家轻松创建诸如三维视频游戏、建筑可视化、实时三维动画等类型互动内容的多平台的综合型游戏开发工具，是一个全面整合的专业游戏引擎。正是以为Unity是一个全面整合的专业游戏引擎，可以把游戏发布去Android平台、IOS平台、Windows Phone8平台等等，所以可以利用这点特性把Unity与KeyMob平台结合起来，广告主和开发者都可以通过简单的操作轻松实现对多家广告平台的搭配使用。并能辅助开发者过市场审核，服务态度和技术方面都是做的很不错。KeyMob的优点就是小而功能精细，专做广告服务，对各个广告平台进行精选，集成方便快捷。