如何更新商品跟踪信息

前提条件

您必须首先完成本教程的前提条件部分的操作。

使用 CSV 文件更新商品跟踪信息

您可以使用 CSV 文件更新商品跟踪信息。CSV 文件的格式必须为：

ASIN	Featured	Domain
您的 ASIN		要匹配的域

您可以使用以下 CSV 模板创建自己的 CSV 文件：

ASIN,Featured,Domain,，*** 说明 ***
<在此处输入 ASIN>,,<在此处输入域>,，请注意必须使用标头行以确保上传所有 ASIN
,,,,"使用以下有关“Featured”和“Domain”列的指南输入 ASIN 列表："
,,,,"1) 使用“X”标记为精选 ASIN，否则将其留空（注意： 对于超过 100 个精选 ASIN 的订单将不会发送缺货提醒）"
,,,,2) 将每个 ASIN 与北美的以下亚马逊域之一进行匹配：
,,,,amazon.com
,,,,amazon.ca
,,,,Prime Now US
,,,,Prime Now CA
,,,,Prime Video ROW-NA
,,,,Whole Foods Market US

创建 CSV 文件后，您将首先使用 /dsp/fileUploads/policy/ 资源创建一个 AWS S3 策略。

例如：

{
    "url": "https://amazon-dsp-api-368306839028-us-east-1.s3.amazonaws.com/",
    "fields": {
        "key": "product/2021/5/24/b27d75a9-b012-4c25-9122-5714537b7b0f.csv",
        "x-amz-algorithm": "AWS4-HMAC-SHA256",
        "x-amz-credential": "ASIAVLQGMLX2BUFP5NQX/20210524/us-east-1/s3/aws4_request",
        "x-amz-date": "20210524T050135Z",
        "x-amz-security-token": "YOUR-TOKEN-HERE",
        "policy": "YOUR-POLICY-HERE",
        "x-amz-signature": "YOUR-SIGNATURE-HERE"
    }
}

成功创建 AWS S3 策略后，您需要将 CSV 上传到 Amazon S3。

例如，您可以使用 python 请求或 javascript 请求

您可以使用任何支持 HTTP POST 操作的编程语言。

文件成功上传到 Amazon S3 后，您可以将 /dsp/orders/{orderId}/conversionTracking/products 资源的 PUT 操作与 productFile 参数中的 Amazon S3 路径结合使用，从而更新商品跟踪信息。例如：

{ 
  "productFile": "product/2021/5/24/b27d75a9-b012-4c25-9122-5714537b7b0f.csv" 
}

请注意，如果商品跟踪信息更新成功，您将收到 HTTP 204 - No content 响应。

使用 JSON 列表更新商品跟踪信息

要使用 JSON 列表更新商品跟踪信息，您将使用 /dsp/orders/{orderId}/conversionTracking/products 资源的 PUT 操作。它采用以下参数：

• productId： 也称为 ASIN。商品的 ASIN 可在商品详情页的商品详情部分找到。使用空格、逗号、制表符或换行符分隔 ASIN。
• productAssociation： 精选 ASIN 是此订单中在创意素材中推广的特定商品。除了精选 ASIN 和父 ASIN 之外，还跟踪非精选 ASIN 或变体，这将确保正确的转化指标，并防止广告活动启动后无法恢复的数据丢失。
• domain： 亚马逊域。

例如：

{
    "productList": [
        {
            "productId": "B004VB9OVK",
            "productAssociation": "FEATURED",
            "domain": "AMAZON_US"
        },
        {
            "productId": "B07HJW9HKL",
            "productAssociation": "FEATURED",
            "domain": "AMAZON_US"
        }
    ]
}

请注意，如果商品跟踪信息更新成功，您将收到 HTTP 204 - No content 响应。