paidAndorganic 报告可显示触发过您的广告在 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 |
用户在输入 searchQuery 后点击广告的次数。 | 指标 | Integer |
是 |
organicClicks |
用户在输入 searchQuery 后,您网站的非付费搜索结果获得的点击次数。 | 指标 | Integer |
是 |
paidAndOrganicClicks |
用户在输入 searchQuery 后,点击您的某个广告或您网站的非付费搜索结果的次数。 | 指标 | Integer |
是 |
paidImpressions |
用户在输入搜索查询后,广告在搜索结果页或 Google 广告网络网站上展示的次数。 | 指标 | Integer |
是 |
organicQueries |
用户输入 searchQuery 并至少看到您网站上一条自然搜索结果的总次数。 | 指标 | Integer |
是 |
paidAndOrganicQueries |
用户输入 searchQuery 并看到您的至少一个广告或您网站中的至少一个自然搜索结果的总次数。 | 指标 | Integer |
是 |
paidCtr |
广告的点击率,即用户在输入 searchQuery 后,看到您的广告并最终点击广告的频率。 | 指标 | Number |
是 |
organicCtr |
显示看到您网站的非付费搜索结果的用户最终点击非付费结果并进入您网站的比率。 | 指标 | Number |
是 |
paidAndOrganicCtr |
是指在看到您的某个广告或您网站的非付费搜索结果的用户中,点击其中任一广告或进入您网站的比率。 | 指标 | Number |
是 |
paidAvgPos |
用户输入 searchQuery 后广告获得的平均排名。 | 指标 | 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 |
是 |