ksContentAds

应用配置与简介 广告 内容

概述

快手广告联盟简介

快手联盟是移动开发者短视频商业生态联盟,秉持着“视频即服务”的理念,致力于提供创新的短视频/直播商业解决方案,实现用户时长增加、黏性增强,助力用户增长与变现LTV的提升。快手联盟包含广告联盟、内容联盟、电商联盟三种业务形态。

ksContentAds 模块概述

本模块封装了快手广告联盟的原生 SDK,集成了开屏、插屏、全屏视频、激励视频等等;可用于实现app流量变现。

模块使用攻略

使用之前须从快手广告联盟平台申请开发者账号并创建应用,获取 appid。

快手广告联盟申请地址快手广告联盟

模块依赖

-注意:

1.详细咨询QQ:770104707

使用此模块之前建议先配置 config.xml 文件,配置完毕,需通过云端编译生效,配置方法如下:

  • 名称:ksContentAds
  • 参数:android_appId、ios_appId
  • 配置示例:
    <feature name="ksContentAds">
    <param name="android_appId" value="90009" />
    <param name="ios_appId" value="90010" />
    </feature>
  • 字段描述:

    android_appId:安卓平台应用appid。

    ios_appId:苹果平台应用appid。

android 配置:

    <!-- //部分第三方sdk 不支持 armeabi  -->
    <preference name="android_abi" value="arm64-v8a"/> 

ios 配置:

    <!-- res/Info.plst -->
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>

        <!-- http 访问 -->
        <key>NSAppTransportSecurity</key>
        <dict>
            <key>NSAllowsArbitraryLoads</key>
            <true/>
        </dict>

        <!-- IDFA -->
        <key>NSUserTrackingUsageDescription</key>
        <string>该标识符将用于向您投放个性化广告</string>

        <!-- 网关 -->
        <key>SKAdNetworkItems</key>
        <array>
            <dict>
                <key>SKAdNetworkIdentifier</key>
                <string>r3y5dwb26t.skadnetwork</string>
            </dict>
        </array>

    </dict>
    </plist>

模块接口

initSdk

sdk 初始化

initSdk({params},callback(ret, err))

params

appName:

  • 类型:字符串
  • 描述:(可选项)app 名称。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true, //初始化状态
    code: 0, //状态码
    type: 'onLoad', //事件类型 onInit
    msg: "onInitSdk",//描述
    result:{ //其他结果数据
        version:"3.3.9" //sdk 版本号
    }
}

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.initSdk({
    appName:api.appName, //选填
},function(ret, err) {
    if (ret.status) {
        alert("sdk 初始化成功");
    } else {
        alert('sdk 初始化失败');
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showSplashAD

开屏

showSplashAD({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

logo:

  • 类型:字符串
  • 描述:(可选项)开屏广告底部logo (widget://image/logo-bottom.png)[必须是widget://地址]
  • 默认值:空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true, //初始化状态
    code: 0, //状态码
    type: 'onLoad', //事件类型 onLoad onShow onClicked onSkipped onClosed
    msg: "描述",//描述
    result:{ //其他结果数据
        
    }
}

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showSplashAD({
    posId:"4000000042",
    // posId:"4000000041",ios
    logo:"widget://image/logo-bottom.png"
}, function(ret, err) {
    if (ret.status) {
        if(ret.type == "onShow"){ //展示

        }

        if(ret.type == "onClosed"){ //关闭

        }
    } else {
        alert(err.code);
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showInterstitialAD

插屏

showInterstitialAD({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true, //初始化状态
    code: 0, //状态码
    type: 'onLoad', //事件类型 onLoad onShow onClicked onSkipped onClosed 
    msg: "描述",//描述
    result:{ //其他结果数据
        
    }
}

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showInterstitialAD({
    posId:"4000000276",
    // posId:"4000000277",ios
}, function(ret, err) {
    if (ret.status) {
        if(ret.type == "onShow"){ //展示

        }

        if(ret.type == "onClosed"){ //关闭

        }
    } else {
        alert(err.code);
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showFullScreenVideoAD

全屏视频

showFullScreenVideoAD({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true, //初始化状态
    code: 0, //状态码
    type: 'onLoad', //事件类型 onLoad onShow onClicked onSkipped onCompleted onClosed
    msg: "描述",//描述
    result:{ //其他结果数据
        
    }
}

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showFullScreenVideoAD({
    posId:"90009002",
    // posId:"90010002",ios
}, function(ret, err) {
    if (ret.status) {
        if(ret.type == "onShow"){ //展示

        }

        if(ret.type == "onClosed"){ //关闭

        }
    } else {
        alert(err.code);
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showRewardVideoAD

激励视频

showRewardVideoAD({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true, //初始化状态
    code: 0, //状态码
    type: 'onLoad', //事件类型 onLoad onShow onClicked onCompleted onReward onClosed
    msg: "描述",//描述
    result:{ //其他结果数据
        
    }
}

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showRewardVideoAD({
    posId:"90009001",
    // posId:"90010001",ios
    userId:"1",
    extraData:'{"channel":"app"}',
}, function(ret, err) {
    if (ret.status) {
        if(ret.type == "onShow"){ //展示

        }

        if(ret.type == "onClosed"){ //关闭

        }
    } else {
        alert(err.code);
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showNativeExpressAD

信息流

showNativeExpressAD({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

frameName

  • 类型:字符串
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)

fixed

  • 类型:布尔
  • 描述:(可选项)模块是否不随所属 window 或 frame 浮动 默认值:false

scroll

  • 类型:布尔
  • 描述:(可选项)模块是否不随所属 window 或 frame 滚动 默认值:true

rect

  • 类型:对象
  • 描述:(可选项)位置偏移量参数 { x:0, y:0, w:0, h:0, }

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true, //初始化状态
    code: 0, //状态码
    type: 'onLoad', //事件类型 onLoad onShow onClicked onClosed
    msg: "描述",//描述
    result:{ //其他结果数据
        
    }
}

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showNativeExpressAD({
    posId : "4000000074",
    //posId : 4000000011 ,ios
    frameName:api.frameName,
    fixed:false,
    scroll:true,
    rect:{
        x:0,
        y:0,
        w:0,
        h:0,
    }
}, function(ret, err){
    console.log(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

closeNativeExpressAD

关闭信息流

closeNativeExpressAD({params}, callback(ret, err))

params

callback(ret, err)

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.closeNativeExpressAD({
}, function(ret, err){

});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showDrawExpressAD

Draw流

showDrawExpressAD({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

frameName

  • 类型:字符串
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)

fixed

  • 类型:布尔
  • 描述:(可选项)模块是否不随所属 window 或 frame 浮动 默认值:false

scroll

  • 类型:布尔
  • 描述:(可选项)模块是否不随所属 window 或 frame 滚动 默认值:true

rect

  • 类型:对象
  • 描述:(可选项)位置偏移量参数 { x:0, y:0, w:0, h:0, }

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true, //初始化状态
    code: 0, //状态码
    type: 'onLoad', //事件类型 onLoad onShow onClicked onCompleted onClosed
    msg: "描述",//描述
    result:{ //其他结果数据
        
    }
}

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showDrawExpressAD({
    posId : "4000000020",
    //posId : 40000000028 ,ios
    frameName:api.frameName,
    fixed:false,
    scroll:true,
    rect:{
        x:0,
        y:0,
        w:0,
        h:0,
    }
}, function(ret, err){
    console.log(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

closeDrawExpressAD

关闭Draw流

closeDrawExpressAD({params}, callback(ret, err))

params

callback(ret, err)

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.closeDrawExpressAD({
}, function(ret, err){

});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

快手联盟-内容

showContentPage

视频样式

showContentPage({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

callback(ret, err)

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showContentPage({
    posId:"90009005",
}, function(ret, err) {
    
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showFeedPage

Feed流样式

showFeedPage({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

callback(ret, err)

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showFeedPage({
    posId:"4000000062",
}, function(ret, err) {
    
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showHorizontalFeedPage

横版样式-横版视频样式

showHorizontalFeedPage({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

callback(ret, err)

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showHorizontalFeedPage({
    posId:"4000000082",
}, function(ret, err) {
    
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showHorizontalNewsFeedPage

横版样式-横版图⽂样式

showHorizontalNewsFeedPage({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

callback(ret, err)

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showHorizontalNewsFeedPage({
    posId:"4000000302",
}, function(ret, err) {
    
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showTubePage

短剧

showTubePage({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

callback(ret, err)

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showTubePage({
    posId:"4000000302",
}, function(ret, err) {
    
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showTubePage

短剧

showTubePage({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

callback(ret, err)

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showTubePage({
    posId:"4000000302",
}, function(ret, err) {
    
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showEntryElement

⼊⼝组件

showEntryElement({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

frameName

  • 类型:字符串
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)

fixed

  • 类型:布尔
  • 描述:(可选项)模块是否不随所属 window 或 frame 浮动 默认值:false

scroll

  • 类型:布尔
  • 描述:(可选项)模块是否不随所属 window 或 frame 滚动 默认值:true

rect

  • 类型:对象
  • 描述:(可选项)位置偏移量参数 { x:0, y:0, w:0, h:0, }

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true, //初始化状态
    code: 0, //状态码
    type: 'onLoad', //事件类型
    msg: "描述",//描述
    result:{ //其他结果数据
        
    }
}

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showEntryElement({
    posId : "4000000020",
    frameName:api.frameName,
    fixed:false,
    scroll:false,
    rect:{
        x:0,
        y:0,
        w:0,
        h:0,
    }
}, function(ret, err){
    console.log(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

closeEntryElement

关闭⼊⼝组件

closeEntryElement({params}, callback(ret, err))

params

callback(ret, err)

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.closeEntryElement({
}, function(ret, err){

});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showHotSpot

打开热榜

showHotSpot({params}, callback(ret, err))

params

posId:

  • 类型:字符串
  • 描述:(必填)广告位ID。

frameName

  • 类型:字符串
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)

fixed

  • 类型:布尔
  • 描述:(可选项)模块是否不随所属 window 或 frame 浮动 默认值:false

scroll

  • 类型:布尔
  • 描述:(可选项)模块是否不随所属 window 或 frame 滚动 默认值:true

rect

  • 类型:对象
  • 描述:(可选项)位置偏移量参数 { x:0, y:0, w:0, h:0, }

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true, //初始化状态
    code: 0, //状态码
    type: 'onLoad', //事件类型
    msg: "描述",//描述
    result:{ //其他结果数据
        
    }
}

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.showHotSpot({
    posId : "90009005",
    frameName:api.frameName,
    fixed:false,
    scroll:false,
    rect:{
        x:0,
        y:0,
        w:0,
        h:0,
    }
}, function(ret, err){
    console.log(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

closeHotSpot

关闭热榜

closeHotSpot({params}, callback(ret, err))

params

callback(ret, err)

示例代码

var ksContentAds = api.require('ksContentAds');
ksContentAds.closeHotSpot({
}, function(ret, err){

});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/07/31