广告

广告接入流程

Step 1：开通【游戏开发者】资质

若已有，则忽略此步骤，
若没有，联系平台商务BD或运营。你将获得游戏商户后台：https://gameplatform.upliveapp.com的账号

Step 2：创建游戏，创建成功后通知平台，平台为游戏开通api访问权限

若之前已处理，则忽略此步骤

Step 3：使用平台提供JSSDK在游戏中接入广告

广告JSSDK接入说明

Step1: 引入JSSDK文件

<script type="text/javascript" src="https://h.cdn.pengpengla.com/up/opengamejs/1.3.1/assets/seed.js"></script>

Step2: 初始化SDK

在使用openSdk提供的相关api之前需要要先调用openSdk.init方法进行初始化

Object object

参数名称 是否必须 默认值 描述
env 否 pro 当前运行环境。stage表示测试环境，pro表示生成环境
client_id 是 第三方应用的唯一标识
game_id 是 第三方应用中产品的唯一表示
mode 是 代表当前游戏模式，两个可选值，分别为diamond/gold/ad 
openSdk.init({
    env: 'stage',  
    client_id: 'CLIENT_ID',
    game_id: 'GAME_ID',
    mode: 'ad' // 广告接入使用广告模式
});

Step3: 调用广告SDK API

0、接入广告JSSDK前提准备

1) 进行Oauth授权

  • 后端接入流程，参考：api
  • 前端调用API：参考：oauth

2) 进入页面之后上报数据，用于统计PV、UV

  • 调用前端API，参考：ping

1、接入banner广告类型

接入广告系统的banner广告形式的游戏，需要在商户后台配置LandingPage多语言素材

  • 游戏名称
  • 游戏描述
  • 游戏截图：大小采用：202px * 358px

在游戏入口文件中调用openSdk.ads.showLandingVideo方法。用户点击“开始游戏”按钮会触发start方法

Object object

参数名称 是否必须 描述
start 是 点击“开始游戏”按钮触发的回调 
openSdk.ads.showLandingVideo({
    start: function() {
        alert('进入游戏');
    }
});

2、接入激励广告类型

视频广告 - 奖励视频。广告允许开发者鼓励用户完成视频，以便SDK触发奖励条件。当用户完成激励视频的浏览任务时，SDK将触发“成功”方法告诉 开发商发送相应的奖励

参数

Object object

参数名称 是否必须 描述
open_id 是 平台用户在游戏中的open_id
success 是 当用户完成激励视频的浏览任务时，SDK将触发“success”方法告诉开发者发送相应的激励
close 是 广告关闭时的回调。当用户未观看完视频就关闭时，回传的值为false，当用户看完视频并在介绍页中点击关闭按钮时，回传的值为true
error 是 广告获取失败回调。没有可展示的广告内容或其他异常导致无法展示

【注意】激励广告类型调用前提：游戏接入开放平台oAuth，接入流程详细见：文档 -> 授权

例如 

openSdk.ads.showRewardVideo({
    open_id: 'OPEN_ID', 
    success: function() {
        alert('激励广告观看成功，游戏服务器端可以给予用户对应的虚拟奖励')
    },
    close: function(status){
        if (status) {
            alert('激励广告观看成功之后关闭');
        } else {
            alert('激励广告未观看完就关闭');
        }
    },
    error: function() {
        alert('激励广告加载失败');
    }
});