本页简要介绍了 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。