版本说明

本页提供了 Campaign Manager 360 API 的版本说明。

版本 4

新功能

• 添加了以下服务：

  服务
  广告客户账单
  结算分配
  结算资料
  结算费率

• 添加了以下字段：

  资源	字段
  Conversion	impressionId
  Placements	activeStatus
  PlacementGroups	activeStatus

• 为该 API 的版本 4 添加了以下枚举值：

  资源	字段	新值
  Placements	TagWrappingMode	MONITORING_READ_ONLY

• 为该 API 的所有版本添加了以下枚举值：

  资源	字段	新值
  ChangeLogs	ObjectType	OBJECT_ADVERTISER_CUSTOMER_LINK
  MobileApps	Directory	ROKU_APP_STORE AMAZON_FIRETV_APP_STORE PLAYSTATION_APP_STORE APPLE_TV_APP_STORE XBOX_APP_STORE SAMSUNG_TV_APP_STORE ANDROID_TV_APP_STORE GENERIC_CTV_APP_STORE
  Placements	TagWrappingMode	TRACKING VIDEO_PIXEL_MONITORING

已停用

• 移除了以下字段：

  资源	字段
  Campaigns	nielsenOcrEnabled traffickerEmails 已归档
  Placements	已归档
  PlacementGroups	已归档

已知问题

• 插入或更新转化时，每项转化都必须在 encryptedUserId、encryptedUserIdCandidates[]、matchId、mobileDeviceId、gclid 和 dclid 中指定 1 个（不能多也不能少）用户标识符。

  • 虽然以往版本中已有说明，从 v4 开始，该问题会被严格验证。

• 插入转化时，每项转化都必须指定 quantity 字段的值（例如 1）。

  • 在以往版本中，若不指定数量，该值则默认为 0，这可能会导致汇总转化次数为 0。
  • 更新转化时，必须填写 quantity 字段。

版本 3.5

新功能

• 添加了以下字段：

  资源	字段
  Placements	wrappingOptOut
  Placements	partnerWrappingData
  VideoSettings	durationSeconds
  Advertisers	measurementPartnerLink
  Campaigns	measurementPartnerLink

• 为该 API 的所有版本添加了以下枚举值：

  资源	字段	新值
  CreativeAssets	WarnedValidationRule	CLICK_TAG_IN_RICH_MEDIA

已停用

• 移除或替换了以下字段：

  资源	字段	已替换为
  Campaigns	adBlockingConfiguration.creativeBundleId adBlockingConfiguration.clickThroughUrl adBlockingConfiguration.overrideClickThroughUrl

• 移除或替换了以下枚举值：

  资源	字段	被移除的值	已替换为
  EventTags	SiteFilterType	BLACKLIST	BLOCKLIST
  EventTags	SiteFilterType	WHITELIST	ALLOWLIST

已知问题

• 无

版本 3.4

新功能

• 添加了以下字段：

  资源	字段
  Reports	pathToConversionCriteria
  Reports	pathCriteria
  FloodlightActivities	status
  FloodlightActivities	attributionEnabled
  Creatives	obaIcon
  Sites	videoSettings.obaSettings
  Placements	videoSettings.obaSettings

已停用

• 移除或替换了以下字段：

  资源	字段	已替换为
  FloodlightActivities	hidden	status
  Ads	disregardOverdelivery

已知问题

• 无

版本 3.3

新功能

• 添加了以下字段：

  资源	字段
  Creatives	creativeAssets[].audioBitRate creativeAssets[].audioSampleRate creativeAssets[].frameRate creativeAssets[].politeLoad
  FloodlightConfigurations	customViewabilityMetric
  Sites	videoSettings[]

已停用

• 移除了以下资源：

  资源
  DirectorySiteContacts

• 移除或替换了以下字段：

  资源	字段	已替换为
  Campaigns	lookbackConfiguration
  Creatives	politeLoadAssetId	creativeAssets[].politeLoad
  DirectorySites	contactAssignments countryId currencyId description parentId settings.nielsenOcrOptOut settings.verificationTagOptOut settings.videoActiveViewOptOut

已知问题

• 无