通过实时竞价能力，重塑广告收益曲线

19世纪末至20世纪初，传统广告营销模式盛行，通过"包时段、包位置"的采买合约模式，广告主提前数周锁定资源，平台按刊例价结算。然而这种模式存在资源配置不合理、广告主决策滞后和广告投放信息不透明等痛点，为了让平台资源零浪费，广告主出价零盲目，且用户体验零干扰，HarmonyOS SDK广告服务（Ads Kit）提供了实时竞价的能力，帮助广告主在应用平台上实现广告投放利益最大化。

什么是实时竞价

实时竞价是指用户在访问媒体产生曝光机会时，众多家DSP（Demand Side Platform），即需求方平台，根据曝光的上下文以及用户属性实时地评估曝光价值，并给出报价，出价最高的DSP胜出，赢得此次广告曝光机会。

比如，某应用作为广告交易平台的媒体，提供一个广告位，用户访问该媒体页面，即代表一次曝光机会，此时，多家需求方平台可以通过媒体提供的用户属性、使用场景、底价等信息进行报价竞拍，并在100毫秒内完成估价和出价，价高者中标后即可占用该广告位，并向用户展示。

通过实时竞价，无论是平台媒体，还是广告需求方，都可以实现曝光和收益最大化。

如何实现实时竞价

一、添加竞价参数

开发者需要在广告请求参数AdRequestParams中添加实时竞价相关参数。

import { advertising } from '@kit.AdsKit';

const adRequestParams: advertising.AdRequestParams = {
// 'testu7m3hc4gvm'为测试专用的广告位ID，暂无竞价信息，App正式发布时需要改为正式的广告位ID
adId: 'testu7m3hc4gvm',
// 广告类型
adType: 3,
// 交易的最大超时时间
tMax: 100,
// 竞价请求支持的币种，多个用英文逗号分隔
cur: 'CNY',
// 竞价广告位的底价
bidFloor: 6.66,
// 竞价广告位底价使用的币种
bidFloorCur: 'CNY',
// 广告位竞投的APP包名，多个用英文逗号分隔
bpkgName: 'com.huawei.baidu,com.huawei.music'
};

二、处理竞价结果

开发者需要在广告请求成功后的回调AdLoadListener.onAdLoadSuccess或MultiSlotsAdLoadListener.onAdLoadSuccess中，处理广告返回的实时竞价结果Advertisement.biddingInfo。

import { advertising } from '@kit.AdsKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { rcp } from '@kit.RemoteCommunicationKit';

interface BiddingInfo {
// 本条广告的eCPM（每一千次展示可以获得的广告收入）
price: number;

// 本条广告的价格币种
cur: string;

// 媒体回传竞价成功结果的URL
nurl: string;

// 媒体回传竞价失败结果的URL
lurl: string;
}

const adLoaderListener: advertising.AdLoadListener = {
// 广告请求失败回调
onAdLoadFailure: (errorCode: number, errorMsg: string) => {
hilog.error(0x0000, 'testTag', Failed to load ad. Code is ${errorCode}, message is ${errorMsg});
},
// 广告请求成功回调
onAdLoadSuccess: (ads: Array<advertising.Advertisement>) => {
hilog.info(0x0000, 'testTag', 'Succeeded in loading ad');
// 期望的底价
const bidFloor: number = 6;
const biddingSuccessAds: Array<advertising.Advertisement> = [];
for (const ad of ads) {
const biddingInfo: BiddingInfo = ad.biddingInfo as BiddingInfo;
if (!biddingInfo) {
continue;
}
if (biddingInfo.cur === 'CNY' && biddingInfo.price >= bidFloor) {
hilog.info(0x0000, 'testTag', 'Petal Ads wins.');
if (biddingInfo.nurl) {
const url: string = biddingInfo.nurl
// 竞胜时，其他DSP最高出价
.replace('SECOND_PRICE', '3.6')
// 价格币种
.replace('AUCTION_CURRENCY', 'CNY');
sendBiddingResult(url);
}
biddingSuccessAds.push(ad);
} else {
hilog.info(0x0000, 'testTag', 'Petal Ads loses.');
if (biddingInfo.lurl) {
const url: string = biddingInfo.lurl
// 竞败时，其他DSP最高出价
.replace('AUCTION_PRICE', '3.6')
// 竞价结果
.replace('AUCTION_LOSS', '102')
// 价格币种
.replace('AUCTION_CURRENCY', 'CNY')
// 竞败时，竞胜DSP推广的App包名
.replace('AUCTION_APP_PKG', 'com.huawei.music')
// 竞败时，竞胜DSP推广的App名称
.replace('AUCTION_APP_NAME', 'music')
// 竞败时，竞胜DSP的编号
.replace('AUCTION_CP_ID', '100')
sendBiddingResult(url);
}
}
}
// ...此处省略展示广告的逻辑
}
};

async function sendBiddingResult(url: string): Promise {
let session: rcp.Session | undefined = undefined;
try {
session = rcp.createSession();
await session.get(url);
} catch (e) {
hilog.error(0x0000, 'testTag', Failed to send bidding result. Code is ${e.code}, message is ${e.message});
} finally {
session?.close();
}
}

这样，媒体平台就可以实现广告实时竞价的能力了。

当前，实时竞价能力支持的场景有原生广告、激励广告、插屏广告、开屏广告和贴片广告，通过广告实现了从用户唤醒到深度转化的全链路触达。未来，随着隐私计算与AI大模型的深度融合，实时竞价将进一步打破数据孤岛，在保护用户隐私的前提下，让每一次竞价都更具价值，持续引领数字营销向智能化、精细化迈进。

了解更多详情>>

访问广告服务联盟官网

获取实时竞价开发指导文档