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_ACTIVE、ENTITY_STATUS_ARCHIVED 和 ENTITY_STATUS_PAUSED。
  • 对于 campaigns.create 方法，不允许使用 ENTITY_STATUS_ARCHIVED。
updateTime

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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 提升在线操作量或访问量。

PerformanceGoal

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

JSON 表示法 
{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}
字段
performanceGoalType

enum (PerformanceGoalType)

必需。效果目标的类型。
联合字段 performance_goal_value。必需。与给定 performance_goal_type 对应的效果目标值。performance_goal_value 只能是下列其中一项：
performanceGoalAmountMicros

string (int64 format)

目标金额，以广告客户币种的微单位表示。

当 performanceGoalType 为以下值之一时，适用此字段：

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_VCPM

例如，1500000 表示 1.5 个标准货币单位。
performanceGoalPercentageMicros

string (int64 format)

以微单位表示的目标百分比的十进制表示形式。

当 performanceGoalType 为以下值之一时，适用此字段：

  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_CLICK_CVR
  • PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
  • PERFORMANCE_GOAL_TYPE_VTR
  • PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
  • PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE

例如，70000 表示 7%（小数形式为 0.07）。
performanceGoalString

string

关键绩效指标 (KPI) 字符串，可以为空。必须采用 UTF-8 编码，长度不得超过 100 个字符。

当 performanceGoalType 设置为 PERFORMANCE_GOAL_TYPE_OTHER 时适用。

PerformanceGoalType

可能的效果目标类型。

枚举
PERFORMANCE_GOAL_TYPE_UNSPECIFIED 此版本中未指定或未知效果目标类型。
PERFORMANCE_GOAL_TYPE_CPM 效果目标以每千次展示费用 (CPM) 为单位设置。
PERFORMANCE_GOAL_TYPE_CPC 效果目标以每次点击费用 (CPC) 为单位设置。
PERFORMANCE_GOAL_TYPE_CPA 效果目标以每次转化费用 (CPA) 为单位设置。
PERFORMANCE_GOAL_TYPE_CTR 效果目标以点击率 (CTR) 百分比表示。
PERFORMANCE_GOAL_TYPE_VIEWABILITY 效果目标以可见度百分比表示。
PERFORMANCE_GOAL_TYPE_CPIAVC 效果目标设置为 CPIAVC（播放完毕时可听可见的展示的平均费用）。
PERFORMANCE_GOAL_TYPE_CPE 效果目标以每次互动费用 (CPE) 为单位设置。
PERFORMANCE_GOAL_TYPE_CPV 效果目标以每次观看费用 (CPV) 为单位设置。
PERFORMANCE_GOAL_TYPE_CLICK_CVR 效果目标以点击转化率（每次点击带来的转化次数）百分比表示。
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR 效果目标以展示转化率（每次展示带来的转化次数）百分比表示。
PERFORMANCE_GOAL_TYPE_VCPM 效果目标以每千次可见展示费用 (vCPM) 为单位设置。
PERFORMANCE_GOAL_TYPE_VTR 效果目标以 YouTube 观看率（每次展示的 YouTube 观看次数）百分比表示。
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE 效果目标以音频完整播放率（每次展示的完整音频收听次数）百分比表示。
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE 效果目标以视频完整播放率（每次展示的完整视频观看次数）百分比表示。
PERFORMANCE_GOAL_TYPE_OTHER 效果目标设置为“其他”。

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)

必需。广告系列预算的日期范围。关联的预算细分可能具有不同的日期范围。它们是根据父级广告客户的时区来确定的。

startDate 和 endDate 都必须在 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 Payments 中心支持按此代码的组成字段进行搜索和过滤。

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

string

Prisma 客户端代码。
prismaProductCode

string

Prisma 产品代码。
prismaEstimateCode

string

Prisma 估算代码。

方法

create

 创建一个新广告系列。

delete

 永久删除广告系列。

get

 获取宣传活动。

list

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

listAssignedTargetingOptions

 列出广告系列在各种定位类型中分配的定位选项。

patch

 更新现有广告系列。