广告
申请广告豁免 申请广告豁免的步骤如下： 存储包含在 PolicyTopicEntry （存储在 PolicyFindingDetails 中）中的所有可忽略的政策主题，这些主题是在您首次尝试更改广告失败时返回的。 发送 mutate 请求，以再次创建或更新广告，其中包含存储的可忽略政策主题。 在本指南中，我们将制作一个自适应搜索广告作为示例。申请豁免的步骤对
完整资料目录
共 1986 份资料 · 第 5 / 20 页
关键字
为关键字申请豁免 如需申请关键字豁免，请执行以下操作： 存储 PolicyViolationDetails 中包含的所有可豁免的政策违规键，这些键会在您首次尝试创建关键字失败时返回。 发送 mutate 请求，通过添加存储的可豁免政策违规键来再次创建关键字。 注意 ： 如果您的关键字包含不可豁免的政策违规，则 无法按照以下步骤申请豁免。您必须修改关键字文本，
政策免检请求
政策免检请求 通过提交豁免申请，您可以自动提交对触发 违规政策 的关键字和广告的审核申请。 以下是一些可以使用此功能的示例： 您的广告包含一些通常被认为不寻常的标点符号，但符合您所在行业的标准。 您广告组中的某个关键字包含医学术语，但您或您的用户认为您对该术语的使用符合 Google Ads 政策，因此需要进一步审核。 当您发送请求来更改（创建或更新）存在政
访问权限级别
访问权限级别和最低功能要求 Google Ads API 具有与 开发者令牌 关联的 访问权限级别 ，并通过应用审核流程授予各种访问权限级别。在将应用投入生产环境之前，请务必规划并获取正确的访问权限级别。 一种常见的情况是，您的应用开发最初采用的是 探索者访问权限级别 ，但随着时间的推移，其配额限制无法满足需求。此时，您应申请 基本访问权限级别 或 标准访问
日志记录
日志记录 日志记录和监控功能可协同工作，帮助您了解和优化应用性能，以及诊断错误和系统相关问题。您应针对所有 API 调用启用 摘要日志 ，并针对失败的 API 调用启用 详细日志 ，以便在需要 技术支持 时提供 API 调用日志。 客户端库日志记录 Google Ads API 客户端库附带内置的日志记录功能。如需了解特定于平台的日志记录详情，请参阅所选客户
高效管理数据
高效管理数据 许多 Google Ads 应用的核心功能是检索账号数据，以用于数据分析、客户查询和政策合规性检查等用例。在提取数据时，您应优化使用情况，以免 Google 服务器过载，或面临速率限制的风险。如需了解详情，请参阅有关 速率限制 和保持 最新的联系电子邮件地址 的指南。 了解 Google 的报告资源使用政策 注意 ： 此部分内容涉及 Googl
监控
监控 性能优化首先要确定关键指标，这些指标通常与延迟时间和吞吐量有关。添加监控功能以捕获和跟踪这些指标，可以发现应用中的薄弱环节。借助指标，您可以进行优化，以提升效果指标。 此外，许多监控工具还允许您为指标设置提醒，以便在达到特定阈值时收到通知。例如，您可以设置提醒，以便在失败请求的百分比比正常水平增加超过 x % 时收到通知。监控工具可帮助您了解正常性能是
概览 · 将应用投入生产
概览 开发应用后，您需要将其部署到生产环境中，以供日常业务使用。我们收集了几条建议，以帮助您的应用顺利扩容其操作，同时避免常见错误。 安全性和访问权限级别 保护凭据 管理您的 API 访问权限级别 监控和日志记录 启用日志记录 启用监控功能 处理数据 缓存数据 处理速率限制 操作建议 使用共享别名 及时更新申请 下一页 安全凭据 arrow_forward
速率限制
速率限制 Google Ads API 会按每个客户帐号的客户 ID (CID) 和开发者令牌的每秒查询次数 (QPS) 对速率限制请求进行分桶处理，这意味着要分别针对 CID 和开发者令牌强制执行计量。Google Ads API 使用 令牌 桶 算法对请求进行计量，并确定适当的 QPS 限制，因此，确切的限制会因任意 给定时间的服务器总负载而异。 实施速
安全凭据
保护您的凭据 本指南将介绍如何确保应用和用户凭据的安全。 完成 OAuth 应用验证 Google Ads API 的 OAuth 2.0 范围属于 受限范围 ，这意味着您应先完成 OAuth 应用验证流程，然后再将应用投入生产环境。如需了解详情，请参阅 Google Identity 文档 、 有关未经验证的应用的帮助中心文章 ，以及有关 设置 OAuth
共享别名
共享别名 在使用 Google Ads API 时，有多个位置会使用电子邮件地址来管理联系信息和访问权限，其中最重要的是： Google Ads API 联系电子邮件地址 ：这是 Google Ads 界面 API 中心中列为联系人的电子邮件地址。 Google Cloud 控制台账号电子邮件地址 ：此电子邮件地址具有对用于 OAuth 2.0 应用的 Go
持续更新
及时了解 Google Ads API 的最新动态 Google Ads API 会经常变更，您应及时更新应用。 API 版本和弃用 Google Ads API 通常每年有三个主要版本和三个主要版本弃用。同时会积极维护三个主要版本，并且会针对每个新的主要版本停用早期版本。您应努力定期升级应用。如需了解详情，请参阅我们的 版本政策 。 您可以在 客户端库首页
区分大小写
区分大小写 通过 Google Ads 查询语言，您可以使用一系列 不同的运算符。按字符串值过滤时，默认情况为 每个运算符的敏感度将在 过滤搜索结果。 运算符 区分大小写 = 或 != 区分大小写 （非）IN 区分大小写 （非）赞 不区分大小写 包含 (...) 区分大小写 REGEXP_MATCH （可选） 要点 ：默认情况下， REGEXP_MATCH
查询实战宝典
查询实战宝典 本指南提供了一组 Google Ads 查询语言查询，用于演示如何返回与 Google Ads 界面中的屏幕相同的数据，以及如何查找地理位置常量。您可以直接使用这些查询，也可以将它们用作起点来构建自己的自定义查询。 如需查看将常见界面术语和预定义报告映射到 API 资源的汇总表，请参阅 Google Ads 界面中的报告 。 注意 ：请注意以下
日期范围
日期范围 借助 Google Ads 查询语言，您可以通过以下方式指定日期范围： 自定义日期范围 预定义日期范围 预定义的时间段 自定义日期范围 您可以采用 ISO 8601 扩展格式 ( YYYY-MM-DD ) 或基本格式 ( YYYYMMDD ) 指定日期，例如： segments . date BETWEEN '2024-01-01' AND '20
查询语法
Google Ads 查询语言语法 ondemand_video 视频：验证查询 此页面包含 Google Ads 查询语言的语法参考。如需详细了解查询结构，请参阅 查询结构 。 以下是 Google Ads 查询语言的语法参考（采用正则表达式表示法）： Query -> SelectClause FromClause WhereClause ? Order
对结果进行排序和限制
对结果排序 您可以使用 ORDER BY 子句指定响应中的行顺序，该子句由一个或多个以英文逗号分隔的以下序列组成： FieldName ( 'ASC' | 'DESC' ) ? 如果您没有在字段名称的后面指定 ASC 或 DESC ，那么 Google Ads API 将默认使用 ASC 。 以下 ORDER BY 子句会按展示次数的降序和广告系列名称的升序
Google Ads 查询语言
Google Ads 查询语言 提示 ： 使用 交互式查询构建器 构建和验证 GAQL 查询。 主要术语 资源 Google Ads 中的实体，例如 campaign 或 ad_group 。 Segment 用于对数据进行分组的维度，例如 segments.date 或 segments.device 。 如果 SELECT 子句中包含细分，并且还包含指标
查询结构
查询结构 提示 ： 使用 交互式查询构建器 构建和验证 GAQL 查询。 您可以将针对资源、细分和指标字段的查询发送到 GoogleAdsService Search 或 SearchStream 方法。要使用 Google Ads 查询语言构建查询，您需要使用 语言语法 。如需大致了解 Google Ads 查询语言，请参阅 Google Ads 查询语言
覆盖面预测 · 优化广告
覆盖面预测 重要提示 ： 此功能仅适用于已加入允许名单的账号。如果您需要使用此功能，请与您的 Google 代表联系。 ReachPlanService 使媒体代理机构和第三方媒体规划软件公司能够准确预测视频广告系列在 YouTube 和 Google 视频合作伙伴上的商业覆盖面。媒体规划师可以使用此服务来回答以下问题： 在 YouTube 上投入多少资金才
身份验证
Authentication 重要提示 ：此功能仅适用于已加入许可名单的账号。如果您需要使用此功能，请与您的 Google 代表联系。 对 ReachPlanService 的请求必须提供已获批的开发者令牌、OAuth 凭据以及您的 OAuth 凭据可以访问的客户 ID。 本指南介绍了与 ReachPlanService 相关的身份验证详细信息。如果您尚未完
概念
概念 重要提示 ：此功能仅适用于已加入许可名单的账号。如果您需要使用此功能，请与您的 Google 代表联系。 对于给定的媒体策划方案， ReachPlanService 会生成覆盖您的受众群体所需的费用预测。媒体规划由以下要素构成：人口统计定位、广告系列投放时长、设备类型，以及分配给各种广告格式的一组预算。该预测是一条曲线，显示了在预算不断增加的情况下覆盖
生成曲线
生成覆盖面曲线 重要提示 ：此功能仅适用于已加入允许名单的账号。如果您需要使用此功能，请与您的 Google 代表联系。 收集媒体方案的定位设置和产品组合后，您可以使用 GenerateReachForecast method in ReachPlanService 生成预算与潜在覆盖面的曲线。如需详细了解请求字段，请参阅 术语表 和 媒体方案 指南 。 *
指定媒体策划方案
指定媒体策划方案 重要提示 ：此功能仅适用于已加入允许名单的账号。如果您需要使用此功能，请与您的 Google 代表联系。 Google 提供了多种产品和受众群体，供您用来构建广告系列，但您可能不知道如何制定计划。为了帮助您解决这个问题， ReachPlanService 提供了发现方法 您可以使用这些方法 生成曲线 。 受众群体定位 媒体计划的第一个组成部
优化和建议
优化得分和建议 ondemand_video 视频：深入探究 建议 可以通过以下几种方式提升广告系列的效果： 推出新的相关功能 通过改进出价、关键字和广告，让您的预算发挥更大效用 提升广告系列的整体效果和效率 如需提高优化得分，您可以使用 RecommendationService 检索建议，然后根据需要采纳或拒绝这些建议。您还可以使用 Recommenda
自定义受众群体
自定义受众群体 自定义受众群体 可让您 通过输入相关关键字、网址和应用来覆盖理想受众群体。它是将之前的两个可自定义产品/功能（ 自定义意向 和 自定义兴趣相似的受众群体 ）迁移到一套简化的辅助性受众群体产品工作流程中。 在展示广告系列、需求开发广告系列、Gmail 广告系列、视频广告系列和效果最大化广告系列中，您可以通过添加与您的产品或服务相关的特定关键字、
开始使用目标客户匹配 · 管理受众群体
开始使用目标客户匹配 借助目标客户匹配功能，您可以利用您的线上及线下数据，在搜索网络、“购物”标签页、Gmail、YouTube 和展示广告网络上覆盖和重新吸引客户。目标客户匹配功能利用客户与您分享的信息，将广告定位到相应客户及其他类似客户。您可以 批量上传客户关系管理 (CRM) 数据、添加或移除 数据，或者使用这些用户列表创建 logical_user_
管理
管理客户名单 如需了解客户名单更新、移除和报告，请参阅本指南。 注意 ： 自 2026 年 4 月 1 日起，大多数新的目标客户匹配集成都必须使用 Data Manager API 。符合条件的现有集成可以继续使用 Google Ads API 来管理客户名单。 使用 OfflineUserDataJobService 更新列表 创建客户名单并设置定位后，最
排查问题
排查客户名单问题 本指南可帮助您排查目标客户匹配集成中可能出现的匹配率偏低问题和常见错误。 验证匹配率 请确保上传作业已完成，然后再尝试验证匹配率。 匹配率可能因多种原因而低于预期，包括： 数据在上传之前未经过哈希处理。 数据在经过哈希处理之前格式不正确。 您正在与另一个系统中的匹配率进行比较。 您正在尝试向单个 UserIdentifier 对象添加多个用
细分受众群入门指南
开始使用细分受众群 细分受众群（也称为用户名单）是指 Google 预估的具有特定兴趣、意向或受众特征信息的人群。展示广告系列、搜索广告系列、视频广告系列、酒店广告系列和标准购物广告系列支持细分受众群定位。您可以在广告组和广告系列一级定位或排除细分受众群。 如果您想为效果最大化广告系列或需求开发 广告系列定位细分受众群，请参阅受众群体 指南 。 详细了解细分
相似细分受众群
相似细分受众群 您可以使用相似细分受众群，定位与第一方受众群体名单中的受众群体相似且具有相同特征的受众群体，从而扩大覆盖面。相似细分受众群是指与现有种子名单中的用户具有共同特征的用户群。种子名单以您的第一方数据为基础构建而成，例如购买过指定商品或使用过特定服务的客户名单。借助相似细分受众群，您可以与具有相似特征的潜在新客户建立联系。 重要提示 ： 相似细分受
多用户名单
多个用户名单 您可以组合使用两个或多个现有用户名单，以实现更精细的定位。 创建用户列表 您可以构建现有用户名单的自定义组合，作为具有 UserListLogicalRuleInfo 字段的 logical_user_list 。 logical_user_list 中的规则是 AND 的，因此用户必须与每个规则匹配才能被视为在列表中。不过，每条规则都允许您指
创建用户列表
创建用户名单 您可以在再营销广告系列中使用用户名单，重新吸引在您的网站或应用上执行过特定操作的用户。Google Ads API 支持多种类型的用户名单。本指南侧重于介绍如何创建基于规则的用户列表。 基于规则的用户名单 使用 flexible_rule_user_list 构建的基于规则的用户列表可以包含多条规则。每条规则都由 UserListRuleInf
场景
场景 假设您有一个网站，您已在该网站中配置了多个自定义再营销代码参数，以捕获用户的以下属性： event - 您网站上的网页类别，例如结账、购物车等。 cartsize - 用户购物车中的商品数量。 checkoutdate - 用户退房的日期。只有在用户实际完成购买时，您才需要设置此参数。 您希望对已经将多个商品放入购物车并开始结账过程的用户进行更多的展示
创建规则项组
创建规则项目组 此示例会创建两个规则项组。 创建第一个 rule_item_group 首先，创建第一个 rule_item_group ，它包含两个 rule_item 字段或 UserListRuleItemInfo 对象： 访问过结账页的用户。 购物车中有多个商品的用户。 第一个规则项使用具有字符串值的 ecomm_pagetype 参数，因此您必须先
执行过特定操作的访问者
执行了特定操作的访问者 您可以将在您的网站上采取了具体操作的用户填充到受众群体名单。如果您使用转化跟踪，则可以将广告定位到之前在您的网站上触发过转化的用户（例如完成过购买交易的用户）。 此外，您还可以将广告定位到在您的网站上采取了 未 归入转化的特定操作的用户，如某人将某商品添加到购物车，但随后又删除而没有购买。 前提条件 如需创建和定位目标受众群体细分，您
特定网页的访问者
特定网页的访问者 您可以使用 flexible_rule_user_list 将广告定位到访问过您网站的特定网页或版块的用户，这样您就可以定位比网站网域更具体的网址。 前提条件 如需创建和定位目标受众群体细分，您首先需要： 查看 针对用户兴趣和地理位置投放广告的政策 。 有关用户的敏感信息不能用于创建受众群体。 设置 Google 代码。 如果广告客户希望根
您网站的访问者
您网站的访问者 最简单的细分受众群类型就是您网站的访问者。 前提条件 如需创建和定位目标受众群体细分，您首先需要： 查看 针对用户兴趣和地理位置投放广告的政策 。 有关用户的敏感信息不能用于创建受众群体。 设置 Google 代码。 如果广告客户希望根据移动应用行为创建用户名单，则应实现 Firebase SDK 或使用第三方 SDK 来跟踪应用内行为。 检
受众群体
创建和管理受众群体 一个 Audience 是一个可重复使用的集合，其中包含重点 细分受众群、受众特征定位和排除对象。 效果最大化广告系列和需求开发广告系列支持受众群体定位。 如果您 想在展示广告系列、搜索广告系列、视频广告系列、酒店广告系列或 标准购物广告系列中直接定位细分受众群，请前往 细分受众群 。 创建受众群体 使用 AudienceService
开始使用受众群体管理
开始使用受众群体管理 您可以创建和定位 受众群体 和 细分受众群 ，根据用户的身份、兴趣和习惯、他们正在积极调研的对象或者与贵商家互动的方式来吸引他们。 使用您的数据 后，您可以在之前访问过您网站、使用过您移动应用的用户或数据库（例如 目标客户匹配 ）中的用户访问其他网站或在 Google 上进行搜索时，向他们展示相关广告。 功能 Audience 细分受众
条件指标
条件指标 在 Google Ads API 中，每种条件报告都由单独的资源表示。 除非另有必要，否则 *_view 资源仅包含 resource_name 字段。 如果需要提取任何特定于条件的数据，则 Google Ads API 客户端必须指定对应的 ad_group_criterion 或 campaign_criterion 字段。 这样一来，Goog
使用场景
常见使用场景示例 此用例按广告系列总结了账号在过去 30 天内的效果，并按设备进行了细分。此报告的查询如下所示： SELECT campaign . name , campaign . status , segments . device , metrics . impressions , metrics . clicks , metrics . ctr ,
标签
标签 您可以使用标签对广告系列、广告组、广告和关键字进行分类， 并以各种方式使用这些类别来简化工作流程。 本指南介绍了执行以下操作所需的步骤： 使用 LabelService 以编程方式创建标签。 使用 CampaignLabelService 请求为广告系列分配标签。 使用 GoogleAdsService 查询按标签检索和过滤报告结果。 本指南重点介绍了
概览 · 生成报告并监控效果
报告 ondemand_video 视频：观看 2019 年研讨会上的报告主题演讲 效果数据报告是 Google Ads API 应用不可或缺的一部分。借助此 API 灵活的报告选项，您可以获取所有 资源 的效果数据，包括从整个广告系列到可触发广告的一组关键字等所有内容。 本指南介绍了创建查询并向 Google Ads API 提交查询以获取数据所需的步骤。
Paging
将结果分页 您可以使用 GoogleAdsService.Search 对检索到的结果进行分页，而不是一次下载整个结果集。如需大致了解如何使用 Google Ads API 生成报告，请参阅 报告指南 。 结果以页面形式返回，每页最多包含 10,000 行。如果未在请求中设置 page_size ，则默认值为 10,000。如果 page_size 设置为大
跟踪广告展示位置和效果
跟踪广告展示位置和效果 Google Ads API 提供了多个视图来分析广告的展示位置和效果，包括 managed_placement_view 、 group_placement_view 和 detail_placement_view 。每个视图都从不同的角度展示了展示位置数据。 managed_placement_view 显示内容 ： 此视图提供按
分割
分割 Google Ads 界面中提供了一个单独的菜单，用于进行细分。您可以通过向查询添加适当的字段，在 Google Ads API 中实现细分。例如，假设您向查询添加了 segments.device 。这样一来，系统就会生成一份报告，其中包含一个行，用于显示设备 和 FROM 子句 中指定资源的每种组合，以及 在它们之间 拆分的统计值（展示次数、点击次
流式传输
使用 GoogleAdsService 报告流式传输 如需检索 Google Ads API 实体和报告数据，请使用以下方法之一： GoogleAdsService.SearchStream GoogleAdsService.Search 以下是这两种方法的主要区别： GoogleAdsService.SearchStream GoogleAdsServic
界面中的报告
Google Ads 界面中的报告 Google Ads 界面提供报告功能。如需创建报告，请登录您的 Google Ads 账号。点击左侧的 广告系列 ，然后点击 数据洞察和报告 。如需从头开始创建报告，请点击 报告编辑器 。 本指南将 Google Ads 界面中的常见报告概念和命名惯例与您可以使用 Google Ads 查询语言 (GAQL) 和 Goo
将 ValueTrack 参数与报告字段相关联
将 ValueTrack 参数与报告字段进行映射 ValueTrack 参数是您可以添加到广告着陆页网址的 网址参数 。这类参数会收集有关广告点击来源的信息。如果您要详细了解有关广告点击的信息，或者如果您刚开始使用跟踪功能，则最好使用这些参数。 启用 自动标记 后，系统会自动向每个网址添加 Google 点击标识符 (GCLID)，以便日后将广告点击与报告中
零指标
零指标 搜索结果中的零指标 执行查询时，您可能会遇到零指标的实体。可能的原因如下： 这些实体不符合展示条件。 系统可能已在该报告的日期范围内暂停这些实体。 您往往需要通过查询结果获取有关广告系列效果的信息。在这种情况下，零指标可能并不是您所想要的。要生成更有用的报告，您可以明确排除零指标。 使用谓词排除零指标 谓词是一个求值结果为 TRUE 、 FALSE
制作广告
制作自适应展示广告 与其他广告一样，广告制作也是使用 AdGroupAdService.MutateAdGroupAds 完成的。然后，您可以将此自适应展示广告添加到 标准展示广告系列 中。 广告制作 要制作自适应展示广告，您需要填充 ResponsiveDisplayAdInfo 的以下必填字段： marketing_images square_marke
检索广告
获取自适应展示广告 要获取您已制作的自适应展示广告，请调用 GoogleAdsService.SearchStream 方法 查询过滤广告类型 RESPONSIVE_DISPLAY_AD 。 例如： SELECT ad_group . id , ad_group_ad . ad . id , ad_group_ad . ad . responsive_dis
自适应展示广告
自适应展示广告 提示 ：已在使用自适应展示广告？了解 升级为效果最大化广告系列 的好处。 自适应展示广告是根据 Google 展示广告网络中的一组素材资源（图片、标题、广告内容描述等）生成的。 自适应展示广告 的主要功能包括： 您可以上传素材资源，Google 将使用机器学习模型确定展示广告的最佳组合。 您可以为每种素材资源类型上传多个素材资源。Google
制作广告
制作自适应搜索广告 您可以在下方查看代码示例，了解如何制作自适应搜索广告。与其他广告一样，广告制作是通过使用 AdGroupAdService.MutateAdGroupAds 完成的。 ResponsiveSearchAdInfo 至少需要三个标题、至少两条广告内容描述和至少一个最终到达网址。 Java // Copyright 2025 Google L
检索广告
获取自适应搜索广告 如需检索您已制作的自适应搜索广告，请调用 GoogleAdsService.SearchStream 方法，并使用将广告类型过滤为 RESPONSIVE_SEARCH_AD 的查询。例如： SELECT ad_group . id , ad_group_ad . ad . id , ad_group_ad . ad . responsiv
自适应搜索广告
自适应搜索广告 使用自适应搜索广告在 Google 广告网络 上宣传产品。通过 自适应搜索广告 的主要功能，您可以： 设置三个或更多标题和两条或更多广告内容描述，它们会自动在广告中轮流显示，以确定哪个标题和广告内容描述效果最好。 将您希望使用的标题和广告内容描述固定下来，以便广告始终显示该标题和广告内容描述。 收集标题和广告内容描述不同组合的效果统计信息，以
制作广告
制作购物广告组广告 为标准购物广告系列制作购物产品广告包含以下两个步骤： 创建一个 ShoppingProductAdInfo 对象，并将其设置为新 Ad 对象的 shopping_product_ad 字段。 创建一个 AdGroupAd ，并将 ad 字段设置为之前创建的 Ad 对象。 此代码示例演示了如何为标准购物广告系列制作 SHOPPING_PRO
制作广告组
创建购物广告组 要为购物广告系列投放广告，您必须创建 AdGroup 。 标准购物广告系列支持 SHOPPING_PRODUCT_ADS 广告组类型。这是购物广告系列的默认广告组类型，用于投放标准产品广告。您可以通过提供广告组 type 字段对其进行设置。 标准购物广告系列可以包含多个广告组，每个广告组至少包含一个广告。 此代码示例演示了如何为标准购物广告系
制作广告系列
制作购物广告系列 实施购物广告的第一步是制作购物广告系列。 通过购物广告系列，用户可以查看各种展示产品图片的广告，包括名称、价格、商店名称等。在制作购物广告系列时，您需要为其设置预算、出价策略和购物设置。 在制作购物广告系列之前，您需要 将 Google Ads 账号与 Google Merchant Center 账号相关联 。关联账号后，您可以在指定购物
创建商品详情组
创建购物信息组 通过购物信息组，您可以对产品进行分组。 在界面中，这称为 产品组 。您可以使用多个维度进行分组，以便包含或排除产品。 分组时，请考虑使用这样的树状结构：在第一级，将产品按条件划分为全新、二手和其他产品条件；然后在第二级，将其他产品条件中的产品按品牌划分为“CoolBrand”产品、“CheapBrand”和其他品牌。 树状结构中的每个节点要么
关联 Merchant Center
已关联的 Merchant Center 账号和 Google Ads 账号 Google Merchant Center 是一款实用工具，可帮助您将自己的商店数据和商品数据上传到 Google，并用在购物广告和其他 Google 服务中。将 Merchant Center 账号与 Google Ads 账号相关联后，您的商品数据就可以传送到 Google
购物广告
购物广告 提示 ： 您是否已在使用购物广告？了解 升级为效果最大化广告系列 的好处。 购物广告是以介绍特定销售产品详情为主要内容的一种广告类型。这些广告可用于推广您的在线和本地产品目录，增加您的网站的流量或本地店面的人流量，以及寻找更优质的潜在客户。 详细了解购物广告 。 在制作购物广告之前，您必须先将产品提交到 Google Merchant Center
报告 · 购物广告
报告 与其他广告类型一样，您可以使用 GoogleAdsService.SearchStream 来检索购物商品的商品状态和效果数据。 支持 Google Merchant Center Feed 中商品的广告系列具有以下专用报告： 购物广告效果视图 Product Group View 素材资源组商品组视图 购物产品 注意 ： “购物广告效果视图”和“购物
创建广告组和广告组广告
创建广告组和广告组广告 本文档介绍了如何创建广告组，以及如何创建属于广告组的广告。 创建广告组 与之前步骤中创建的 Campaign 类似， 此广告组需要最少的配置，因为它会自动进行优化 。 智能广告系列广告组的主要要求： 一个智能广告系列只能有一个广告组。 type 必须设置为 AdGroupTypeEnum.SMART_CAMPAIGN_ADS 。 在此
创建预算
创建预算 以下示例展示了如何构建 MutateOperation ，以针对智能广告系列创建新的 CampaignBudget 。此操作将与创建智能广告系列所需的其他实体一起用于单个 mutate 请求中。 要点 ： 我们建议您在创建此预算时，使用在上一步中从 SmartCampaignSuggestService 检索到的预算金额微单位。 智能广告系列预算的
创建广告系列条件
创建广告系列条件 在 获取建议 中，我们演示了如何使用字词或短语检索一组 KeywordThemeConstant 对象。在此步骤中，我们将使用相同的关键字主题常量来创建一组 CampaignCriterion 对象，供智能广告系列定位。 与 创建预算 时使用 SmartCampaignSuggestService 建议的预算金额类似，我们建议您根据从 Ge
制作广告系列和设置广告系列
制作智能广告系列和智能广告系列设置 智能广告系列依赖于名为 SmartCampaignSetting 的资源，该资源包含主 Campaign 资源中没有的其他配置选项。 智能广告系列设置必须与广告系列相关联，因此最好在同一变动请求中创建这两个对象。 制作广告系列 由于智能广告系列主要由 Google 的广告技术自动管理，因此您无需为其设置许多字段。 智能广告
获取建议
获取关键字主题、预算和广告文字素材资源建议 Google Ads API 会公开 SmartCampaignSuggestService ，以便在制作智能广告系列时建议配置详细信息。它会使用所宣传商家的详细信息（以 SmartCampaignSuggestionInfo 实例的形式）来建议关键字主题、预算金额，以及各个广告的标题和广告内容描述。 创建 Sma
发送 mutate 请求
发送 mutate 请求 现在，我们已经了解了如何为创建新的智能广告系列所需的各个实体创建 mutate 操作，接下来可以将这些操作合并为一个请求，以便一次性创建所有实体。 使用单个 mutate 请求的好处包括： 由于这些实体不共享且高度依赖彼此，因此降低了复杂性。 防止因任何原因导致其中一项操作失败时出现孤立实体。 使用临时资源名称在单个请求中创建实体（
智能广告系列
智能广告系列 智能广告系列 旨在帮助小型企业在网上吸引更多客户。它们只需极少的设置和维护。智能广告系列以 Google 最尖端的广告技术为后盾，可以根据您的商家详情和目标（比如吸引客户来电、光顾实体店或在您的网站上采取特定操作）自动优化广告系列。 制作广告系列 智能广告系列的制作工作流程需要执行一些与其他广告系列类型不同的步骤。最佳做法是在单个 Google
报告 · 智能广告系列
报告 与其他广告系列类型一样，您可以使用 GoogleAdsService.SearchStream 检索智能广告系列的属性和效果指标。 智能广告系列指标可通过 campaign 资源获取，而特定搜索字词的指标可通过 smart_campaign_search_term_view 资源获取。在 smart_campaign_search_term_view
出价调节系数
出价调节系数 利用出价调节系数，您无需更改广告系列或广告组的定位条件，即可针对特定条件调整出价。例如，针对移动设备的广告组出价调节系数不会排除其他类型的设备的展示次数，但可让您提高或降低针对移动设备展示的出价。 如需详细了解出价的工作原理以及如何设置出价调节系数，请参阅我们的 出价指南 。 广告系列出价调节系数 您可以使用 CampaignBidModifi
条件
条件 定位条件可以在三个不同的级别设置： 广告系列级。 广告组级。 在 客户 级别。 注意 ： 客户级条件只能是否定条件。 并非所有条件类型都可以在所有级别设置：例如，某些条件只能在广告系列级设置。 此外，某些条件只能用于排除性定位，而某些条件只能用于肯定定位。 下表介绍了所有条件类型的允许使用情况： 广告系列 广告组 客户 类型 肯定？ 否定？ 可用级别
地理位置定位
地理位置定位 本指南对地理位置定位进行了说明，并介绍了如何使用 Google Ads API 为您的广告系列添加、获取及更新地理位置定位。 如需了解定位限制，请参阅 Google Ads 账号限制简介 的“定位限制”部分。 为什么地理位置定位如此重要？ 借助地理位置定位，您可以向特定地理区域的用户投放您的广告。例如，假设您要为某个连锁超市投放广告。 如果不使
Targeting
Targeting Google Ads API 在客户、广告系列和广告组一级支持多个定位选项。根据条件类型，您可以使用 Google Ads API 执行以下操作： 在广告系列或广告组一级 定位或排除条件 。 在广告组一级 为特定条件设置绝对出价 。 在广告系列或广告组一级 修改条件的出价 。 后续步骤 详细了解 条件 。 了解 出价调节系数 。 下一页
共享集
共享集 借助共享集，您可以跨多个资源管理和共享一组条件。根据共享集的类型，可以在广告系列、广告组或账号一级应用条件。 SharedSetType 枚举用于指定您可以在 Google Ads API 中使用的共享集的类型。本指南将介绍如何使用共享集创建共享否定关键字列表并将其应用到广告系列。您可以按照相同的流程将其他类型的共享集添加到广告系列中。 创建 Sha
定位设置
定位设置 您可以在 定位设置 中 您的广告组或广告系列，指定是否缩小广告的覆盖面，使其仅面向特定细分受众群展示，或者仅在您选择的特定内容中展示。 提示 ： 本指南重点介绍定位和观察设置。如果您想了解如何为广告系列或广告组设置定位条件（例如，通过受众群体定位指定您想要覆盖的用户），请参阅 定位条件 指南和 添加广告系列定位条件 示例。 设置定位设置 您可以通过
制作广告
制作推荐活动广告组广告 制作“旅游好去处”广告包含以下两个步骤： 创建 Ad 并将其 travel_ad 设置为 TravelAdInfo 的实例。 创建 AdGroupAd 并将之前创建的 Ad 与其关联。 要点 ： 为了让广告组投放广告，您需要一个 AdGroupAd ，其 ad 已设置，且 status 为 ENABLED 。您可以在一个广告组中制作多
制作广告组
创建“活动”广告组 要为您的“推荐活动广告系列”投放广告，您必须创建一个 AdGroup ，且该广告组中至少包含一个广告。如下所示，广告系列仅支持 TRAVEL_ADS 类型的广告组，您可以在 type 字段中对此进行设置。 Java private String addAdGroup ( GoogleAdsClient googleAdsClient ,
制作广告系列
制作“推荐活动”广告系列 实施推荐活动广告的第一步是制作推荐活动广告系列。在制作广告系列时，您需要设置其预算、出价策略和 Things to do Center 账号 ID。 设置广告系列的具体步骤如下： 将广告系列的 advertising_channel_type 设置为 TRAVEL ，并将 advertising_channel_sub_type 设
创建商品详情组
创建推荐活动产品信息组 为推荐活动广告组创建产品信息组的步骤与 酒店广告 大致相同。唯一的区别是推荐活动广告 ListingDimensionInfo 中有一些额外的可用维度： ActivityCityInfo ActivityCountryInfo ActivityIdInfo ActivityRatingInfo ActivityStateInfo 上一
推荐活动广告
推荐活动广告 重要提示 ：此功能仅适用于已加入许可名单的账号。如果您需要使用此功能，请与您的 Google 代表联系。 推荐活动广告是系统根据您提供的商家信息和商品 Feed 自动制作的一种广告类型。借助此功能，您可以展示活动、游览项目和景点，从而定位旅客。 详细了解推荐活动广告 。 借助 Google Ads API 和 Google Ads ，您可以执行
报告 · 推荐活动广告
报告 推荐活动广告与酒店广告的用途类似，因此您可以参阅 酒店广告报告 了解详情。不过，与酒店广告不同的是，推荐活动广告报告的主要 *_view 资源如下： travel_activity_group_view travel_activity_performance_view 上一页 arrow_back 创建商品详情组
视频广告系列
视频广告系列 视频广告系列 可让您在 YouTube 及其他网站上投放 视频广告。 API 限制 Google Ads API 仅支持提取现有视频广告系列及其条件并生成相关报告。您无法使用 Google Ads API 制作新的视频广告系列或更新现有视频广告系列。 广告系列管理替代方案 如果您需要以编程方式制作或管理视频广告系列，请考虑以下选项： Googl
互动式查询构建工具
Google Ads Query Builder Learn about data caching and retention recommendations for the Google Ads API. The interactive Google Ads Query Language query builder is organized by th
效果最大化广告系列 · 创建和管理广告系列
效果最大化广告系列 借助 效果最大化广告系列 ，您只需制作一个统一的广告系列，即可利用所有 Google Ads 渠道和广告资源。它可以帮助您优化效果和提高工作效率，部分原因在于降低管理多个广告系列类型所需的复杂性和开销。 效果最大化广告系列会将预算动态分配给效果最佳的渠道，包括搜索网络、YouTube、展示广告网络、Google 探索、Gmail 和 Go
素材资源组报告
素材资源组级效果 除了广告系列报告之外，您还可以获取与效果最大化广告系列相关联的 asset_group 资源的报告。 素材资源组广告效力 由于效果最大化广告系列会使用附加到每个素材资源组的素材资源为该素材资源组动态生成广告，因此无法查看单个广告的效果。不过，Google Ads API 会公开 asset_group.ad_strength 字段 和 as
素材资源组信号
素材资源组信号 AssetGroupSignal 是一种信号，您可以 向 Google 提供此信号，以便在素材资源组一级优化广告投放。效果最大化广告系列会参考这些信号，寻找意向相似或更强烈的新展示机会，以在搜索网络、展示广告网络、视频平台等位置促成转化。效果最大化广告系列会将您的素材资源组信号与 Google 对消费者意向和偏好的实时理解相结合，发掘您可能未
素材资源组
效果最大化广告系列素材资源组 效果最大化广告系列的素材资源组 由您在 制作 效果最大化广告系列时添加的图片、标题、广告内容描述和视频构成。 为了优化广告效果，系统会智能地选择并组合您的素材资源，以最适合展示广告的特定 Google Ads 渠道（例如 YouTube、Gmail 或 Google 搜索）。 素材资源组无法在广告系列之间共享。每个广告系列都需要
素材资源报告
素材资源报告 您可以使用 asset_group_asset 资源检索效果最大化广告系列的素材资源效果数据。 效果主要由以下因素决定： 状态 ： primary_status 和 primary_status_reasons 字段可 全面展示素材资源是否在投放广告以及投放原因。 定量指标 ：现在，您可以在素材资源一级查看完整的效果统计信息（例如 clicks
素材资源要求
素材资源要求 效果最大化广告系列中的每个 AssetGroup 都需要一组初始的最低素材资源。这些素材资源可以是其他广告系列中使用的现有素材资源，也可以是专门用于效果最大化广告系列中 AssetGroup 的新素材资源。 如果零售效果最大化广告系列与 Google Merchant Center 相关联，则会自动生成一组 最低必需素材资源。 作为最佳实践，我
资产
效果最大化广告系列中的素材资源 效果最大化广告系列在素材资源方面有一些独特的特征。 需要有不同类型的素材资源，且数量不得少于最低要求。 素材资源 会分组到名为 AssetGroup 的集合中，这是效果最大化广告系列独有的。 有些素材资源可以通过机器学习自动生成。 提示 ： 如果您要从其他广告系列类型升级到效果最大化广告系列，可以在 Google Ads 账号
批处理
适用于效果最大化广告系列的批处理 批量处理 提供了一种将一组可能相互依赖的操作分派给多个服务的方法，而无需同步等待操作完成。您可以使用批量处理来创建和管理效果最大化广告系列。 本指南详细介绍了在进行批量处理时，效果最大化广告系列的具体情况。通用 批量处理指南 提供了有关批量处理的一般信息，而 构建请求指南 则包含有关如何构建请求以创建或管理效果最大化广告系列
广告系列条件报告
广告系列定位条件的效果 广告系列条件报告仅针对受支持的条件类型填充，您可以在 创建广告系列条件指南 中找到这些类型。 地理位置条件效果 以下示例展示了如何从 location_view 报告中查询效果最大化广告系列的位置条件数据： SELECT campaign . id , campaign . name , metrics . clicks , metr
广告系列报告
广告系列级效果 查看效果最大化广告系列的效果与 查看任何其他广告系列类型的 效果 类似。不过，您必须添加过滤条件，以 仅包含 advertising_channel_type 等于 PERFORMANCE_MAX 的广告系列。 所有效果最大化广告系列的效果 例如，以下查询会返回过去 30 天内所有效果最大化广告系列的效果。您还可以通过按 campaign.i
使用效果最大化广告系列时遇到的常见错误
使用效果最大化广告系列时遇到的常见错误 下面列出了使用效果最大化广告系列时的一些常见错误以及解决方法： 错误 AssetGroupError.NOT_ENOUGH_*_ASSET AssetGroup 未满足指定素材资源类型的最低素材资源数量要求，因此未创建。如需了解详情，请参阅 常见的素材资源组错误 。 AssetGroupError.SHORT_DESC
转化目标
广告系列级转化目标 在效果最大化广告系列中， 转化目标 有助于引导 Google 的算法优化广告投放和预算分配，使其与您选择的 广告系列出价策略 保持一致。您可以明确地将 客户目标 的 子集 应用于效果最大化广告系列。如果您未明确为广告系列设置转化目标，系统会默认使用所有客户级转化目标。 如需为效果最大化广告系列设置 广告系列转化目标 ，请按以下步骤操作：
创建预算
制定效果最大化广告系列的预算 与所有其他广告系列一样，效果最大化广告系列也需要 预算 ，但有以下限制： 预算不能 共享 。 如果使用平均每日预算，预算周期必须为 DAILY 。 如果使用广告系列总预算，预算周期必须为 CUSTOM_PERIOD 。 广告系列总预算仅适用于设置了开始日期和结束日期的广告系列。 平均每日预算最好不低于您为广告系列选择的转化操作的
创建广告系列条件
创建广告系列条件 效果最大化广告系列支持以下类型的条件： AD_SCHEDULE （ 了解详情 ） AGE_RANGE BRAND DEVICE KEYWORD LANGUAGE （ 了解详情 ）：效果最大化广告系列会根据广告系列的国家/地区代码验证定位语言。尝试定位到不受支持的语言会抛出 CriterionError.CANNOT_TARGET_LANGU