迁移到版本 4 品牌推广活动

概述

品牌推广的广告主现在可以创建广告组来更好地组织和管理他们的广告活动。广告主可以按品牌、关键词、商品、品类、广告格式、落地页或与您的目标或营销方案相关的其他分类来组织并整理广告组。品牌可以在同一个广告组中测试不同的创意素材，让广告主能够比较不同的效果并更好地了解亚马逊顾客的行为。

主要优势

1. 通过创建与您的营销方案和目标相一致的广告组，您可以按照适合您的方式来组织广告活动。
2. 使用报告监控广告组广告活动的效果。您可以根据关键词、广告活动广告位、搜索词、归因于广告的购买等选项轻松获取报告。此外，您无需再针对不同的广告活动类型单独运行报告，也无需手动计算品牌推广的广告支出产生的绩效。
3. 根据您的目标充分利用测试功能，无论您的目标是建立品牌知名度、提升购买意向，还是增加销量。您可以针对不同的广告格式或落地页对投放内容进行测试，并衡量投放效果。您还可以在同一个广告组中测试相同广告格式的不同版本，从而更好地了解顾客行为。
4. 在亚马逊广告搜索广告产品中使用一致的方案，以便更高效地开展广告活动。广告组功能也可用于商品推广和展示型推广。

接口对等参数

版本 3	版本 4 测试版	版本 4 正式发布版
POST /sb/campaigns	POST /sb/beta/campaigns	POST /sb/v4/campaigns
GET /sb/campaigns GET /sb/campaigns/{campaignId}	POST /sb/beta/campaigns/list	POST /sb/v4/campaigns/list
PUT /sb/campaigns	-	PUT /sb/v4/campaigns
DELETE /sb/campaigns/{campaignId}	-	POST /sb/v4/campaigns/delete
GET /sb/adGroups GET /sb/adGroups/{adGroupId}	POST /sb/beta/adGroups/list	POST /sb/v4/adGroups/list
-	POST /sb/beta/adGroups	POST /sb/v4/adGroups
-	POST /sb/beta/adGroups/delete	POST /sb/v4/adGroups/delete
-	PUT /sb/beta/adGroups	PUT /sb/v4/adGroups
-	POST /sb/beta/ads/list	POST /sb/v4/ads/list
-	POST /sb/beta/ads/video	POST /sb/v4/ads/video
-	POST /sb/beta/ads/brandVideo	POST /sb/v4/ads/brandVideo
-	POST /sb/beta/ads/productCollection	POST /sb/v4/ads/productCollection
-	POST /sb/beta/ads/storeSpotlight	POST /sb/v4/ads/storeSpotlight
-	PUT /sb/beta/ads	PUT /sb/v4/ads
-	POST /sb/beta/ads/delete	POST /sb/v4/ads/delete

常见问题

从测试版接口迁移到正式发布版接口需要多少时间？

版本 4 测试版接口在 2023 年 8 月 31 日之前可用。8 月 31 日之后，所有使用测试版接口的请求调用都将被拒绝。

有关更多信息，请参阅弃用。

版本 4 测试版和正式发布版接口是否有区别？

没有，版本 4 正式发布版和开放测试版端点之间没有功能或合约上的变化。

多广告组广告活动与当前的广告活动结构有何不同？

当前广告活动接口不允许您创建或更新广告组，也不允许将广告素材与广告组关联。当前的广告活动包含只读广告组，其中创意素材与广告活动相关联，而不是与广告组关联。

在本指南中，我们将不支持多广告组的当前广告活动称为旧版广告活动，而支持多广告组的广告活动称为多广告组广告活动。新的多广告组广告活动包含三个实体：广告活动、广告组和广告。请参考下图，了解广告活动层次结构。

• 广告活动： 广告活动将按广告预算和日期对广告进行分组。
• **广告组：**广告组允许您按品牌、关键词、商品、品类、广告格式、落地页或其他与您的目标相关的分类对广告进行组织和管理。
• **广告：**使用广告来管理创意素材的不同变体。将多个广告与共享相同落地页但不同 ASIN、标题、生活方式图片、商品品类或视频的每个广告组相关联。

要支持多广告组广告活动，需要进行哪些 API 更改？

亚马逊建议您迁移到品牌推广活动管理 API 的最新版本，现在已正式发布。新版本允许广告主创建并管理多广告组广告活动，并查看之前创建的任一品牌推广活动。广告活动列表响应包含一个新字段 isMultiAdGroupsEnabled，如果广告活动是根据最新版本构建的，则返回 true。

您可以查看亚马逊的创建多广告组广告活动教程，以了解使用新接口的步骤和示例。

注意

现有的版本 3 GET 广告活动接口返回多广告组广告活动中的第一个广告组和广告。如果您要查看所有可用的广告组和广告，则需要使用新广告活动列表接口。

使用现有版本 3 GET 广告活动接口的影响是什么？

当前版本 3 GET 接口提供了对多广告组广告活动的有限支持。GET 响应将仅包含多广告组广告活动中的第一个创意素材。

如果您使用的是版本 3.3 GET 广告活动接口，则响应包括可选字段 isMultiAdGroupsEnabled、adGroupCount 和 adCount。这些字段将帮助您确定广告活动是否已启用多广告组，以及该广告活动中的广告组和广告数量。亚马逊建议您使用版本 4 广告活动列表接口检索所有广告活动类型的广告活动级别的详细信息。

警告

版本 3.3 GET 广告活动接口将不会返回品牌视频广告。要获得品牌视频广告的创意素材详情，请使用版本 4 POST sb/v4/ads/list 接口。

注意

如果您在版本 3 GET 广告活动调用中使用任何广告格式或创意素材类型的筛选条件，响应将不包括多广告组广告活动。在版本 4 广告活动中，广告格式和创意素材类型筛选条件属于广告实体，而不是广告活动实体。

警告

广告平台将在 2022 年 9 月切换到新的广告活动类型。要检索广告平台中创建的广告活动的完整详情，您需要使用新的 POST /sb/v4/campaigns/list 接口。您还需要在报告中使用设置为 all 的 creativeType 筛选条件来获取广告平台中创建的广告活动的数据。

我能否向旧版广告活动添加多个广告组？

不允许向旧版广告活动添加新的广告组。这些广告活动的广告组仅支持 GET 操作。仅支持通过新的版本 4 接口对新的多广告组广告活动创建和管理广告组。如果您尝试使用版本 4 接口更新旧版广告组，则会收到 INVALID_ARGUMENT 错误。

如何更新或存档多广告组广告活动？

通过版本 4 的广告活动管理 API 可以使用 PUT 和 DELETE 接口。

注意

POST sb/v4/adGroups/list 接口的 NameFilter 不适用于旧版广告活动，因为广告组名称是根据广告活动名称自动生成的，因此亚马逊不建议对旧版广告活动使用此筛选条件。

有关更多信息，请查看管理多广告组广告活动指南。

使用报告 API 检索报告数据需要进行哪些更改？

要检索多广告组广告活动的报告数据，您必须在报告请求中包含 "creativeType": "all"。使用此筛选条件的报告会同时返回多广告组广告活动和旧版广告活动的报告数据。

注意

如果您不使用此筛选条件，您的报告将不包含与多广告组广告活动相关的数据。

对于广告报告，多广告组广告活动将支持 adId 指标，以便您可以跟踪广告的效果。对于旧版广告活动，您不会在广告报告中获得 adId。

对投放和建议 API 是否有影响？

对于投放或建议接口没有更改。现有接口与所有类型的广告活动兼容。对于新广告活动中的关键词不设审核。这些关键词在添加到广告组后立即生效。

广告素材审核是否有任何变化？

对于多广告组广告活动，只会根据广告政策对广告进行审核。如果您的广告因违反广告政策而被拒绝，则广告活动状态将保持不变。在旧版广告活动中，创意素材与广告活动相关联。因此，如果素材因广告政策被拒绝，则您的广告活动状态将更改为已拒绝。您可以使用审核 API 来查看广告的审核状态。

注意

如果有一个有效的广告，新的广告活动可以继续投放展示量。

支持哪些广告格式？

新 API 支持以下广告格式：商品集、品牌旗舰店焦点模式、视频和品牌视频。您可以利用亚马逊的新广告格式“品牌视频”将品牌视频链接到品牌旗舰店页面。

警告

您无法使用现有版本 3 API 创建、更新或获取品牌视频广告。

多广告组广告活动是否包含在快照中？

否，使用版本 4 接口创建的广告活动不会包含在快照中。

版本 4 中的创意素材是否有变化？

是的，您需要使用素材库 API 上传视频和图片素材并生成 assetId。然后，您可以在创建广告时使用 assetId。

版本 3 广告活动中创建的广告是否有 adId？

没有。版本 3 广告活动中创建的任何广告都不会有关联的 adId 或 name。要了解更多信息，请参阅管理广告。

为什么我的一些创意素材在 POST sb/v4/ads/list 和 GET sb/campaigns 中缺少字段？

一些广告主遇到了一个已知的问题，即旧版的创意素材缺少创意素材级别的字段。为确保您收到所有创意素材级别的字段，亚马逊建议您上传最新版本的创意素材。

为什么我的旧版广告活动在版本 4 中的广告活动 state 显示为 ENABLED？

旧版广告活动的广告活动 state 与版本 3 和版本 4 的 GET 广告活动接口的响应有所不同。版本 3 中的广告活动状态包括用户采取的操作和广告活动投放状态的组合。在版本 4 GET 响应中，亚马逊对旧版广告活动和多广告组广告活动提供了标准化的状态管理，其中广告活动 state 字段代表用户操作，而扩展数据字段中的广告活动 servingStatus 将帮助您识别广告活动的投放状态。这种方法与商品推广和展示型推广的广告活动状态管理相似。如果您希望对旧版广告活动保持类似的状态响应，亚马逊建议您开始使用广告活动状态和广告活动投放状态的组合。

进一步了解

• 广告活动版本 4 API 参考
• 广告组版本 4 API 参考
• 广告版本 4 API 参考
• 创建广告活动
• 管理多广告组广告活动

2023 年 6 月更新

概述

品牌推广正在更改旧版本 3 API 的后端数据存储，以保持所有搜索广告方案的一致性。品牌推广版本 3 广告活动管理 API 现在使用版本 4 多广告组广告活动结构来创建新的广告活动和草稿。API 合约或请求/响应对象没有变化。所有版本 3 广告活动管理 API 将继续按预期运行，没有任何变化。

谁受到影响？

广告主、广告代理商和软件服务商目前使用品牌推广 (SB) 旧版本 3 API 来创建广告活动或草稿。这项变更目前已在美国站点的广告活动中推出。在接下来的几个月中，亚马逊将继续在美国以外地区推出这些变更。

有什么影响？

| API | 描述 | |--- |--- | | POST /sb/campaigns | 使用此接口创建的任何新广告活动都将创建包含一个广告组和一个广告的广告活动。广告组和广告的名称将与广告活动的名称相同。**警告：**如果向广告活动添加了多个广告或广告组，则版本 3 GET /sb/campaigns 接口将仅返回该广告活动中第一个广告的 creative/adFormat。 | | POST /sb/drafts/campaigns | 新草稿将在后端保存为版本 4 广告活动。 | | POST /sb/drafts/campaigns/submit | 如果您有现成的草稿或全新的草稿，则在提交后，该广告活动将转换为多广告组广告活动。 |

亚马逊为什么要进行这样的更改？

所有亚马逊搜索广告方案都在转向使用行业标准广告组数据结构的通用域模型。通过这一更改，广告主对于新广告活动可以获得涵盖旧版本 3 和版本 4 API 的的标准体验。2023 年 5 月之后创建的新广告活动将包含广告组广告活动结构并支持同时通过版本 3 和版本 4 进行广告活动管理。

对我的亚马逊广告平台体验是否有影响？

以后，广告平台将以多广告组格式显示广告活动。您可以进一步了解广告活动、广告组和广告的层次结构。这些工作流和信息卡自 2022 年 10 月起在广告平台上可用。如果您已经在使用广告平台创建广告活动，那么对于使用版本 3 API 创建的广告活动，您现在会看到一致的行为。

以下屏幕截图显示了旧版广告活动的详情页面。屏幕上没有广告组功能。

下图描绘了多广告组广告活动的详情页面示例。屏幕上强调了广告组功能

如果我在亚马逊广告平台中创建其他广告组或广告会有什么影响？

如果您在使用版本 3 API 创建的广告活动中创建其他广告组或广告，则只能看到第一个广告组。如果广告活动中有其他广告组或广告，则在版本 3 API 中这些内容将不可见。旧版品牌推广版本 3 API 将不会获得任何新功能。亚马逊鼓励合作伙伴迁移到品牌推广版本 4 API，以利用新功能并创建包含多个广告组的广告活动。

使用报告 API 检索报告数据需要进行哪些更改？

不会对报告产生任何影响。通过广告平台、批量表、旧版本 3 API 和版本 4 API 创建的所有广告活动的效果数据将包含在版本 2 报告 API 中。

广告素材审核是否有任何变化？

在旧版广告活动中，创意素材与广告活动相关联。因此，如果素材因广告政策被拒绝，则您的整个广告活动状态将更改为已拒绝。在基于广告组的新广告活动中，将对单个广告进行审核，以验证是否符合广告政策。即使广告组层次结构中的某个广告被拒绝，您的广告活动状态也将保持不变。您可以使用审核 API 来查看广告的审核状态。

多广告组广告活动是否包含在快照中？

快照尚不支持基于广告组的广告活动。亚马逊将在快照中为版本 4 广告活动提供支持。

需要帮助？

除了看到响应时间缩短外，响应不应有任何变化。如果您遇到任何响应方面的问题，请创建一个开发人员支持工单 (TT) 。