开发人员指南概述

亚马逊广告 API 概览

本文档描述了版本 3 报告的所有可用列。

提示

要了解版本 2 和版本 3 指标之间的对比情况,请参阅亚马逊广告的迁移指南

acosClicks14d

类型: Double

描述: 基于点击广告后 14 天内完成的购买行为所产生的广告投入产出比。

报告类型投放推广的商品搜索词

acosClicks7d

类型: Double

描述: 基于点击广告后 7 天内完成的购买行为所产生的广告投入产出比。

报告类型投放推广的商品搜索词

adGroupId

类型: Integer

描述: 广告组的唯一数字编号。

报告类型广告活动投放推广的商品已购买的商品搜索词

adGroupName

类型: String

描述: 广告主输入的广告组名称。

报告类型广告活动投放推广的商品已购买的商品搜索词

adId

类型: Integer

描述: 广告的唯一数字编号。

报告类型推广的商品

adKeywordStatus

类型: String

描述: 关键词的当前状态。

报告类型投放搜索词

adStatus

类型: String

描述: 广告组的状态。

报告类型广告活动

advertisedAsin

类型: String

描述: 与推广的商品相关联的 ASIN。

报告类型推广的商品已购买的商品

advertisedSku

类型: String

描述: 正在推广的 SKU。不适用于供应商。

报告类型推广的商品已购买的商品

attributedSalesSameSku14d

类型: Double

描述: 在点击广告后的 14 天内发生且购买的 SKU 与推广的 SKU 相同的销售的总价值。

报告类型广告活动投放推广的商品搜索词

attributedSalesSameSku1d

类型: Double

描述: 在点击广告后的 1 天内发生且购买的 SKU 与推广的 SKU 相同的销售的总价值。

报告类型广告活动投放推广的商品搜索词

attributedSalesSameSku30d

类型: Double

描述: 在点击广告后的 30 天内发生且购买的 SKU 与推广的 SKU 相同的销售的总价值。

报告类型广告活动投放推广的商品搜索词

attributedSalesSameSku7d

类型: Double

描述: 在点击广告后的 7 天内发生且购买的 SKU 与推广的 SKU 相同的销售的总价值。

报告类型广告活动投放推广的商品搜索词

attributionType

类型: String

描述: 描述购买由广告产生的促销产品还是品牌光环效应。

报告类型已购买的商品

campaignApplicableBudgetRuleId

类型: String

描述: 与广告活动的有效预算规则相关联的编号。

报告类型广告活动

campaignApplicableBudgetRuleName

类型: String

描述: 与广告活动的有效预算规则相关联的名称。

报告类型广告活动

campaignBiddingStrategy

类型: String

描述: 与广告活动相关联的竞价方案。

报告类型广告活动

campaignBudgetAmount

类型: Decimal

描述: 分配给广告活动的总预算。

报告类型广告活动投放推广的商品搜索词

campaignBudgetCurrencyCode

类型: String

描述: 与广告活动相关联的货币代码。

报告类型广告活动投放推广的商品已购买的商品搜索词

campaignBudgetType

类型: String

描述: 分别为 dailylifetime

报告类型广告活动投放推广的商品搜索词

campaignId

类型: Integer

描述: 与广告活动相关联的编号。

报告类型广告活动投放推广的商品已购买的商品搜索词

campaignName

类型: String

描述: 与广告活动相关联的名称。

报告类型广告活动投放推广的商品已购买的商品搜索词

campaignRuleBasedBudgetAmount

类型: Decimal

描述: 基于规则的广告活动预算的值。

报告类型广告活动

campaignStatus

类型: String

描述: 广告活动的状态。

报告类型广告活动投放推广的商品搜索词

clicks

类型: Integer

描述: 总的广告点击量。

报告类型广告活动投放推广的商品搜索词

clickThroughRate

类型: Decimal

描述: 点击量除以展示量。

报告类型广告活动投放推广的商品搜索词

cost

类型: Decimal

描述: 所有点击的总成本。与支出相同。

报告类型广告活动投放推广的商品搜索词

costPerClick

类型: Decimal

描述: 总成本除以总点击次数。

报告类型广告活动投放推广的商品搜索词

date

类型: String

描述: 产生广告活动的日期,格式为 YYYY-MM-DD。

报告类型广告活动投放推广的商品已购买的商品搜索词

endDate

类型: String

描述: 报告汇总期的结束日期,格式为 YYYY-MM-DD。

报告类型广告活动投放推广的商品已购买的商品搜索词

impressions

类型: Integer

描述: 总的广告展示量。

报告类型广告活动投放推广的商品搜索词

keyword

类型: String

描述: 关键词的文本或投放表达式的表示形式。对于投放内容,投放指标中将返回相同的值。

报告类型投放已购买的商品搜索词

keywordBid

类型: Decimal

描述: 与关键词或投放表达式相关联的竞价。

报告类型投放搜索词

keywordId

类型: Integer

描述: 与关键词或投放表达式相关联的编号。

报告类型投放已购买的商品搜索词

keywordType

类型: String

描述: 竞价中使用的关键词的匹配类型。对于关键词,可选择以下选项之一: 广泛词组精准。对于投放表达式,可选择 TARGETING_EXPRESSIONTARGETING_EXPRESSION_PREDEFINED。与匹配类型 相同

报告类型投放已购买的商品搜索词

kindleEditionNormalizedPagesRead14d

类型: Integer

描述: 点击广告后 14 天内由此产生的 Kindle 版标准化页面 (KENP) 阅读量

报告类型广告活动投放推广的商品已购买的商品搜索词

kindleEditionNormalizedPagesRoyalties14d

类型: Decimal

描述: 点击广告后 14 天内由此产生的预估 Kindle 版标准化页面 (KENP) 阅读量的预估版税。

报告类型广告活动投放推广的商品已购买的商品搜索词

matchType

类型: String

描述: 竞价中使用的关键词的匹配类型。对于关键词,可选择以下选项之一: 广泛词组精准。对于投放表达式,可选择 TARGETING_EXPRESSIONTARGETING_EXPRESSION_PREDEFINED。与 keywordType 相同。

报告类型投放已购买的商品搜索词

newToBrandPurchases14d

类型: Integer

描述: 在一年的回溯期内首次订购品牌商品的订单数量。不适用于图书供应商。

报告类型已购买的商品

newToBrandPurchasesPercentage14d

类型: Decimal

描述: 品牌新客订单量占订单总数的百分比。不适用于图书供应商。

报告类型已购买的商品

newToBrandSales14d

类型: Decimal

描述: 在点击广告后的 14 天内产生的品牌新客销量的总价值。不适用于图书供应商。

报告类型已购买的商品

newToBrandSalesPercentage14d

类型: Decimal

描述: 品牌新客购买量占总销量的百分比。不适用于图书供应商。

报告类型已购买的商品

newToBrandUnitsSold14d

类型: Integer

描述: 点击广告后 14 天内作为品牌新客销量的一部分订购的由此产生的商品总量。不适用于图书供应商。

报告类型已购买的商品

newToBrandUnitsSoldPercentage14d

类型: Decimal

描述: 点击广告后 14 天内订购且属于品牌新客购买量一部分的由此产生的商品总量的百分比。不适用于图书供应商。

报告类型已购买的商品

orders14d

类型: Integer

描述: 过去 14 天内的订单量。

报告类型已购买的商品

placementClassification

类型: String

描述: 展现广告的页面位置。

报告类型广告活动

portfolioId

类型: Integer

描述: 与广告活动关联的广告组合。

报告类型投放推广的商品已购买的商品搜索词

productCategory

类型: String

描述: 与亚马逊上的品类关联的商品。

报告类型已购买的商品

productName

类型: String

描述: 商品名称。

报告类型已购买的商品

purchasedAsin

类型: String

描述: 所购商品的 ASIN。

报告类型已购买的商品

purchases14d

类型: Integer

描述: 点击广告后 14 天内发生的由此产生的转化事件的数量。

报告类型广告活动投放推广的商品已购买的商品搜索词

purchases1d

类型: Integer

描述: 点击广告后 1 天内发生的由此产生的转化事件的数量。

报告类型广告活动投放推广的商品已购买的商品搜索词

purchases30d

类型: Integer

描述: 点击广告后 30 天内发生的由此产生的转化事件的数量。

报告类型广告活动投放推广的商品已购买的商品搜索词

purchases7d

类型: Integer

描述: 点击广告后 7 天内发生的由此产生的转化事件的数量。

报告类型广告活动投放推广的商品已购买的商品搜索词

purchasesOtherSku14d

类型: Integer

描述: 点击广告后 14 天内发生且购买的 SKU 与推广的 SKU 不同的由此产生的转化事件的数量。

报告类型已购买的商品

purchasesOtherSku1d

类型: Integer

描述: 点击广告后 1 天内发生且购买的 SKU 与推广的 SKU 不同的由此产生的转化事件的数量。

报告类型已购买的商品

purchasesOtherSku30d

类型: Integer

描述: 点击广告后 30 天内发生且购买的 SKU 与推广的 SKU 不同的由此产生的转化事件的数量。

报告类型已购买的商品

purchasesOtherSku7d

类型: Integer

描述: 点击广告后 7 天内发生且购买的 SKU 与推广的 SKU 不同的由此产生的转化事件的数量。

报告类型已购买的商品

purchasesSameSku14d

类型: Integer

描述: 点击广告后 14 天内发生且购买的 SKU 与推广的 SKU 相同的由此产生的转化事件的数量。

报告类型广告活动投放推广的商品搜索词

purchasesSameSku1d

类型: Integer

描述: 点击广告后 1 天内发生且购买的 SKU 与推广的 SKU 相同的由此产生的转化事件的数量。

报告类型广告活动投放推广的商品搜索词

purchasesSameSku30d

类型: Integer

描述: 点击广告后 30 天内发生且购买的 SKU 与推广的 SKU 相同的由此产生的转化事件的数量。

报告类型广告活动投放推广的商品搜索词

purchasesSameSku7d

类型: Integer

描述: 点击广告后 7 天内发生且购买的 SKU 与推广的 SKU 相同的由此产生的转化事件的数量。

报告类型广告活动投放推广的商品搜索词

roasClicks14d

类型: Decimal

描述: 基于点击广告后 14 天内完成的购买行为所产生的广告投资回报率。

报告类型投放推广的商品搜索词

roasClicks7d

类型: Decimal

描述: 基于点击广告后 7 天内完成的购买行为所产生的广告投资回报率。

报告类型投放推广的商品搜索词

sales14d

类型: Decimal

描述: 在点击广告后的 14 天内发生的销售的总价值。

报告类型广告活动投放推广的商品已购买的商品搜索词

sales1d

类型: Decimal

描述: 在点击广告后的 1 天内发生的销售的总价值。

报告类型广告活动投放推广的商品已购买的商品搜索词

sales30d

类型: Decimal

描述: 在点击广告后的 30 天内发生的销售的总价值。

报告类型广告活动投放推广的商品已购买的商品搜索词

sales7d

类型: Decimal

描述: 在点击广告后的 7 天内发生的销售的总价值。

报告类型广告活动投放推广的商品已购买的商品搜索词

salesOtherSku14d

类型: Decimal

描述: 在点击广告后的 14 天内发生且购买的 SKU 与推广的 SKU 不同的销售的总价值。

报告类型已购买的商品

salesOtherSku1d

类型: Decimal

描述: 在点击广告后的 1 天内发生且购买的 SKU 与推广的 SKU 不同的销售的总价值。

报告类型已购买的商品

salesOtherSku30d

类型: Decimal

描述: 在点击广告后的 30 天内发生且购买的 SKU 与推广的 SKU 不同的销售的总价值。

报告类型已购买的商品

salesOtherSku7d

类型: Decimal

描述: 在点击广告后的 7 天内发生且购买的 SKU 与推广的 SKU 不同的销售的总价值。

报告类型已购买的商品投放推广的商品搜索词

searchTerm

类型: String

描述: 顾客使用的搜索词。

报告类型搜索词

spend

类型: Decimal

描述: 所有点击的总成本。与成本相同。

报告类型广告活动推广的商品

startDate

类型: String

描述: 报告汇总期的开始日期,格式为 YYYY-MM-DD。

报告类型广告活动投放推广的商品已购买的商品搜索词

targeting

类型: String

描述: 定向子句中使用的表达式对象的字符串表示形式。关键词 中还会返回投放表达式。

报告类型投放已购买的商品搜索词

topOfSearchImpressionShare

类型: Decimal

描述: 获得的搜索结果首页首位展示量占给定日期范围获得的符合条件的搜索结果首页首位展示量总量的百分比。获得展示的资格取决于多种因素,包括广告活动状态和投放状态。

报告类型广告活动投放

unitsSold14d

类型: Integer

描述: 点击广告后 30 天内产生的由此产生的已售商品数量。与 unitsSoldClicks14d 相同。仅适用于品牌推广(版本 3)广告活动,不适用于品牌推广视频或多广告组(版本 4)广告活动。

报告类型已购买的商品

unitsSoldClicks14d

类型: Integer

描述: 在点击广告后的 14 天内订购的商品的总数。与 unitsSold14d 相同

报告类型广告活动投放推广的商品已购买的商品搜索词

unitsSoldClicks1d

类型: Integer

描述: 在点击广告后的 1 天内订购的商品的总数。

报告类型广告活动投放推广的商品已购买的商品搜索词

unitsSoldClicks30d

类型: Integer

描述: 在点击广告后的 30 天内订购的商品的总数。

报告类型广告活动投放推广的商品已购买的商品搜索词

unitsSoldClicks7d

类型: Integer

描述: 在点击广告后的 7 天内订购的商品的总数。

报告类型广告活动投放推广的商品已购买的商品搜索词

unitsSoldOtherSku14d

类型: Integer

描述: 在点击广告后的 14 天内订购且购买的 SKU 与推广的 SKU 不同的商品的总数。

报告类型已购买的商品

unitsSoldOtherSku1d

类型: Integer

描述: 在点击广告后的 1 天内订购且购买的 SKU 与推广的 SKU 不同的商品的总数。

报告类型已购买的商品

unitsSoldOtherSku30d

类型: Integer

描述: 在点击广告后的 30 天内订购且购买的 SKU 与推广的 SKU 不同的商品的总数。

报告类型已购买的商品

unitsSoldOtherSku7d

类型: Integer

描述: 在点击广告后的 7 天内订购且购买的 SKU 与推广的 SKU 不同的商品的总数。

报告类型已购买的商品已购买的商品投放推广的商品搜索词

unitsSoldSameSku14d

类型: Integer

描述: 在点击广告后的 14 天内订购且购买的 SKU 与推广的 SKU 相同的商品的总数。

报告类型投放推广的商品已购买的商品搜索词

unitsSoldSameSku1d

类型: Integer

描述: 在点击广告后的 1 天内订购且购买的 SKU 与推广的 SKU 相同的商品的总数。

报告类型投放推广的商品已购买的商品搜索词

unitsSoldSameSku30d

类型: Integer

描述: 在点击广告后的 30 天内订购且购买的 SKU 与推广的 SKU 相同的商品的总数。

报告类型投放推广的商品已购买的商品搜索词

unitsSoldSameSku7d

类型: Integer

描述: 在点击广告后的 7 天内订购且购买的 SKU 与推广的 SKU 相同的商品的总数。

报告类型投放推广的商品已购买的商品搜索词