此页提供了一些表格,其中列出了可用的维度和指标及其相应的说明。
维度
注意:CODE
和ID
用于编程,而NAME
用于显示给最终用户,可以本地化。
维度 | 说明 |
---|---|
AD_CLIENT_ID | 广告客户的ID。示例:ca-pub-088712 。 |
AD_FORMAT_CODE | 广告格式的代码。示例:text 、image 、html 。 |
AD_FORMAT_NAME | 广告格式的名称。示例:Text 、Image 或Rich Media 。最后一个值表示html格式。 |
AD_UNIT_CODE | 广告单元的代码。该值不必在多个广告客户之间保持唯一。示例:837572 。 |
AD_UNIT_ID | 广告单元的唯一ID。示例:ca-pub-088712:837572 。 |
AD_UNIT_NAME | 广告单元的名称。 |
AD_UNIT_SIZE_CODE | 广告单元的尺寸代码。示例:720x42 或mobile_single 。 |
AD_UNIT_SIZE_NAME | 广告单元的尺寸名称。示例:720x42 或Single (Mobile) 。 |
BID_TYPE_CODE | 出价类型。示例:cpc 、cpm 。 |
BID_TYPE_NAME | 出价类型名称。示例:CPC bids 、CPM bids 。 |
BUYER_NETWORK_ID | 向您网站发送广告的广告联盟的ID。 |
BUYER_NETWORK_NAME
| 向您网站发送广告的广告联盟的名称。示例:Google Adwords 。 |
COUNTRY_CODE | CLDR地区代码。示例:US 、FR 。 |
COUNTRY_NAME | 地区名称。示例:United States 、France 。 |
CUSTOM_CHANNEL_CODE | 自定义渠道的代码。 |
CUSTOM_CHANNEL_ID | 自定义渠道的ID。 |
CUSTOM_CHANNEL_NAME | 自定义渠道的名称。 |
DATE | 日期,采用YYYYMMDD 格式。 |
DOMAIN_NAME | 域名。 |
MONTH | 月份,采用YYYYMM 格式。 |
PLATFORM_TYPE_CODE | 广告平台类型的代码。示例:HighEndMobile 、Desktop 。 |
PLATFORM_TYPE_NAME | 广告平台类型的名称。示例:High-end mobile devices 、Desktop 。 |
PRODUCT_CODE | 产品代码。示例:AFC 、AFS 。 |
PRODUCT_NAME | 产品代码。示例:AdSense for Content 、AdSense for Search 。 |
TARGETING_TYPE_CODE | 定位类型代码。示例:Keyword 、WebSite 、Publisher 。 |
TARGETING_TYPE_NAME | 定位类型名称。示例:Contextual 、Reservation 、Publisher 。 |
URL_CHANNEL_ID | 网址渠道的ID。 |
URL_CHANNEL_NAME | 网址渠道的名称。 |
WEEK | 一周第一天的日期,采用YYYYMMDD 格式。 |
指标
注意:单位以字符串形式返回。
指标 | 说明 | 单位 |
---|---|---|
AD_REQUESTS | 请求了广告(针对内容广告)或搜索查询(针对搜索广告)的广告单元的数量。一个广告请求可带来零次、一次或更多次广告展示,具体取决于广告单元的尺寸以及广告的可用情况。 | 整数 |
AD_REQUESTS_COVERAGE | 所请求的广告单元或查询与返回到网站的广告单元或查询的数量的比值。 | 小数(0-1) |
AD_REQUESTS_CTR | 产生点击的广告请求所占的比率。 | 小数(0-1) |
AD_REQUESTS_RPM | 每一千个广告请求的收入。计算方法:用估算收入除以广告请求数,再乘以1000。 | 小数 |
CLICKS | 用户点击标准内容广告的次数。 | 小数 |
COST_PER_CLICK | 用户每次点击您的广告时您所获得的金额。每次点击费用的计算方法:用估算收入除以所获得的点击次数。 | 小数。请参阅响应中的标头,了解相关货币。 |
EARNINGS | 发布商的估算收入。请注意,到昨天为止的所有收入都是准确的,而更近的收入是估算收入,因为可能受网络垃圾或汇率波动的影响。 | 小数。请参阅响应中的标头,了解相关货币。 |
INDIVIDUAL_AD_IMPRESSIONS | 单个广告在您网站上展示的次数。广告格式不同,展示的广告数量也有所不同。例如,一个竖幅中可能包含2个或更多广告。此外,广告单元中的广告数量都不是固定的,具体取决于广告单元展示的是标准文字广告、独占型文字广告还是图片广告。 | 整数 |
INDIVIDUAL_AD_IMPRESSIONS_CTR | 单个广告的展示次数中带来点击的展示次数所占的比率。 | 小数(0-1) |
INDIVIDUAL_AD_IMPRESSIONS_RPM | 广告的每千次展示收入。计算方法:用估算收入除以单个广告展示次数,再乘以1000。 | 小数 |
MATCHED_AD_REQUESTS | 展示了广告的广告单元数(针对内容广告)或触发广告进行展示的搜索查询数(针对搜索广告)。每个为网站至少获取一个广告的广告请求都计为一次匹配广告请求。 | 整数 |
MATCHED_AD_REQUESTS_CTR | 产生点击的匹配查询所占的比率。 | 小数(0-1) |
MATCHED_AD_REQUESTS_RPM | 每一千次匹配查询的收入。计算方法:用您的估算收入除以匹配的查询数,再乘以1000。 | 小数 |
PAGE_VIEWS | 网页浏览量。 | 整数 |
PAGE_VIEWS_CTR | 单个网页的浏览量中带来点击的浏览量所占的比率。 | 小数(0-1) |
PAGE_VIEWS_RPM | 每千次网页浏览量的收入。计算方法:用您的估算收入除以网页浏览量,再乘以1000。 | 小数 |
兼容性
通过AdSense Management API中的元数据调用,您可以获取可用的维度和指标列表、查看这些维度和指标之间的兼容性以及找出所支持的产品。
metadata.dimensions
此类调用的响应与下面的类似:
[{ "kind": "adsense#reportingMetadataEntry", "id": "EXAMPLE_DIMENSION", "compatibleDimensions": [ "1", "2", "4", ... ], "compatibleMetrics": [ "AD_REQUESTS", "AD_REQUESTS_COVERAGE", "AD_REQUESTS_CTR", ... ], "supportedProducts": [ "AFMC", "AFC", "AFV" ] }, ...]
compatibleDimensions
字段会显示代表一组兼容维度的列表,其中的每个项目都是整数。由于这些兼容维度之间没有一对一的关系,因此他们会以组的形式表示。如果两个维度在它们的compatibleDimensions
列表中有一个或多个组是相同的,这两个维度就可以相互兼容。compatibleMetrics
字段列出了兼容指标的ID。supportedProducts
字段包含与该维度相兼容的产品代码。
metadata.metrics
该响应与metadata.dimensions的响应类似:
compatibleDimensions
是维度ID的列表,而不是数字的列表。- 没有
compatibleMetrics
字段。指标之间的兼容性取决于所使用的维度。 supportedProducts
列出了与该指标相兼容的产品代码。