本页简要介绍了 Google Ad Manager API 的架构,并介绍了 Ad Manager 中的一般概念和术语。
API 架构
以下图表简单地介绍了 Ad Manager API 中的主要类,以及各个类之间的关系:
订单
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。