本文档为静态技术说明,提供分平台接入示例、广告位集成、数据上报字段与常见错误码。接入前需完成商务审核获取 SDK 密钥。
驴通聚合云媒为开发者提供统一的广告聚合 SDK,覆盖主流广告样式与多开发平台。接入流程如下:
选择您的开发平台,查看对应的初始化示例代码(示例基于 LCCSDK 命名,实际以官方 SDK 为准)。
// 在 Application 或主 Activity 中初始化
LCCSDK.init(this, new LCCConfig.Builder()
.setAppKey("YOUR_APP_KEY")
.setDebug(true)
.build());
// AppDelegate 中初始化
[LCCSDK startWithAppKey:@"YOUR_APP_KEY" debug:YES];
NSLog(@"LCCSDK version: %@", [LCCSDK sdkVersion]);
// 在游戏启动场景调用
LCCSDK.Init("YOUR_APP_KEY", debug: true);
LCCSDK.SetLogLevel(LCCLogLevel.Info);
// 在 main.js 入口初始化
lcc.sdk.init({
appKey: "YOUR_APP_KEY",
debug: true
});
// 在应用入口初始化
LCCSDK.init("YOUR_APP_KEY", true);
trace("LCCSDK ready");
以下为四种主流广告样式的调用示例,集成时请替换为您的广告位 ID。
LCCSDK.loadRewardVideo("ad_slot_reward");
LCCSDK.showRewardVideo(new LCCRewardListener() {
onReward() { /* 发放奖励 */ }
onError(code, msg) { /* 处理错误 */ }
});
LCCSDK.loadInterstitial("ad_slot_inter");
LCCSDK.showInterstitial();
LCCNativeAd ad = LCCSDK.loadNative("ad_slot_native");
ad.bindView(nativeContainer); // 绑定自定义布局容器
LCCSDK.showBanner("ad_slot_banner", LCCBannerPos.BOTTOM);
SDK 会自动上报广告生命周期事件,您也可主动上报自定义事件用于分析。
| 字段 | 类型 | 说明 |
|---|---|---|
| event | string | 事件名:imp / click / reward / error |
| slot_id | string | 广告位 ID |
| platform | string | 平台标识:android / ios / unity |
| ecpm | number | 本次展示预估 eCPM(分) |
| ts | number | 事件发生时间戳(毫秒) |
| 错误码 | 含义 | 处理建议 |
|---|---|---|
| 1001 | App Key 无效 | 检查密钥是否正确、是否已审核通过 |
| 1002 | 广告位不存在 | 确认广告位 ID 与后台配置一致 |
| 2001 | 无填充 | 当前时段无可用广告,建议重试或调整水线 |
| 3001 | 网络异常 | 检查设备网络后重试 |
填写信息,专属运营将在 1-2 个工作日内对接评估