Campaign Manager 360 API v3.5 已被弃用,并将于 2023 年 4 月 20 日停用。所有用户都必须在该截止日期之前迁移到新版 API。

概览

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Campaign Manager 360 是一个面向广告客户和代理机构的网页版广告管理系统。该系统提供了丰富多样的广告投放管理工具,可用于管理广告素材和投放广告系列。此页面简要介绍了 Campaign Manager 360 API 的“广告投放管理”部分,并说明了 Campaign Manager 360 中使用的常规概念和术语。

API 架构

下图概要显示了广告投放管理中使用的主要资源以及它们之间的相互关系。

API 实体关系图

广告投放管理资源

帐号

Account 资源代表着客户旗下广告投放相关资源的集合,每个帐号都包含有单个 Campaign Manager 360 客户的所有设置和配置。虽然有些大型客户可能有多个帐号,但大多数客户只有一个帐号。每个帐号负责管理自己的用户个人资料和权限;对于要用来发出 API 请求的各个帐号,您必须有一份用户个人资料以及相应的权限。

Campaign Manager 360 用户可以通过 Campaign Manager 360 帮助中心详细了解如何管理帐号。

网站

Campaign Manager 360 拥有一个名为网站目录的全局性网站列表,其中包含的条目记录了每个网站的联系信息、允许使用的媒体类型、定价以及其他信息。您必须将此网站目录中的网站添加到您 Campaign Manager 360 帐号的本地列表(称为 Sites)中。如果您想添加到本地列表的某个网站不在该网站目录中,您可以使用 DirectorySites 服务将其添加到此列表中。

Campaign Manager 360 用户可以通过 Campaign Manager 360 帮助中心详细了解如何管理网站。

广告客户

Advertiser 资源表示要展示广告的单个广告客户。对于作为广告代理机构的 Campaign Manager 360 客户,其帐号中往往有多个广告客户资源;而自行管理 Campaign Manager 360 帐号的广告客户可能只有一个资源。当同一个帐号中有多个广告客户时,为了方便起见,可将这些广告客户归到 AdvertiserGroups 中。

Campaign Manager 360 用户可以通过 Campaign Manager 360 帮助中心详细了解如何管理广告客户。

Floodlight 配置

FloodlightConfiguration 资源涵盖用于控制 Floodlight 如何跟踪广告客户转化情况的所有设置。这些设置包括回溯期、标准变量和自定义变量,以及代码设置。

在大多数情况下,广告客户与 Floodlight 配置之间存在着严格的一一对应关系。不过,在某些情况下,多个广告客户可以共用同一个配置。通过这种方式共用配置可在广告客户之间建立父级-子级关系。

Campaign Manager 360 用户可以通过 Campaign Manager 360 帮助中心详细了解如何管理 Floodlight 配置。

Floodlight 活动

FloodlightActivity 资源表示您要跟踪的具体用户操作。Floodlight 活动的属性包括所跟踪操作的类型以及应如何统计记录的转化次数。

一个 Floodlight 活动只能指定一个 Floodlight 配置,但单个配置可能与多个活动相关联。此外,每个 Floodlight 活动还必须与一个 FloodlightActivityGroup 关联,后者用于在报表中整理活动。

Campaign Manager 360 用户可以通过 Campaign Manager 360 帮助中心详细了解如何管理 Floodlight 活动。

着陆页

AdvertiserLandingPage 资源表示当用户点击某个广告后在浏览器中看到的网页。它们在广告客户一级定义,并在所有关联的广告系列、广告和广告素材中共享。一个着陆页只能分配给 1 个广告客户,但单个广告客户可与多个着陆页关联。

Campaign Manager 360 用户可以通过 Campaign Manager 360 帮助中心详细了解着陆页。

广告系列

Campaign 资源包含单个广告客户的一组广告和展示位置。广告系列指定默认的着陆页,具有开始日期和结束日期,并包含一些其他全局设置。一个广告系列只能分配给 1 个广告客户,但单个广告客户可与多个广告系列关联。

Campaign Manager 360 用户可以通过 Campaign Manager 360 帮助中心详细了解如何管理广告系列。

展示位置

Placement 资源表示网站上的一块固定广告空间。该资源定义广告可以投放的位置、广告的实际尺寸、定价信息以及其他主要属性。每个展示位置都关联到一个或多个广告。

您可以选择将展示位置归到 PlacementGroups 中。这些组可用于描述同一网页上的一组展示位置(称为包版),也可用于描述跨多个网页的一组展示位置(称为打包)。

Campaign Manager 360 用户可以通过 Campaign Manager 360 帮助中心详细了解展示位置属性。

Ad 资源最常用于将广告素材关联到展示位置。该资源包含以下基本属性:包含广告的展示位置的尺寸、广告是否处于有效状态,以及广告的开始时间和结束时间等。在最简单的情况下,广告表示广告素材与展示位置之间的一对一关系。不过,广告还可用于将多个广告素材关联到单个展示位置(称为广告素材轮播),或者将单个广告素材关联到多个展示位置。

虽然广告最主要的用途是将广告素材投放到展示位置,但有些类型的广告会被用于跟踪点击次数和展示次数。Campaign Manager 360 用户可以通过 Campaign Manager 360 帮助中心了解详情。

广告素材

Creative 是一种封装容器,用于封装展现广告内容的一个或多个文件。大多数广告素材都是图形素材(包含图片或视频),但也有更复杂的类型,例如用于弹出式广告素材或纯文字跟踪广告素材的 HTML 代码。

广告素材只能指定给单个广告客户使用,但可以通过广告与该广告客户的多个广告系列相关联。尽管某些广告素材类型支持灵活尺寸,但一般来说广告素材的尺寸必须与引用该广告素材的广告相同。

Campaign Manager 360 用户可以通过 Campaign Manager 360 帮助中心详细了解如何管理广告素材。

广告素材资源

CreativeAsset 是广告素材使用的源文件。该资源可以是图片、视频,还可以是包含 HTML5 素材资源的 ZIP 文件等。一个素材资源只能分配给 1 个广告客户,但可与该广告客户名下的多个广告素材关联。

Campaign Manager 360 用户可以通过 Campaign Manager 360 帮助中心详细了解广告素材资源。