Reminder: v201702 will be sunset on February 28, 2018.

基本概念

本页概述了 DFP API 的架构,并介绍了 DFP 广告管理系统(以下简称 DFP)中的一般概念和术语。

API 架构

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

DFP 架构中的主要对象。

Order

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

LineItem

LineItem 对象描述了广告展示方面的一系列要求,包括广告应如何及何时展示、所展示广告素材的尺寸和展示顺序(按顺序、权重或效果)、这些广告的优先级,以及很多描述费用结构的属性。LineItem 包含一个 InventoryTargeting 对象(用于描述该订单项可定位到的 AdUnitPlacement 对象)以及其他的可选 Targeting 子类对象(代表地理位置条件、自定义条件或其他条件)。

LineItemCreativeAssociation

LineItemCreativeAssociation(通常称为 LICA)用于将一个 LineItem 与一个 Creative 相关联。订单项可与多个广告素材相关联,并且根据您的帐号类型,您也许可以将一个广告素材与多个订单项相关联。在您创建 LineItemCreativeAssociation 时,DFP 首先会检查广告素材和订单项是否兼容;例如,如果它们的尺寸不同,则您在尝试创建或更新此关联时就会看到错误消息。通过此对象,您还可以在关联的 LineItem 中替换一些值,如开始日期/结束日期或尺寸(如果您的广告素材不太符合订单项指定的尺寸,但您愿意让 DFP 即时调整此广告素材的尺寸以适应广告单元)。LICA 不会在 DFP 界面中显示,它们属于 API 层面的类。

Creative

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

InventoryTargeting 和 Targeting 子类

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

Placement

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

AdUnit

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

发送以下问题的反馈:

此网页
DoubleClick for Publishers
DoubleClick for Publishers
需要帮助?请访问我们的支持页面