基本概念

本页简要介绍了 Google Ad Manager API 的架构,并介绍了 Ad Manager 中的一般概念和术语。

API 架构

以下图表简单地介绍了 Ad Manager API 中的主要类,以及各个类之间的关系:

Ad Manager 架构中的主要对象。

订单

Order 对象包含有关订单的一般信息(如货币或销售人员),并且包含一个或多个 LineItem 实例。在代码中,每个 LineItem 保留其所属 Order 的 ID,而不是 Order 保留 LineItem 对象列表。

LineItem

LineItem 对象描述了要展示广告的一组要求,包括广告的展示方式和时间、应展示的广告素材尺寸以及展示顺序(顺序、加权或根据效果)、这些广告的优先级,以及描述费用结构的许多属性。LineItem 包含一个 InventoryTargeting 对象(描述它可定位的 AdUnit 和 Placement 对象),以及可选的其他 Targeting 子类对象(表示地理位置、自定义或其他条件)。

LineItemCreativeAssociation

LineItemCreativeAssociation(通常称为 LICA)将一个 LineItem 关联到一个 Creative。订单项可与多个广告素材相关联,根据您的帐号类型,您也许可以将一个广告素材与多个订单项相关联。在您创建 LineItemCreativeAssociation 时,Ad Manager 首先会检查广告素材和订单项是否兼容;例如,如果它们的尺寸不同,则您在尝试创建或更新关联时会收到错误消息。该对象还可让您替换关联的 LineItem 中的某些值,如开始/结束日期或尺寸(如果您的广告素材与订单项指定的尺寸不太一致,而您愿意让 Ad Manager 来调整广告素材的尺寸,使其适合正在投放的广告单元)。LICA 不会在 Ad Manager 界面中显示,它们是 API 惯例。

广告素材

Creative 表示实际广告。如果广告由 Ad Manager 托管,则此对象包含实际的图片字节、Flash 文件或存储在 Ad Manager 服务器上的自定义 HTML 代码;如果广告素材托管在第三方网站上,则此广告素材是从第三方服务器发送请求的网址或 HTML 代码段。

Inventory 定位和定位子类

InventoryTargeting 对象会列出与特定 LineItem 相关联的广告单元。您可以使用相应 Targeting 子类的其他实例来指定其他可选的定位条件。

展示位置

Placement 对象是一个或多个 AdUnit 对象的集合。

AdUnit

AdUnit 表示一个或多个页面上的广告位置。AdUnit 可以是 LineItem 的 InventoryTargeting 对象的目标,也可以是 Placement 对象的目标。AdUnit 对象包含尺寸、ID 和唯一名称。ID 用于标识 API 中的其他 AdUnit 对象;名称用作 HTML 代码中的唯一标识符,以标识特定的 AdUnit 对象,并作为网页请求的一部分发送回 Ad Manager。