开发人员指南概述

亚马逊广告 API 概览

广告活动入门操作

前提条件

提示

如果您希望测试品牌推广活动的创建流程而不必担心广告支出,则可以创建测试账户来完成本教程。

第 1 步: 创建广告活动

第一步需使用POST /sb/v4/campaigns 接口创建广告活动。

可以在广告活动级别指定竞价方案。亚马逊可以自动完成竞价,以优化广告位的竞价(搜索结果首页首位除外),也可以通过指定自定义竞价调整来进行优化。

注意

如果您是卖家并且您的品牌已获得批准,则必须提供 brandEntityId。您可以调用GET /brands endpoint 来获取 brandEntityId

采用自动竞价的请求示例

如果 bidOptimization 的值设为 True,亚马逊将自动为您设置合适的广告位调整竞价。

curl --location --request POST 'https://advertising-api.amazon.com/sb/v4/campaigns' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxxxx' \
--header 'Accept: application/vnd.sbcampaignresource.v4+json' \
--data-raw'{
"campaigns": [{
    "budgetType": "DAILY",
    "name": "My campaign",
    "state": "PAUSED",
    "startDate": "2023-06-25",
    "budget": 10,
    "bidding": {
        "bidOptimization": "true"
    }
}]
}
'

采用自定义竞价的请求示例

如果请求中包含 bidAdjustmentsByShopperSegment 对象,则您可以指定一个百分比,以便在未从您的品牌购买产品的新顾客与广告互动时提高竞价。如果您要添加 bidAdjustmentsByPlacement 对象,则可以根据页面的广告位指定竞价提高或降低的百分比。如果同时指定了两个对象,则竞价调整将采用倍增。bidOptimizationStrategy 参数默认经过优化,有助于最大限度地提升销量。另一种选择是根据品牌新客的获取情况进行优化。

curl --location --request POST 'https://advertising-api.amazon.com/sb/v4/campaigns' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxxxx' \
--header 'Accept: application/vnd.sbcampaignresource.v4+json' \
--data-raw'{
"campaigns": [{
    "budgetType": "DAILY",
    "name": "My campaign",
    "state": "PAUSED",
    "startDate": "2023-06-30",
    "budget": 10,
    "bidding": {
        "bidOptimization": "false",
        "bidAdjustmentsByShopperSegment": [{
            "percentage": 200,
            "shopperSegment": "NEW_TO_BRAND_PURCHASE"
        }],
        "bidAdjustmentsByPlacement": [{
                "percentage": 20,
                "placement": "HOME"
            },
            {
                "percentage": 15,
                "placement": "DETAIL_PAGE"
            },
            {
                "percentage": 15,
                "placement": "OTHER"
            }
        ],
        "bidOptimizationStrategy": "MAXIMIZE_NEW_TO_BRAND_CUSTOMERS"
    }
}]
}
}
'

第 2 步: 创建广告组

使用 POST /sb/v4/adGroups 接口创建至少一个广告组。使用第 1 步中返回的campaignId 创建您的广告组。

请求示例

此请求示例中显示创建了与一个广告活动关联的广告组。成功调用后将返回 207 响应代码,并指示已创建的广告组的 adGroupId

curl --location --request POST 'https://advertising-api.amazon.com/sb/v4/adGroups' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxxxx' \
--header 'Accept: application/vnd.sbadgroupresource.v4+json' \
--data-raw '{
"adGroups": [{
    "campaignId": "{{campaignId}}",
    "name": "My ad group name",
    "state": "ENABLED"
}]
}
'

第 3 步: 上传并注册创意素材

在创建广告之前,您可以使用创意素材库 API上传并注册视频或图片素材。

第 4 步: 创建广告

获得上一步中返回的 assetId 后,便可以创建广告。广告类型包括商品集、视频、品牌视频和品牌旗舰店焦点模式。一个广告组中必须至少有一个广告,并且一个广告组不能使用多种广告类型。

要进一步了解每种广告类型的要求,请参阅:

第 5 步: 为您的广告组添加投放内容

在广告组中创建广告后,您需要添加投放内容。广告组可以与商品投放表达式或关键词投放表达式相关联。

第 6 步: 检查审核状态

您可以通过在 Moderation API中将 adId 作为 id 来传递,以便检查广告的审核状态。

第 7 步: 对您的广告或创意素材进行相应的更改

根据审核状态,您可能需要对广告或创意素材进行更改。有关更多详细信息,请参阅管理素材管理广告活动