主题
建单能力(campaign / offer)
本节说明 adv_user 与 sub_adv_account 在建单(campaign / offer)上的能力差异,以及建单时如何选择账号。
能力对比
| 能力 | adv_user | sub_adv_account |
|---|---|---|
| 创建 sub_adv_account | 支持 | 不支持 |
| 查询 sub_adv_account 凭证 | 支持 | 不支持 |
| 创建 campaign | 支持 | 支持 |
| 创建 offer(上传素材 / tracking) | 支持 | 支持 |
要点:
- 子账号的创建与凭证查询是 adv_user 专属能力,sub_adv_account 不能再创建下一级子账号。
- 创建 campaign 与创建 offer 的能力,adv_user 与 sub_adv_account 完全一致,区别仅在于使用哪一套凭证签名。
建单账号的选择
建单(campaign / offer)时可选择以下任一身份:
- 以 adv_user 建单:直接使用 adv_user 的
access_key/api_key签名。 - 以 sub_adv_account 建单:提供
sub_adv_user_name,由 adv_user 凭证查询其access_key/api_key(见账号模型与鉴权),再用该子账号凭证签名调用。
无论选择哪种身份,后续 campaign / offer / 素材上传 / tracking 都使用同一套所选凭证完成。
创建 campaign
鉴权主体:所选账号(adv_user 或 sub_adv_account)
- 请求地址:
https://{BASE_URL}/api/open/v3/campaign - 请求方法:
POST - 关键入参:
campaign_name、promotion_type、platform、package_name、preview_url、category等 - 关键返回:
data.campaign_id
请求示例:
json
POST /api/open/v3/campaign
{
"campaign_name": "mock_campaign",
"promotion_type": "APP",
"platform": "ANDROID",
"package_name": "com.scu.papasrestaurant",
"preview_url": "https://play.google.com/store/apps/details?id=com.scu.papasrestaurant",
"category": "GAME"
}创建 offer
鉴权主体:所选账号(adv_user 或 sub_adv_account)
- 请求地址:
https://{BASE_URL}/api/open/v3/offer - 请求方法:
POST - 前置:需先有
campaign_id;offer 携带素材(creative_sets),素材需先上传。 - 关键返回:
data.offer_id
创建 offer 是一个三步链路(上传素材 → 创建 offer → 设置 tracking),完整步骤见创建 offer 链路。