借助 Display & Video 360 API,您可以披露素材资源是由 AI 生成或修改的。在有本地 AI 标签法规的地区,包含此类素材资源的广告在投放时会带有标签。
如需了解详情,请访问 Display & Video 360 帮助中心。
Display & Video 360 API 中的支持
Display & Video 360 API 在 Creative 和 AdAsset 资源中包含一个可选字段 syntheticContentAttestationStatus。您可以使用此字段指定广告素材或素材资源是否包含由 AI 创建或修改的内容。
将 syntheticContentAttestationStatus 设置为 IS_SYNTHETIC 会在有当地 AI 标签添加法规的地区应用标签,而将其设置为 NOT_SYNTHETIC 则表示相应内容不需要添加标签。您也可以将该字段保持未设置状态。如果该字段未设置,系统将不会应用任何标签。
不过,为资源设置此字段后,便无法取消设置,并且只能更新为 IS_SYNTHETIC 或 NOT_SYNTHETIC。
下表显示了 SyntheticContentAttestationStatus 枚举的有效值:
SyntheticContentAttestationStatus 枚举值 | |
|---|---|
SYNTHETIC_CONTENT_ATTESTATION_STATUS_UNSPECIFIED |
未提供证明。 |
NOT_SYNTHETIC |
已证明不是由 AI 生成或修改。 |
IS_SYNTHETIC |
已证明由 AI 创建或修改。 |
如需详细了解设置此字段对广告投放的影响,请参阅 Display & Video 360 帮助中心。
为实时出价广告素材添加标签
在 Display & Video 360 API 中,通过实时出价广告投放的广告素材由 Creative 资源定义。使用 Creative 资源中的 syntheticContentAttestationStatus 字段为实时出价广告素材添加标签。
新广告素材
使用 advertisers.creatives.create 创建新广告素材时,请设置此字段。
现有广告素材
如需更新现有广告素材,请执行以下操作:
- 使用
advertisers.creatives.list检索现有广告素材。 - 检查其现有的
syntheticContentAttestationStatus字段值。 - 如有需要,请使用
advertisers.creatives.patch更新任何现有广告素材的字段。
为 YouTube 广告和需求开发广告素材资源添加标签
在 Display & Video 360 API 中,由 YouTube 和需求开发广告投放的广告素材由各个 AdAsset 资源组成。使用 AdAsset 资源中的 syntheticContentAttestationStatus 字段为 YouTube 广告和需求开发广告中使用的 YouTube 视频或图片素材资源添加标签。
新素材资源
创建新素材资源时,请设置此字段:
- 对于新的 YouTube 视频素材资源,在
advertisers.adAssets.create请求的AdAsset对象中。 - 对于图片素材资源,请在
advertisers.adAssets.upload请求的正文中。
如果设置了同一 YouTube 视频的素材资源,则这些素材资源必须具有相同的 syntheticContentAttestationStatus 字段值。使用 advertisers.adAssets.list 和以下过滤条件参数,在尝试创建新素材资源之前,查看相关 YouTube 视频 ID 的素材资源是否已存在:
youtubeVideoAsset.youtubeVideoId=youtube-video-id
现有素材资源
如需更新现有素材资源,请执行以下操作:
- 使用
advertisers.adAssets.list检索现有广告素材。 - 检查其现有的
syntheticContentAttestationStatus字段值。 - 如有需要,请使用
advertisers.adAssets.patch更新任何现有广告素材资源的字段。