IOS版Unity游戏引擎的集成Admob管理库教程

​一:IOS

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

 

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

 

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

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

二:Unity插件API

您可以在Google移动广告插件中使用常用的C#API来请求横幅广告和插页式广告。这段代码只需编写一次即可，然后可以分别部署到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设备上发送广告请求。

三:基本的插页式广告请求

以下是加载插页式广告所需的最少代码。

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();
  }
}

四:自定义广告尺寸

您可以为广告指定一个自定义的尺寸而不使用AdSize常量。

AdSize adSize = new AdSize(250, 250);
BannerView bannerView = new BannerView(adUnitId, adSize, AdPosition.Bottom);

1:测试广告

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

以下说明了如何在构建广告请求时加入测试设备。

AdRequest request = new AdRequest.Builder().AddTestDevice(AdRequest.TestDeviceSimulator) // Simulator.

.AddTestDevice("2077ef9a63d2b398840261c8221a0c9b")  // My test iPod  Touch 5.

.Build();

2:广告请求定位

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

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();

3:广告事件

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.
};

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

五:显示和隐藏横幅广告

默认情况下，横幅广告是可见的。要暂时隐藏横幅广告，请调用：

bannerView.Hide();

 

要重新显示该广告，请调用：

bannerView.Show();

1:清除横幅广告和插页式广告

当完成BannerView或InterstitialAd后，请在放弃对其的引用之前调用Destroy()方法。

bannerView.Destroy();

interstitial.Destroy();

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

2:AdMob 中介支持

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

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

 

Unity是由Unity Technologies开发的一个让玩家轻松创建诸如三维视频游戏、建筑可视化、实时三维动画等类型互动内容的多平台的综合型游戏开发工具，是一个全面整合的专业游戏引擎。正是以为Unity可以把游戏发布去Android、IOS、WindowsPhone8等等，所以可以利用Unity集成KeyMob IOS平台。该平台将整合国内外主流移动广告平台，并对广告功能进行统一管理、动态配置，广告主和开发者都可以通过简单的操作轻松实现对多家广告平台的搭配使用。