您可以使用 Display & Video 360 API 检索 YouTube 及合作伙伴订单项、其广告组和广告素材资源,以及与 YouTube 及合作伙伴广告投放相关的定位条件。YouTube 及合作伙伴资源和定位只能通过界面创建或更新。
本页介绍了如何使用 Display & Video 360 API 识别 YouTube 和合作伙伴资源并检索相关定位条件,以及如何在界面中使用结构化数据文件 (SDF) 批量创建和更新 YouTube 和合作伙伴资源。
确定 YouTube 及合作伙伴资源
YouTube 及合作伙伴资源包含特定类型的订单项、广告组和广告。
订单项
具有以下 LineItemType 值的订单项是 YouTube 及合作伙伴订单项,无法创建或更新:
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTIONLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIOLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACHLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCYLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
可以从 LineItem 资源的 youtubeAndPartnersSettings 字段检索特定于 YouTube 及合作伙伴订单项的设置。
YouTube 广告组和广告
YouTube 广告组和广告是 YouTube 及合作伙伴订单项下的子资源,可用于进一步指定。
一个 YouTube 及合作伙伴订单项可以包含多个AdGroup资源,每个资源都有自己的其他定位条件和出价策略。每个 AdGroup 资源下可以有多个相同广告格式的 AdGroupAd 资源,每个资源都有自己的广告素材信息和其他跟踪网址列表。
检索定位
用于投放 YouTube 及合作伙伴广告的定位条件是在广告客户级、订单项级和广告组级分配的。
从父资源继承的 YouTube 及合作伙伴定位条件不会反映在子资源的定位设置中,这与非 YouTube 及合作伙伴资源的标准相同。
如需检索与投放 YouTube 及合作伙伴广告相关的所有定位条件,您必须执行以下操作:
- 使用
advertisers.listAssignedTargetingOptions检索分配给其父级广告客户的定位条件, - 使用
advertisers.lineItems.bulkListAssignedTargetingOptions检索分配给其父订单项的定位条件, - 并使用
advertisers.adGroups.bulkListAssignedTargetingOptions检索分配给其父广告组的定位条件。
尝试修改 YouTube 定位条件
与 YouTube 及合作伙伴资源一样,您无法使用 Display & Video 360 API 修改 YouTube 及合作伙伴定位。任何尝试修改以下定位条件的行为都会返回错误:
- 在以下任一定位类型的任何层级分配的定位条件:
TARGETING_TYPE_SESSION_POSITION、TARGETING_TYPE_YOUTUBE_CHANNEL和TARGETING_TYPE_YOUTUBE_VIDEO。 - 分配给 YouTube 及合作伙伴订单项资源的定位条件。
- 分配给
AdGroup资源的定位条件。
使用 SDF 界面上传功能创建和更新
虽然您无法使用 Display & Video 360 API 创建或更新 YouTube 和合作伙伴资源,但可以使用通过 Display & Video 360 界面上传的结构化数据文件 (SDF) 批量创建或更新 YouTube 和合作伙伴订单项、广告组和广告。
这些资源在 SDF 中通过订单项、YouTube 广告组和 YouTube 广告文件格式表示。
您可以使用 Display & Video 360 API 生成并下载结构化数据文件。修改现有行以更改现有资源,或添加新行以创建新资源,然后通过 Display & Video 360 界面上传更新后的文件。