CreateHistoricalReachCurve

POST

/mediaPlan/v2/historicalReachCurves

最后修改时间：2026-08-27 23:21:02

责任人：未设置

提交生成历史覆盖曲线的请求。

授权资源类型：
DSP Rodeo Entity ID、DSP 广告商账户 ID

参数名称：
Amazon-Ads-AccountId

参数位置：
header

需要以下权限之一：
["campaign_view"]

授权资源类型：
全球广告账户 ID、配置文件 ID

参数名称：
Amazon-Ads-AccountId

参数位置：
header

需要以下权限之一：
["campaign_view"]

请求参数

Header 参数

Body 参数application/json必填

示例

Example of generating US historical reach curve using one audience ID and a demographic type.Example of generating US historical reach curve using multiple audience IDs and one demographic typeExample of generating US historical reach curve using multiple audience segments (with one negated)

。

{
    "endDate": "2023-05-31",
    "startDate": "2023-05-01",
    "targeting": [
        {
            "dimensionName": "geography",
            "dimensionType": "SINGLE",
            "dimensionValue": "US"
        },
        {
            "dimensionName": "frequencyThreshold",
            "dimensionType": "SINGLE",
            "dimensionValue": "2"
        },
        {
            "dimensionName": "supplyPackage",
            "dimensionType": "SINGLE",
            "dimensionValue": "STV"
        },
        {
            "dimensionName": "reachType",
            "dimensionType": "SINGLE",
            "dimensionValue": "INDIVIDUALS"
        },
        {
            "dimensionName": "demographic",
            "dimensionType": "SINGLE",
            "dimensionValue": "M18_35"
        },
        {
            "dimensionName": "audienceId",
            "dimensionType": "SINGLE",
            "dimensionValue": "123123123"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

curl --location 'https://www.amazon.com/ap/oa/mediaPlan/v2/historicalReachCurves' \
--header 'Amazon-Ads-AccountId: 2095123454329876' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.fakeClient1234567890' \
--header 'Amazon-Advertising-API-Scope: 123123123123123' \
--header 'Content-Type: application/json' \
--data '{
    "endDate": "2023-05-31",
    "startDate": "2023-05-01",
    "targeting": [
        {
            "dimensionName": "geography",
            "dimensionType": "SINGLE",
            "dimensionValue": "US"
        },
        {
            "dimensionName": "frequencyThreshold",
            "dimensionType": "SINGLE",
            "dimensionValue": "2"
        },
        {
            "dimensionName": "supplyPackage",
            "dimensionType": "SINGLE",
            "dimensionValue": "STV"
        },
        {
            "dimensionName": "reachType",
            "dimensionType": "SINGLE",
            "dimensionValue": "INDIVIDUALS"
        },
        {
            "dimensionName": "demographic",
            "dimensionType": "SINGLE",
            "dimensionValue": "M18_35"
        },
        {
            "dimensionName": "audienceId",
            "dimensionType": "SINGLE",
            "dimensionValue": "123123123"
        }
    ]
}'

返回响应

🟢200成功

application/json

CreateHistoricalReachCurve 200 响应。

Bodyapplication/json

示例

。

{
    "message": "The report is being generated.",
    "reportId": "c571b6ec-ab2d-41eb-a38c-34b053ee1a1e",
    "status": "PROCESSING"
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠415

🟠429

🔴500服务器错误

修改于 2026-08-27 23:21:02

ListHistoricalReachCurvesMetadata

GetHistoricalReachCurve