查看含预算规则的广告活动的每日预算变化
您可以使用每种支持的广告类型的广告活动列表资源来查看含预算规则的广告活动的预算。品牌推广、展示型推广和商品推广版本 2 的流程相同,但商品推广版本 3 的流程有所不同。
商品推广(版本 3)
在版本 3 中,如果广告活动的预算受到预算规则的影响,则由 POST /sp/campaigns/list 返回的广告活动 budget
对象中将包含 effectiveBudget
字段。
您可以使用 effectiveBudget
作为已应用预算规则的指示器,然后使用 GET /sp/campaigns/{campaignId}/budgetRules 检索该广告活动的完整预算规则历史记录。状态为 ACTIVE
的预算规则正在影响该广告活动。
品牌推广、展示型推广和商品推广(版本 2)
您可以使用与该广告类型关联的广告活动列表资源来查看具有预算规则的广告活动的预算。
广告类型 | 广告活动列表接口 |
---|---|
商品推广(版本 2) | GET v2/sp/campaigns |
品牌推广 | POST /sb/v4/campaigns/list |
展示型推广 | GET /sd/campaigns |
响应中出现 ruleBasedBudget
表示已应用预算规则。然后,您可以使用该广告类型的相关 GET /campaigns/{campaignId}/budgetRules 接口检索该广告活动的完整预算规则历史记录。状态为 ACTIVE
的预算规则正在影响该广告活动。
广告类型 | GET 预算规则接口 |
---|---|
商品推广 | GET /sp/campaigns/{campaignId}/budgetRules |
品牌推广 | GET /sb/campaigns/{campaignId}/budgetRules |
展示型推广 | GET /sd/campaigns/{campaignId}/budgetRules |
警告
自 2023 年 2 月起,
applicableRuleId
可能不完整,因为可能有多个规则同时处于有效状态(请参阅规则评估详细信息),因此您应该使用相关的 GET /campaigns/{campaignId}/budgetRules 接口来查看广告活动的有效规则。
规则评估进度
ruleBasedBudget
对象还包括 isProcessing
字段。如果将此字段设置为 true
,则规则评估正在进行中。评估完成后,规则预算值将更新,isProcessing
将设置为 false
。
示例
此示例适用于应用了预算规则的品牌推广活动。
GET /sb/campaigns/{campaignId}
规则评估正在进行中时,响应可能类似于:
场景 2: 预算规则评估正在进行中
{
"campaignId": 148864597212176,
"name": "Sample Budget Rule Campaign",
"campaignType": "sponsoredProducts",
"targetingType": "manual",
"premiumBidAdjustment": false,
"dailyBudget": 10.0,
"ruleBasedBudget": {
"isProcessing": true
},
"startDate": "20181010",
"state": "enabled",
"bidding": {
"adjustments": []
}
}
规则评估完成后,响应可能类似于:
{
"campaignId": 148864597212176,
"name": "Sample Budget Rule Campaign",
"campaignType": "sponsoredProducts",
"targetingType": "manual",
"premiumBidAdjustment": false,
"dailyBudget": 10.0,
"ruleBasedBudget": {
"value": 12.0,
"applicableRuleId": "5bc531de-f000-44cf-8a86-54189bcdd380",
"applicableRuleName": "SAMPLE_BUDGET_RULE",
"isProcessing": false
},
"startDate": "20181010",
"state": "enabled",
"bidding": {
"adjustments": []
}
}