- 资源:广告订单
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- 方法
资源:广告订单
单个广告订单。
JSON 表示法 |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
字段 | |
---|---|
name |
仅供输出。广告订单的资源名称。 |
advertiserId |
仅供输出。广告订单所属广告客户的唯一 ID。 |
campaignId |
必需。不可变。广告订单所属广告系列的唯一 ID。 |
insertionOrderId |
仅供输出。广告订单的唯一 ID。由系统分配。 |
displayName |
必需。广告订单的显示名称。 必须采用 UTF-8 编码,大小上限为 240 个字节。 |
insertionOrderType |
广告订单的类型。 如果创建时未指定此字段,则其值默认为 |
entityStatus |
必需。控制广告订单能否支出预算并对广告资源出价。
|
updateTime |
仅供输出。广告订单上次更新时间的时间戳。由系统分配。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
partnerCosts[] |
与广告订单相关联的合作伙伴费用。 如果 |
pacing |
必需。广告订单的预算支出速度设置。 |
frequencyCap |
必需。广告订单的频次上限设置。 |
integrationDetails |
广告订单的其他集成详情。 |
performanceGoal |
必需。广告订单的效果目标。 |
budget |
必需。广告订单的预算分配设置。 |
bidStrategy |
广告订单的出价策略。默认情况下,系统会设置 |
reservationType |
仅供输出。广告订单的预订类型。 |
billableOutcome |
不可变。广告订单的可结算结果。 “按结果付费购买”模式已被弃用。 |
InsertionOrderType
广告订单的可能类型。
广告订单的类型决定了适用的设置和选项,例如广告的格式或定位选项。
枚举 | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
广告订单类型未指定或未知。 |
RTB |
实时出价。 |
OVER_THE_TOP |
OTT 服务。 |
InsertionOrderBudget
用于控制广告订单预算的分配方式的设置。
JSON 表示法 |
---|
{ "budgetUnit": enum ( |
字段 | |
---|---|
budgetUnit |
必需。不可变。预算单位用于指定预算是基于货币还是基于展示。 |
automationType |
用于管理广告订单出价和预算的自动化操作类型。 如果创建时未指定此字段,则其值默认为 |
budgetSegments[] |
必需。预算期列表。使用预算期可以指定广告订单在给定时间段内的具体预算。 |
InsertionOrderAutomationType
自动执行广告订单出价和预算的可能选项。
枚举 | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
此版本中未指定或未指定广告订单自动化选项。 |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
自动分配预算。允许系统自动将预算转移给所属订单项,以优化由 performanceGoal 定义的效果。没有出价设置自动化。 |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
无法在广告订单级自动进行出价或预算。出价和预算必须在订单项级手动配置。 |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
允许系统自动调整出价并将预算转移给所属订单项,以优化由 performanceGoal 定义的效果。 |
InsertionOrderBudgetSegment
用于控制单个预算期预算的设置。
JSON 表示法 |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
字段 | |
---|---|
budgetAmountMicros |
必需。广告订单将针对指定的 |
description |
预算期说明。它可用于为每个预算期输入采购订单信息,并将这些信息打印在账单上。 必须采用 UTF-8 编码。 |
dateRange |
必需。预算期的开始日期和结束日期设置。系统会根据父级广告客户的时区进行解析。
|
campaignBudgetId |
此广告订单预算期所属的广告系列预算的 |
BillableOutcome
广告订单可能的可结算结果。
枚举 | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
未指定的可计费结果。 |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
按展示次数付费。 |
BILLABLE_OUTCOME_PAY_PER_CLICK |
按点击次数付费。 |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
按有效观看次数付费。 |
方法 |
|
---|---|
|
列出某个广告订单的已分配定位选项(在各种定位类型中)。 |
|
创建新的广告订单。 |
|
删除广告订单。 |
|
获取广告订单。 |
|
列出广告客户中的广告订单。 |
|
更新现有广告订单。 |