接入流程

登录MG广告平台网站注册开发者账户,注册成功后创建应用,添加广告位信息(添加后会生成广告位ID,稍后嵌入广告时用到),然后将生成一个官方渠道的Publisher ID(之后嵌入广告时用到), 然后下载广告SDK压缩文件,里面包括SDK文件以及开发说明文档,您可以根据说明文档在您的应用程序中嵌入广告。嵌入成功后可以将应用更新至微软开发者后台等待审核,审核通过后您就可以开始推广应用获取广告收益了。

注册MG开发者账户

登录MG广告平台网站注册开发者账户。

创建应用

登录开发者后台选择功能菜单“应用管理-->应用列表”,点击右上角“添加”铵钮,创建应用。

注意:

“*”是必填项

“应用名称”需要注意,需要填写应用英文名称,如果是中文产品,可以使用产品首字母缩写。

“应用状态”首次填写 选择“未发布”状态。

创建广告位

登录开发者后台选择功能菜单“广告平台-->广告位列表”, 点击右上角“添加”铵钮,即可创建一个广告位,添加完成后会为每一个广告位生成一个“广告位主键“,该“广告位主键“用于在游戏中接入广告位。

注意:

“*”是必填项

广告位尺寸,可以自定义,广告位从后台广告库中提取同样大小的广告素材。

广告类型中 全屏暂时不提供,只选择后6个类型进行创建。

刷新时间:刷新广告的时间间隔。

开发者需要同时注册七个广告位,分别为开屏,插屏,横幅各两个,每一对分别对应pc和手机,退屏广告位一个,在图中“使用状态”选项来控制该广告位是否显示,开屏尺寸建议1366*768,1920*1080,插屏尺寸建议320*320,640*640,300*250,横幅350*50,480*80,退屏的尺寸选择300*50即可。

接入广告位

下载SDK请点击广告SDK

接入广告位之前需要先初始化SDK

游戏可接入四个广告位,分别为开屏、横幅、插屏、退屏。

开屏、横幅及插屏

在MG后台创建开屏、横幅及插屏广告位之后,在游戏代码的相关位置插入以下代码

try
{
	//这句代码是为了保证加入广告是在主线程上进行,如果是直接调用是不需要加这句话的。
	//但是如果请求服务器返回数据之后再添加广告则需要添加这句代码,因为请求服务器数据是调用另一个线程进行操作的,UI是属于主线程的
	Windows.ApplicationModel.Core.CoreApplication.MainView.Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, async () =>
	{
		MiracleGames.Advertising.UI.AdControl ad = new MiracleGames.Advertising.UI.AdControl("xxxxxxxxxx",”yyyyyyyyyy” true);
		grid.Children.Add(ad);
	});
}
catch(Exception ex)
{
	string value = ex.ToString();
}

开屏

开屏广告位一般在MainPage页面的load方法中实现

退屏

在mainpage.xaml.cs的Loaded方法中初始化退屏广告位

if (MiracleGames.ApplicationManager.SetupCompletedSuccessfully)
{
    try
    {
        var mgAD = new AdControl("1B4FF5F216", "1B4FF5F216", true);
        mgAD.CloseIconVisibility = Visibility.Visible;
        Grid.SetRowSpan(mgAD, 10);
        RootGrid.Children.Add(mgAD);
    }
    catch (Exception)
    { }
}

在app.xaml.cs中注册进入后台事件,在进入后台事件中添加如下代码

bool exit = false;       
private async void App_EnteredBackground(object sender, EnteredBackgroundEventArgs e)
{
    exit = false;
    var deferral = e.GetDeferral();
    await System.Threading.Tasks.Task.Delay(5000);
    exit = true;
    deferral.Complete();
}

在app.xaml.cs的挂起事件中添加如下代码

private void OnSuspending(object sender, SuspendingEventArgs e)
{
    if(!exit)
    {
        MiracleGames.Advertising.AdvertisingManager.ExitAd();
    }
    var deferral = e.SuspendingOperation.GetDeferral();
    deferral.Complete();
}

WMS消息推送

在App.xmal.cs中注册OnActivated事件

protected override void OnActivated(IActivatedEventArgs args)
{
    MiracleGames.Advertising.AdvertisingManager.ToastAd(args);
    base.OnActivated(args);
}