付费和自然搜索报告会显示触发 Google 展示广告和/或触发 Google 针对您的网站显示非付费(自然)搜索结果的搜索字词。如果您已为要针对其生成报表的引擎帐号设置了付费搜索和自然搜索报表,则该报表只会返回结果。
此报告只能通过异步请求(即通过 Reports.request() 方法)返回。
请求摘录
请发送常规 Reports.request() 请求正文,但指定 "reportType": "paidAndOrganic"
。
{ ... "reportType": "paidAndOrganic", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
针对您要在报告中返回或过滤的每列,指定下表中列出的 columnName
。您还可以选择指定 headerText、startDate 和 endDate。
请注意,某些列无法过滤;请参阅下表中的“可过滤”。
columnName | 说明 | 行为 | 类型 | 可过滤 |
---|---|---|---|---|
agency |
代理机构名称。 | 特性 | String |
兼容 |
agencyId |
DS 代理机构 ID。 | 特性 | ID |
兼容 |
advertiser |
广告客户名称。 | 特性 | String |
兼容 |
advertiserId |
DS 广告客户 ID。 | 特性 | ID |
兼容 |
account |
引擎帐号名称。 | 特性 | String |
兼容 |
accountId |
DS 引擎帐号 ID。 | 特性 | ID |
兼容 |
accountEngineId |
外部引擎帐号中的帐号 ID。 | 特性 | String |
兼容 |
accountType |
引擎帐号类型:Google AdWords 、Bing Ads 、Yahoo Japan Listing Ads 、Yahoo Search Marketing 、Yahoo Gemini 、Baidu 或 Comparison Shopping 。 |
特性 | Engine type |
兼容 |
searchQuery |
Google 用户输入的搜索字词。 | 特性 | String |
兼容 |
serpType |
Google 用户点击的搜索结果的类型。 可能的值包括:
|
特性 | SERP type |
兼容 |
paidClicks |
用户在输入搜索查询后点击广告的次数。 | 指标 | Integer |
兼容 |
organicClicks |
用户进入 searchQuery 后,网站上的非付费搜索结果获得的点击次数。 | 指标 | Integer |
兼容 |
paidAndOrganicClicks |
显示用户在输入 searchQuery 后点击某个广告或访问您网站的非付费搜索结果的次数。 | 指标 | Integer |
兼容 |
paidImpressions |
用户输入搜索查询后,在搜索结果页或 Google 广告网络网站上展示的次数。 | 指标 | Integer |
兼容 |
organicQueries |
用户进入 searchQuery 并看到至少一条来自您网站的自然搜索结果的总次数。 | 指标 | Integer |
兼容 |
paidAndOrganicQueries |
用户进入 searchQuery 并看到了您网站上的至少一个广告或至少一条自然搜索结果的总次数。 | 指标 | Integer |
兼容 |
paidCtr |
广告的点击率,即用户在输入搜索查询后最终点击广告的频率。 | 指标 | Number |
兼容 |
organicCtr |
用户在看到您网站的非付费搜索结果后,点击非付费搜索结果并转到您网站的比率。 | 指标 | Number |
兼容 |
paidAndOrganicCtr |
用户在看到您的某个广告或您网站的非付费搜索结果后,点击其中之一并登录您网站的比率。 | 指标 | Number |
兼容 |
paidAvgPos |
广告在用户输入搜索查询后出现的平均排名。 | 指标 | Number |
兼容 |
organicAvgPos |
您网站的非付费搜索结果的平均最高排名。 | 指标 | Number |
兼容 |
paidCostPerClick |
广告的平均每次点击费用。这是指每次有人点击您的广告时,您需要支付的平均费用。 | 指标 | Money |
兼容 |
date |
按天细分报告;每行及其汇总指标被拆分为多行,每天一行。此列返回每行的日期。 | 细分 | Date |
兼容 |
monthStart |
按月份细分报表;每行及其汇总指标会被拆分成多行,每行一个。此列会返回每行在当月的第一天。 | 细分 | Date |
兼容 |
monthEnd |
按月份细分报表;每行及其汇总指标会被拆分成多行,每行一个。此列会返回每行所在的月份的最后一天。 | 细分 | Date |
兼容 |
quarterStart |
按季度对报告进行细分;每一行及其汇总指标均分为多行,每季度一行。此列返回每行所在季度的第一天。 | 细分 | Date |
兼容 |
quarterEnd |
按季度对报告进行细分;每一行及其汇总指标均分为多行,每季度一行。此列返回每行所在季度的最后一天。 | 细分 | Date |
兼容 |
weekStart |
按周(周日至周六)细分报表;每行及其汇总指标会被拆分成多行,每周一行。此列返回每行的第一天(星期日)。 | 细分 | Date |
兼容 |
weekEnd |
按周(周日至周六)细分报表;每行及其汇总指标会被拆分成多行,每周一行。此列返回每行的最后一天(星期六)。 | 细分 | Date |
兼容 |
yearStart |
按年对报表进行细分;每一行及其汇总指标会被拆分成多行,每行对应一年。此列返回每行年份的第一天。 | 细分 | Date |
兼容 |
yearEnd |
按年对报表进行细分;每一行及其汇总指标会被拆分成多行,每行对应一年。此列返回每行年份的最后一天。 | 细分 | Date |
兼容 |
campaign |
按广告系列细分报表;每行及其汇总指标会被拆分为多行,一行对应一个报表范围内的广告系列。此列会返回广告系列名称。 | 细分 | String |
兼容 |
campaignId |
按广告系列细分报表;每行及其汇总指标会被拆分为多行,一行对应一个报表范围内的广告系列。此列会返回相应的 DS 广告系列 ID。 | 细分 | ID |
兼容 |
adGroup |
按广告组对报告进行细分;每行及其汇总指标会被拆分为多行,一行对应报告范围内的一个广告组。此列会返回相应的广告组名称。 | 细分 | String |
兼容 |
adGroupId |
按广告组对报告进行细分;每行及其汇总指标会被拆分为多行,一行对应报告范围内的一个广告组。此列会返回相应的 DS 广告组 ID。 | 细分 | ID |
兼容 |
keywordId |
按关键字细分报表;每行及其汇总指标会被拆分为多行,一行对应一个报表范围内的关键字。此列会返回相应的 DS 关键字 ID。 | 细分 | ID |
兼容 |
keywordMatchType |
按关键字细分报表;每行及其汇总指标会被拆分为多行,一行对应一个报表范围内的关键字。此列会返回关键字匹配类型。 | 细分 | Match type |
兼容 |
keywordText |
按关键字细分报表;每行及其汇总指标会被拆分为多行,一行对应一个报表范围内的关键字。此列会返回关键字文字。 | 细分 | String |
兼容 |