广告单元和代码生成

广告单元是指在同一段AdSense广告代码的作用下显示出来的一组广告。如您所期望的那样,您可以使用AdSense Host API来创建、删除、修改和更新广告单元,从而对您的广告单元资源进行全面管理。您还可以生成在网站上展示广告所需的广告代码。

广告单元定义尺寸、颜色、字体和角样式。利用广告单元,托管商还可以创建渠道以进行效果跟踪。这两个概念应用于不同的阶段:前一个应用于广告单元创建阶段,后一个应用于代码生成阶段。

广告单元样式

创建广告单元时,可对以下各项进行自定义:

  • 尺寸
  • 类型
  • 自定义样式:颜色、角和字体
  • 备用选项
  • 移动设置(WAP)

尺寸

尺寸由类似于SIZE_728_90的字符串来表示,其中第一个整数代表宽度,最后一个整数代表高度。请注意,尺寸的种类有限,因此请查看AdSense网站上的最新列表。

示例广告单元1 示例广告单元2
图1:不同的广告单元尺寸

类型

网页上可展示的广告类型包括文字广告、图片广告或富媒体广告等。

类型可以是TEXTTEXT_IMAGEIMAGELINK。图片广告并不一定能支持所有的格式(尺寸),因此请查看AdSense帮助页面中的最新列表。

自定义样式

自定义样式会替换广告单元和所显示广告的默认颜色、字体和其他外观属性。

"customStyle": {
  "colors": {
    "border": "800040",
    "title": "0000CC",
    "background": "FFFDFD",
    "text": "1F1F1F",
    "url": "008000"
  },
  "corners": "VERY_ROUNDED"
  "font": {
    "family": "ACCOUNT_DEFAULT_FAMILY",
    "size": "ACCOUNT_DEFAULT_SIZE"
  }
}

目前还无法将已保存的样式应用于广告单元,因此必须对自定义样式进行完整的定义,而且还需要定义角(SQUARESLIGHTLY_ROUNDEDVERY_ROUNDED)、字体集(ACCOUNT_DEFAULT_FAMILYADSENSE_DEFAULT_FAMILYARIALTIMESVERDANA)以及字体大小(ACCOUNT_DEFAULT_SIZEADSENSE_DEFAULT_SIZESMALLMEDIUMLARGE)。

略圆和很圆的角
图2:略圆和很圆的角样式

备用选项

当Google没有提供定位广告时,您可以定义一个备用选项进行展示,以避免影响您的原有布局。备用选项可以是空白区域、纯色区域或已实施的HTML页面的网网址。

移动设置

利用移动设置,您可以配置一些项目,比如要用于WAP设备的标记语言或脚本语言。

完整阅读

要深入了解上述这些属性的定义方法,请参阅Adunits文档页中的“资源表示法”。要了解这些概念的详细说明,请访问AdSense帮助页面

代码生成

完成广告单元的创建后,需要运用一小段JavaScript代码将广告展示在网页上。该代码段是通过API并使用getAdCode方法生成的:

GET https://www.googleapis.com/adsensehost/v4.1/accounts/accountId/adclients/adClientId/adunits/adUnitId/adcode

帐户ID为发布商的ID,该ID必须由托管商从关联会话阶段(更具体地说是令牌验证步骤中)记录下来。

请注意,要创建广告单元,需要广告客户端ID。展示内容广告所需的产品代码为“AFC”。该代码可能已为您生成,因此,请列出您的广告客户端以确定您的广告客户端ID。

有了帐户ID、广告客户端ID和广告单元的ID后,现在便可生成代码。生成的AFC产品的结构包含一段代码,您需要将这段代码放到相关网页的HTML代码中。此JavaScript代码如下所示:

<script type="text/javascript"><!--
google_ad_client = "ca-pub-654321";
google_ad_host = "ca-host-pub-7654321";
/* my ad unit */
google_ad_slot = "123456";
google_ad_width = 200;
google_ad_height = 200;
//--></script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js"></script>

请注意,此代码已定义了宽度和高度,因此,在调整尺寸时,必须重新生成该代码。另外,请注意,该代码必须保存在托管商端,并且不会在每次展示广告时重新生成。

自定义渠道

在AdSense Host API中,自定义渠道(托管商自定义渠道!)在代码生成时与广告单元相关联。getAdCode方法可以通过名为hostCustomChannelId的可选参数进行调用。该字段包含在已生成的代码中,因此,每当对广告单元添加或删除自定义渠道时,都必须重新生成该字段。

<script type="text/javascript"><!--
google_ad_client = "ca-pub-654321";
google_ad_host = "ca-host-pub-654321";
google_ad_host_channel = "123456789";
/* my ad unit */
google_ad_slot = "123456";
google_ad_width = 200;
google_ad_height = 200;
//--></script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js"></script>

多个自定义渠道可跟踪一个广告单元的效果,而一个自定义渠道也可跟踪多个广告单元。

发送以下问题的反馈:

此网页
AdSense Host API
AdSense Host API