开发人员指南概述

亚马逊广告 API 概览

在报告中包含预算规则值

要使用 API 创建报告，您需要为报告指定字段。基于规则的预算指标仅可用于 campaigns（广告活动）报告类型。要向报告添加基于规则的预算指标，请在报告请求中指定以下指标：

指标 描述
campaignRuleBasedBudget 基于规则的预算的值。
applicableBudgetRuleId 有效规则的标识符。
applicableBudgetRuleName 有效规则的名称。

根据广告类型，您可以使用以下接口请求报告：

广告类型 报告请求接口
商品推广 POST /reporting/reports
品牌推广 POST /v2/hsa/campaigns/report
展示型推广 POST /sd/{recordType}/report

报告请求示例： 品牌推广

要创建一个报告并在其中包含所有可用的基于规则的预算指标，请执行以下操作：

使用 POST /v2/hsa/campaigns/report 操作，传递以下请求体：

{
    "reportDate":"20200930",
    "metrics":"campaignBudget,campaignRuleBasedBudget,applicableBudgetRuleId,applicableBudgetRuleName"`
}

响应将类似于：

[
    {
        //For this campaign, there is no active budget rule or rule based budget is not enforced
        "campaignBudget": 100,
        "campaignId": 144375700196005800
    },
    {
        "campaignBudget": 100,
        "applicableBudgetRuleId": "d9c1d0c5-d686-4d0f-9161-10a0c1a288ff",
        "campaignId": 123456789012345,
        "applicableBudgetRuleName": "SAMPLE_BUDGET_RULE",
        "campaignRuleBasedBudget": 112
    }
]
Amazon Advertising logo