GeneratePerformanceForecastsV1

为提供的性能指标和目标生成预测曲线。

授权资源类型：
DSP Rodeo Entity ID, DSP Advertiser Account ID

参数名：
Amazon-Ads-AccountId

参数位置：
header

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

请求参数

Header 参数

Body 参数application/json必填

示例

Example of generating an performance forecast.Example with partial failure.

此示例展示为点击、详情页面浏览和视频完成生成性能预测。

{
    "performanceForecasts": [
        {
            "advertisedProductCategoryIds": [
                "335417915575420049"
            ],
            "biddingInfo": {
                "maxAvgCpm": "25",
                "maxCpc": "1.5",
                "maxVCpm": "30"
            },
            "countryCode": "US",
            "deliveryType": "GUARANTEED",
            "endDate": "2025-12-20",
            "frequencyCap": {
                "maxImpressions": "3",
                "timeUnit": "DAYS",
                "timeUnitCount": "1",
                "type": "CUSTOM"
            },
            "performanceMetric": "CLICK",
            "reachType": "HOUSEHOLDS",
            "startDate": "2025-12-06",
            "supplyPackage": [
                "DSP_TWITCH_VIDEO"
            ],
            "targets": [
                {
                    "negative": "false",
                    "targetDetails": {
                        "audienceTarget": {
                            "audienceId": "111",
                            "groupId": "1",
                            "targetType": "AUDIENCE"
                        }
                    }
                },
                {
                    "negative": "false",
                    "targetDetails": {
                        "locationTarget": {
                            "geoLocation": "1234",
                            "targetType": "LOCATION"
                        }
                    }
                }
            ]
        },
        {
            "countryCode": "US",
            "deliveryType": "NON_GUARANTEED",
            "endDate": "2025-12-20",
            "performanceMetric": "DETAIL_PAGE_VIEW",
            "reachType": "HOUSEHOLDS",
            "startDate": "2025-12-06",
            "supplyPackage": [
                "DSP_STREAMING_TV"
            ]
        },
        {
            "countryCode": "US",
            "deliveryType": "GUARANTEED",
            "endDate": "2025-12-20",
            "performanceMetric": "VIDEO_COMPLETION",
            "reachType": "HOUSEHOLDS",
            "startDate": "2025-12-06",
            "supplyPackage": [
                "DSP_PRIME_VIDEO"
            ],
            "targets": [
                {
                    "negative": "false",
                    "targetDetails": {
                        "audienceTarget": {
                            "audienceId": "111",
                            "groupId": "1",
                            "targetType": "AUDIENCE"
                        }
                    }
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Example of generating an performance forecast.Example with partial failure.

curl --location 'https://www.amazon.com/ap/oa/mediaPlan/v1/performanceForecasts' \
--header 'Amazon-Ads-AccountId;' \
--header 'Amazon-Ads-Manager-AccountId;' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.fakeClient1234567890' \
--header 'Amazon-Advertising-API-Scope: 123123123123123' \
--header 'Content-Type: application/json' \
--data '{
    "performanceForecasts": [
        {
            "advertisedProductCategoryIds": [
                "335417915575420049"
            ],
            "biddingInfo": {
                "maxAvgCpm": "25",
                "maxCpc": "1.5",
                "maxVCpm": "30"
            },
            "countryCode": "US",
            "deliveryType": "GUARANTEED",
            "endDate": "2025-12-20",
            "frequencyCap": {
                "maxImpressions": "3",
                "timeUnit": "DAYS",
                "timeUnitCount": "1",
                "type": "CUSTOM"
            },
            "performanceMetric": "CLICK",
            "reachType": "HOUSEHOLDS",
            "startDate": "2025-12-06",
            "supplyPackage": [
                "DSP_TWITCH_VIDEO"
            ],
            "targets": [
                {
                    "negative": "false",
                    "targetDetails": {
                        "audienceTarget": {
                            "audienceId": "111",
                            "groupId": "1",
                            "targetType": "AUDIENCE"
                        }
                    }
                },
                {
                    "negative": "false",
                    "targetDetails": {
                        "locationTarget": {
                            "geoLocation": "1234",
                            "targetType": "LOCATION"
                        }
                    }
                }
            ]
        },
        {
            "countryCode": "US",
            "deliveryType": "NON_GUARANTEED",
            "endDate": "2025-12-20",
            "performanceMetric": "DETAIL_PAGE_VIEW",
            "reachType": "HOUSEHOLDS",
            "startDate": "2025-12-06",
            "supplyPackage": [
                "DSP_STREAMING_TV"
            ]
        },
        {
            "countryCode": "US",
            "deliveryType": "GUARANTEED",
            "endDate": "2025-12-20",
            "performanceMetric": "VIDEO_COMPLETION",
            "reachType": "HOUSEHOLDS",
            "startDate": "2025-12-06",
            "supplyPackage": [
                "DSP_PRIME_VIDEO"
            ],
            "targets": [
                {
                    "negative": "false",
                    "targetDetails": {
                        "audienceTarget": {
                            "audienceId": "111",
                            "groupId": "1",
                            "targetType": "AUDIENCE"
                        }
                    }
                }
            ]
        }
    ]
}'

返回响应

🟢207

application/json

GeneratePerformanceForecastsV1 207 响应

Bodyapplication/json

示例

Example of generating an performance forecast.Example with partial failure.

此示例展示为点击、详情页面浏览和视频完成生成性能预测。

{
    "error": [],
    "success": [
        {
            "index": "0",
            "performanceForecast": {
                "countryCode": "US",
                "creationDateTime": "2025-09-02T23:36:12.103Z",
                "currencyCode": "USD",
                "dataPoints": [
                    {
                        "cpc": "6.928674875740527",
                        "ctr": "0.004113340647543945",
                        "ecpm": "28.5",
                        "prediction": "7",
                        "spend": "54.15"
                    },
                    {
                        "cpc": "6.928713977016345",
                        "ctr": "0.00411331743445307",
                        "ecpm": "28.5",
                        "prediction": "15",
                        "spend": "108.3"
                    }
                ],
                "performanceMetric": "CLICK"
            }
        },
        {
            "index": "1",
            "performanceForecast": {
                "countryCode": "US",
                "creationDateTime": "2025-09-02T23:36:12.103Z",
                "currencyCode": "USD",
                "dataPoints": [
                    {
                        "cpdpv": "1",
                        "prediction": "0",
                        "spend": "88.11212292385102"
                    },
                    {
                        "cpdpv": "174.40159131659834",
                        "prediction": "1",
                        "spend": "220.28562873268126"
                    }
                ],
                "performanceMetric": "DETAIL_PAGE_VIEW"
            }
        },
        {
            "index": "2",
            "performanceForecast": {
                "countryCode": "US",
                "creationDateTime": "2025-09-02T23:36:12.103Z",
                "currencyCode": "USD",
                "dataPoints": [
                    {
                        "cpvc": "0.026002616574872007",
                        "prediction": "15925",
                        "spend": "414.098",
                        "vcr": "0.8651263973849037"
                    },
                    {
                        "cpvc": "0.026000294298434187",
                        "prediction": "30405",
                        "spend": "790.56111365",
                        "vcr": "0.865203668150585"
                    }
                ],
                "performanceMetric": "VIDEO_COMPLETION"
            }
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠429

🔴500服务器错误

🔴503服务器故障

🔴504网关超时