REST Resource: advertisers.campaigns

资源:广告系列

单个广告系列。

JSON 表示法
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "campaignGoal": {
    object (CampaignGoal)
  },
  "campaignFlight": {
    object (CampaignFlight)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "campaignBudgets": [
    {
      object (CampaignBudget)
    }
  ]
}
字段
name

string

仅供输出。广告系列的资源名称。

advertiserId

string (int64 format)

仅供输出。广告系列所属的广告客户的唯一 ID。

campaignId

string (int64 format)

仅供输出。广告系列的唯一 ID。由系统分配。

displayName

string

必需。广告系列的显示名称。

必须采用 UTF-8 编码,大小上限为 240 个字节。

entityStatus

enum (EntityStatus)

必需。控制此广告系列下的广告订单能否支出预算并对广告资源出价。

  • 接受的值包括 ENTITY_STATUS_ACTIVEENTITY_STATUS_ARCHIVEDENTITY_STATUS_PAUSED
  • 对于 campaigns.create 方法,不允许使用 ENTITY_STATUS_ARCHIVED
updateTime

string (Timestamp format)

仅供输出。上次更新广告系列时的时间戳。由系统分配。

采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式的时间戳,采用纳秒级精度,最多包含九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

campaignGoal

object (CampaignGoal)

必需。广告系列的目标。

campaignFlight

object (CampaignFlight)

必需。广告系列的计划支出和持续时间。

frequencyCap

object (FrequencyCap)

必需。广告系列的频次上限设置。

campaignBudgets[]

object (CampaignBudget)

此广告系列可用的预算列表。

如果未设置此字段,则广告系列将使用无限制预算。

CampaignGoal

用于控制广告系列目标的设置。

JSON 表示法
{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}
字段
campaignGoalType

enum (CampaignGoalType)

必需。广告系列目标的类型。

performanceGoal

object (PerformanceGoal)

必需。广告系列的效果目标。

performanceGoalType 的可接受值包括:

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_OTHER

CampaignGoalType

可能的广告系列目标类型。

枚举
CAMPAIGN_GOAL_TYPE_UNSPECIFIED 该版本中未指定或未知目标价值。
CAMPAIGN_GOAL_TYPE_APP_INSTALL 提升应用安装量或互动度。
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS 提升用户对某个品牌或产品的认知度。
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION 提高线下或实体店销售额。
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION 推动在线操作或访问。

CampaignFlight

用于跟踪广告系列的计划支出和持续时间的设置。

JSON 表示法
{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}
字段
plannedSpendAmountMicros

string (int64 format)

广告系列为其指定的plannedDates预计支出的金额。这不会限制广告投放,只会用于在 DV360 界面中跟踪支出。

金额以微单位表示。必须大于或等于 0。例如,500000000 代表 500 个标准单位的货币。

plannedDates

object (DateRange)

必需。广告系列预计投放的日期。它们是相对于父级广告客户的时区进行解析的。

  • 此处指定的日期不会影响广告投放。用于生成提醒和警告。例如,如果任何子级广告订单的排期不在这些日期范围之内,界面中会显示一条警告。
  • startDate”是必填字段,且必须是当前日期或更晚的日期。
  • endDate 是可选项。如果指定,则必须为 startDate 或更高版本。
  • 任何指定日期都必须早于 2037 年。

CampaignBudget

用于控制广告系列预算分配方式的设置。

JSON 表示法
{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}
字段
budgetId

string (int64 format)

广告系列预算的唯一 ID。由系统分配。请勿为新预算进行设置。

为“campaignBudgets”更新或添加预算时必须包含。否则,系统会生成并分配新 ID。

displayName

string

必需。预算的显示名称。

必须采用 UTF-8 编码,大小上限为 240 个字节。

budgetUnit

enum (BudgetUnit)

必需。不可变。指定预算的度量方式是货币还是展示次数。

budgetAmountMicros

string (int64 format)

必需。为关联的广告订单细分可设置预算的总金额。

金额以微单位表示。必须大于 0。例如,500000000 代表 500 个标准单位的货币。

dateRange

object (DateRange)

必需。广告系列预算的日期范围。关联的预算期的日期范围可能有所不同。它们是相对于父级广告客户的时区进行解析的。

startDateendDate 都必须早于 2037 年。

externalBudgetSource

enum (ExternalBudgetSource)

必需。预算的外部来源。

externalBudgetId

string

不可变。供外部来源标识此预算的 ID。

如果已设置此字段,并且相应结算资料的账单明细级别设为“预算级采购订单”,那么根据此预算投放的所有展示都将在账单中包含此 ID。

在广告系列下必须是唯一的。

invoiceGroupingId

string

不可变。用于对预算进行分组以包含在同一账单的 ID。

如果已设置此字段,并且相应结算资料的账单级别设为“预算账单分组 ID”,则共享同一 invoiceGroupingId 的所有externalBudgetId会划分到同一账单中。

prismaConfig

object (PrismaConfig)

供 Mediaocean Prisma 工具使用的其他元数据。

Mediaocean 预算要求。

仅适用于 prismaEnabled 广告客户。

ExternalBudgetSource

广告系列预算细分的外部来源。

枚举
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED 此版本中未指定或未知外部预算来源值。
EXTERNAL_BUDGET_SOURCE_NONE 预算没有外部来源。
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN 预算来源为 Mediaocean。

PrismaConfig

Mediaocean Prisma 工具特有的设置。

JSON 表示法
{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}
字段
prismaType

enum (PrismaType)

必需。Prisma 类型。

prismaCpeCode

object (PrismaCpeCode)

必需。Mediaocean Prisma 工具提供的相关客户、产品和估算代码。

supplier

string

必需。分配此预算的实体(DSP、网站等)。

PrismaType

Prisma 预算的可能类型。

枚举
PRISMA_TYPE_UNSPECIFIED 该版本中未指定类型或类型未知。
PRISMA_TYPE_DISPLAY 显示类型。
PRISMA_TYPE_VIDEO 视频类型。
PRISMA_TYPE_AUDIO 音频类型。
PRISMA_TYPE_SOCIAL 社交类型。
PRISMA_TYPE_FEE 费用类型。

PrismaCpeCode

Google 付款中心支持搜索和过滤此代码的各个字段。

JSON 表示法
{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}
字段
prismaClientCode

string

Prisma 客户端代码。

prismaProductCode

string

Prisma 产品代码。

prismaEstimateCode

string

Prisma 估算代码。

方法

create

创建一个新广告系列。

delete

永久删除广告系列。

get

获取广告系列。

list

列出广告客户中的广告系列。

listAssignedTargetingOptions

列出为广告系列指定的各种定位类型定位选项。

patch

更新现有广告系列。