如何向订单项添加创意素材以及从订单项中删除创意素材
先决条件
如果您还没有满足先决条件,则必须完成本教程的先决条件部分的操作。
在本教程中,您需要提供以下信息:
- 您的亚马逊广告 API 客户端标识符。
- 您的亚马逊广告 API 范围。
- 授权令牌。
- 您的广告主标识符。
关联创意素材与订单项
在关联创意素材与订单项之前,您需要在以下字段中输入相应的值:
订单项标识符
您将使用订单项资源 的 GET
操作来检索订单项标识符。
创意素材标识符
您必须先使用亚马逊 DSP 用户界面创建创意素材,才能在亚马逊 DSP API 中使用创意素材。创意素材创建完成后,您将使用创意素材资源的 GET
操作来检索创意素材标识符。
在这些字段输入相应的值后,您将需要使用订单项创意素材关联资源 的 POST
操作来关联创意素材和订单项。以下字段为必填项:
advertiserId
: 您在先决条件部分中检索到的广告主标识符。operation
: 要关联创意素材与订单项,此值必须始终为CREATE
。
请注意,POST
操作仅支持将单个创意素材关联到一个订单项。要将多个创意素材附加到一个订单项,必须先使用创意素材资源 的 GET
操作来检索创意素材列表。然后,循环浏览创意素材列表,并使用如上所述的订单项创意素材关联资源 的 POST
操作来对每项创意素材进行操作。
更新与订单项关联的创意素材的属性
在更新与订单项关联的创意素材的属性之前,您需要在以下字段中输入相应的值:
LineItemCreativeAssociation
您将需要使用订单项创意素材关联资源 的 GET
操作并通过所需订单项的标识符来检索LineItemCreativeAssociation
对象的列表。查看该列表中的每个对象,找出哪些对象包含您要更新的属性。
接下来,可以在每个对象中更新以下字段:
startDate
和endDate
weight
: 如果您已在与该创意素材关联的订单项中将creativeRotationType
字段设置为WEIGHTED
,则必须为此字段指定一个值。- 上述
GET
操作中检索到的对象。
最后,您将需要使用订单项创意素材关联资源 的 PUT
操作,以及在请求正文中更新的对象来更新这些属性。
请注意,PUT
操作仅支持更新单个创意素材的属性。要更新多个创意素材的属性,您必须首先使用订单项创意素材关联资源 的 GET
操作来检索订单项创意素材关联项目的列表。然后,循环浏览创意素材列表,并使用如上所述的订单项创意素材关联资源 的 PUT
操作。
取消关联订单项中的创意素材
在取消关联创意素材与订单项之前,您需要在以下字段中输入相应的值:
LineItemCreativeAssociation
您将需要使用订单项创意素材关联资源 的 GET
操作并通过所需订单项的标识符来检索LineItemCreativeAssociation
对象的列表。查看列表中的每个对象,找到您要取消关联的对象。
接下来,您将需要使用订单项创意素材关联资源 的 POST
操作取消创意素材与订单项的关联。在此操作的请求正文中,请指定以下字段的值:
advertiserId
: 您在先决条件部分中检索到的广告主标识符。operation
: 设置为DELETE
。- 上述
GET
操作中检索到的对象。
请注意,POST
操作仅支持取消单个创意素材与一个订单项的关联。要取消多个创意素材与订单项的关联,您必须首先使用订单项创意素材关联资源 的 GET
操作来检索订单项创意素材关联项目的列表。然后,循环浏览创意素材列表,并使用如上所述的订单项创意素材关联资源 的 POST
操作来对每项创意素材进行操作。