如何创建并更新订单

前提条件

如果您还没有满足前提条件，则必须完成本教程的前提条件部分的操作。

在本教程中，您需要提供以下信息：

您的亚马逊广告 API 客户端标识符。
您的亚马逊广告 API 范围。
授权令牌。
您的广告主标识符。

您还需要提供与优化目标和关键绩效指标 (KPI) 相关联的值。您将使用目标配置资源来检索这些值。

创建订单

您将使用订单资源中的 POST操作来创建订单。您可以为订单指定值，例如投放日期、预算、优化目标以及您希望广告活动使用的其他设置。创建订单时需要提供以下参数：

advertiserId：创建订单时使用的广告主标识符。您已在前提条件中检索此字段的值。
name：订单的名称。请注意，该值在订单结束后无法更改。
budget：订单的预算以及投放日期。
- startDateTime 和 endDateTime：这将为订单关联的订单项设置一个日期范围限制。请注意，订单开始投放后无法更新开始日期。结束日期最多可以在订单结束后的五天内进行更新。
- amount：预算金额。
frequencyCap：用于设置投放频率上限类型。您可以将投放频率上限类型设置为UNCAPPED，也可以通过指定每个时间单位的展示次数来定义 CUSTOM类型。
optimization：用于设置 productLocation、goal 和 goalKpi。您已使用前提条件部分的目标配置资源检索了这些值。

订单请求的示例类似于以下内容：

[{
    "advertiserId": "170xxxxxxxx01",
    "name": "This is my user friendly Order Name",
    "externalId": "This is my external Id to uniquely identify this resource",
    "comments": "Additional comments",
    "budget": {
        "budgetCaps": [{
            "amount": 2,
            "recurrenceTimePeriod": "DAILY"
        }],
        "flights": [{
            "startDateTime": "2021-12-11 05:00:00 UTC",
            "endDateTime": "2021-12-19 02:59:00 UTC",
            "amount": 120,
        }]
    },
    "agencyFee": {
        "feePercentage": 2
    },
    "frequencyCap": {
        "type": "CUSTOM",
        "maxImpressions": 3,
        "timeUnitCount": 5,
        "timeUnit": "DAYS"
    },
    "optimization": {
        "productLocation": "SOLD_ON_AMAZON",
        "goal": "AWARENESS",
        "goalKpi": "CLICK_THROUGH_RATE",
        "autoOptimizations": [
            "BUDGET"
        ],
        "biddingStrategy": "SPEND_BUDGET_IN_FULL"
    }
}]

更新订单

您将使用订单资源的 PUT 操作来更新与您通过标识符指定的订单相关联的值。您必须提交完整的的订单资源，其中包含要更新的字段的字段值，其余字段保持不变。

首先，使用订单资源的 GET 操作来检索您要更新的订单。

接下来，更新您希望更新的各个字段值。

最后，使用订单资源的 PUT 操作来更新订单。

开发人员指南概述

亚马逊广告 API 概览

如何创建并更新订单

前提条件

创建订单

更新订单