如何查找Google Ads Script方法名及对应Google Ads报表字段名

一、字段对应Method名称查询方法 #

• 所有对象的可用方法都可以在Google Ads脚本官方参考文档中按对象层级查询：
  • 基础对象（账户、广告系列、广告组、关键词、广告等）都有独立的方法列表，你需要先确认你拉取的对象类型，再对应查找get前缀的取值方法
  • 你所需的常用字段对应方法如下：
    • 账户维度：AdsApp.currentAccount().getName()（账户名）、AdsApp.currentAccount().getCustomerId()（客户ID）、AdsApp.currentAccount().getCurrencyCode()（货币）
    • 父级对象维度：keyword.getCampaign().getName()（广告系列名称）、keyword.getCampaign().getType()（广告系列类型）、keyword.getCampaign().getSubtype()（广告系列子类型）、keyword.getAdGroup().getName()（广告组名称）
    • 统计维度：所有统计指标都在getStatsFor(日期范围)返回的Stats对象中，对应方法为getClicks()（点击）、getImpressions()（曝光）、getCost()（成本）、getConversions()（转化）、getVideoThroughConversions()（视频贯穿转化）、getVideoQuartile25Rate()（视频播放25%占比）、getVideoQuartile50Rate()（视频播放50%占比）、getVideoQuartile75Rate()（视频播放75%占比）、getVideoQuartile100Rate()（视频播放100%占比）、getVideoViews()（视频观看量）

注意：你当前代码拉取的是关键词对象，无法直接获取广告名称字段，若需要Image ad name（图片广告名称），需要将拉取对象从AdsApp.keywords()更换为AdsApp.ads()，再调用ad.getName()获取广告名称。

二、过滤条件正确字段名查询方法 #

• 所有withCondition支持的过滤字段都可以在Google Ads脚本的过滤参考文档中按对象类型查找，你当前需要替换的Campaign Type正确字段名为CampaignType，过滤视频广告系列的条件修改为：

.withCondition("CampaignType = 'VIDEO'")

即可正常生效。

三、代码优化提示 #

你当前表头定义了19个字段，但遍历写入数组时仅插入了3个值，需要按照表头顺序对应补全所有字段的取值方法，否则会出现数组长度不匹配的报错。

内容的提问来源于stack exchange，提问作者Fresh Analyst