使用
部分结构化数据文件上传 功能,可简化结构化数据文件 (SDF) 管理,纳入更多资源,并缩短上传订单项结构化数据文件的时间。请参阅我们的
新指南,立即开始使用!
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
结构化数据 - v10 - 广告系列
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
如需了解格式说明,请参阅概览。
| 字段 | 必需 | 类型 | 可写入 | 说明 |
| 广告系列 ID | 仅当修改现有广告系列时才必须指定这项设置 | 整数 | 否 | 广告系列的数字 ID 值。如果留空,系统会创建一个新广告系列 ID 并为其分配唯一 ID。 (可选)创建新广告系列时,您可以使用自定义标识符为新广告系列分配订单项。 自定义标识符的格式为“ext[自定义标识符]”,例如 ext123。 待文件被上传并处理后,系统会将所有自定义标识符替换为由 DBM 分配的 ID,并会根据所用的自定义标识符将相关对象(例如订单项到广告系列)关联起来。 |
| 广告客户 ID | 是 | 整数 | 否 | 广告客户的数字 ID 值。必须是有效的现有广告客户 ID |
| 名称 | 是 | 字符串 | 是 | 条目的名称。 |
| 时间戳 | 修改现有条目时必须指定这项设置 | 整数 | 否 | 条目的时间戳,系统会使用此时间戳来验证相应条目在下载和上传期间是否未发生更改。 |
| 状态 | 是 | 字符串 | 是 | 条目的状态设置。 |
| 广告系列目标 | 是 | 字符串 | 是 | 选择一个适用的广告系列目标:- 提高用户对我品牌或产品的认知度
- 提升在线操作量或访问量
- 推动线下或实体店销售
- 吸引用户安装应用或与之互动
|
| 广告系列目标 KPI | 是 | 字符串 | 是 | 选择一个适用的广告系列目标 KPI:- 每千次展示费用
- 可见率 (%)
- CPIAVC
- 每次转化费用
- 每次点击费用
- 点击率
- 其他
|
| 广告系列目标 KPI 值 | 是 | float | 是 | 广告系列目标 KPI 的正数。对于广告系列目标 KPI“可见率 (%)”和“点击率”,请以百分比形式输入此字段的值,例如 80% 应输入为“80”。对于 KPI“其他”,此字段是对目标的简短说明。 |
| 广告素材类型 | 是 | 字符串、列表 | 是 | 您希望使用的广告素材类型列表。 |
| 广告系列预算 | 否 | float | 是 | 广告系列的正预算金额。由于预算始终是货币预算,因此始终是 float。货币将以广告客户的货币显示,单位为标准单位(而不是货币单位的 1/1,000,000) |
| 广告系列开始日期 | 是 | 字符串 | 是 | 广告系列的开始日期,格式为 MM/DD/YYYY HH:mm |
| 广告系列结束日期 | 否 | 字符串 | 是 | 广告系列的结束日期,格式为 MM/DD/YYYY HH:mm |
| 已启用频次上限 | 是 | 字符串 | 是 | 启用/停用广告系列中基于展示次数的频次上限。 |
| 频次曝光次数 | 当“已启用频次上限”为“TRUE”时,此字段为必填项 | 整数 | 是 | 给定频次金额的展示次数的正整数金额,即“在 y 期间展示 x 次”中的 x。 |
| 频次期限 | 当“已启用频次上限”为“TRUE”时,此字段为必填项 | 字符串 | 是 | 指定频次上限的时间段单位。 |
| 频次金额 | 当“已启用频次上限”为“TRUE”时,此字段为必填项 | 整数 | 是 | 频次期限类型的时长正整数金额,即“在 y 期间展示 x 次”中的 y。
频次上限时间期限不得超过 30 天。 |
| 广告系列预算期 | 否 | 字符串、列表的列表 | 是 | 广告系列的预算期集。列表格式 = (ID; Name; Type; Amount; Start Date; End Date; External Budget Source; External Budget ID; Invoice Grouping ID; Prisma Client Code; Prisma Product Code; Prisma Estimate Code; Prisma Type; Supplier;)。示例 '(; My Budget; IMPRESSIONS; 234; 01/01/2020 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId; Client; Product; Estimate; DISPLAY; MySupplier;)',其中未提供 ID 和结束日期。 下表提供了可接受的值: | 列名称 | 必需 | 说明 |
|---|
| ID | 否 | 广告系列预算期的唯一 ID。修改预算期时必须提供此 ID。如果留空,预算期将写入为新预算期。 | | 名称 | 是 | 广告系列预算期的显示名称。 | | 类型 | 是 | 预算金额的类型。 可接受的值为: | | 金额 | 是 | 预算类型的正预算金额。这可以是简单的整数展示次数值,也可以是货币金额的 float。货币将以广告客户的货币显示,单位为标准单位(而不是货币单位的 1/1,000,000)。 | | 开始日期 | 否 | 预算期的广告投放期开始日期的时间戳,格式为 MM/DD/YYYY HH:mm。未设置的开始日期以空白字段值表示。 | | 结束日期 | 否 | 预算期的广告投放期结束日期的时间戳,格式为 MM/DD/YYYY HH:mm。未设置的结束日期以空白字段值表示。 | | 外部预算来源 | 是 | 预算期的来源。 可接受的值为: | | 外部预算 ID | 仅适用于 Mediaocean 预算期 | 如果设置了此 ID,则针对此预算期投放的所有展示次数都将在账单中包含此 ID(如果客户已选择启用预算期级结算)。 | | 账单分组 ID | 否 | 如果设置了此 ID,则具有相同外部预算 ID 和账单分组 ID 的所有预算期都将汇总到一张账单中(如果客户已选择启用预算期级结算)。 | | Prisma 客户端代码 | 仅适用于 Mediaocean 预算期 | 只能针对 Mediaocean 预算期进行设置。Google 支付中心支持按此字段进行搜索和过滤。 | | Prisma 产品代码 | 仅适用于 Mediaocean 预算期 | 只能针对 Mediaocean 预算期进行设置。Google 支付中心支持按此字段进行搜索和过滤。 | | Prisma 估算代码 | 仅适用于 Mediaocean 预算期 | 只能针对 Mediaocean 预算期进行设置。Google 支付中心支持按此字段进行搜索和过滤。 | | Prisma 类型 | 仅适用于 Mediaocean 预算期 | 只能针对 Mediaocean 预算期进行设置。预算期的 Prisma 类型。可接受的值为: | | Prisma 供应商 | 仅适用于 Mediaocean 预算期 | 只能针对 Mediaocean 预算期进行设置。分配给此预算的实体(DSP、网站等) |
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2026-06-02。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2026-06-02。"],[],[]]