开发人员指南概述

亚马逊广告 API 概览

Developer guides

API reference

查看含预算规则的广告活动的每日预算变化

您可以使用每种支持的广告类型的广告活动列表资源来查看含预算规则的广告活动的预算。品牌推广、展示型推广和商品推广版本 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": []
            }
}