迁移广告附加信息脚本

本文档介绍了访问或管理 广告附加信息自 2022 年 3 月 28 日起，使用脚本的客户将更新广告 附加信息会将基于 Feed 的附加信息迁移到新的基于素材资源的附加信息 。自 2022 年 5 月 13 日起，使用脚本提取功能的客户 广告附加信息（无需更新广告附加信息的脚本）将基于 Feed 已迁移到基于素材资源的新附加信息。

概览

基于 Feed 的现有附加信息范式已弃用，取而代之的是 基于素材资源的附加信息基于 Feed 的附加信息称为“旧版” Google Ads 界面中的附加信息称为基于素材资源的附加信息 “已升级”在 Google Ads 界面中添加附加信息。

自 2022 年 3 月 28 日起，基于 Feed 的附加信息将迁移至新版 基于素材资源的附加信息 - 迁移后，基于 Feed 的附加信息将停止投放。 本指南概述了您是否同时使用基于 Feed 和基于 Feed 的迁移， 您的 Google Ads 账号中基于素材资源的广告附加信息，或者只有基于 Feed 的广告 。

迁移详情

要开始使用或更新基于素材资源的广告附加信息，您必须使用 新版 Google Ads 脚本体验。有关新版 Google Ads 的信息 脚本的使用体验，请参阅使用入门 指南。

获取广告附加信息

现有的一组广告附加信息选择器（例如 SitelinkSelector 能够提取基于 Feed 的广告附加信息或基于素材资源的广告 。默认情况下，这些选择器将返回 附加信息当前正在投放中。下表总结了 当前投放的（因此默认情况下将会返回）的附加信息：

在迁移完所有基于 Feed 的广告附加信息后， 选择器将默认返回基于素材资源的广告附加信息。它仍然 可以通过 withOnlyLegacy 方法提取基于 Feed 的广告附加信息。这个 有助于收集历史指标

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

在大多数情况下，在基于 Feed 的广告之前或之后都不需要更改代码 扩展程序已迁移完毕。不过，在某些情况下， 可能需要进行更改。

按 ID 过滤广告附加信息

迁移基于 Feed 的广告附加信息时，对应的基于素材资源的广告 扩展程序将具有不同的 ID。这意味着，如果您的脚本目前 按 ID 过滤广告附加信息，因此无法提取基于素材资源的广告 。

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

要解决此问题，您应按其他属性进行过滤或更新 您的代码，以使用基于素材资源的广告附加信息ID。

按统计信息过滤广告附加信息

迁移基于 Feed 的广告附加信息时，对应的基于素材资源的广告 其统计信息将会重置。您应该考虑这一点 。例如，如果您请求 附加信息Clicks > 100在LAST_MONTH展示，您看到的广告会减少 您的附加信息（例如基于 Feed 的广告附加信息最近迁移过）。

在生成效果报告时，也应牢记这一点。 广告附加信息在以下情况下，您的报告可能会出现显著波动或 基于 Feed 的广告附加信息已迁移。

已弃用的方法

在迁移过程中，有多个字段不再受支持。例如： 附加摘要信息已弃用开始日期和结束日期。调用 getStartDate() 将返回 null。此外，系统还会向 已记录。请参阅下表，了解哪些方法已废弃：

更新广告附加信息

在迁移过程中，有多个字段不再受支持。例如： 附加摘要信息已弃用开始日期和结束日期。调用 setStartDate 不会对广告附加信息产生任何影响。此外，系统还会向 消息。请参阅下表，了解 已弃用：

创建广告附加信息

现有的一组广告附加信息制作工具（例如 SitelinkBuilder 可以创建基于 Feed 的广告附加信息或基于素材资源的广告 。默认情况下，这些制作工具会制作 附加信息当前正在投放中。下表总结了 目前正在投放（因此将默认创建）的附加信息：

在客户迁移其附加信息后，所有广告附加信息制作工具都会 默认创建基于素材资源的广告附加信息。制作基于 Feed 的广告 我们将不再支持附加信息，因为基于 Feed 的广告附加信息 。

如果您想创建基于 Feed 的附加信息，而不是使用默认的附加信息 可以通过调用 build(true)（而不是 build()）来实现此目的， 示例：

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

如果您想创建基于素材资源的附加信息，并且您的账号目前只 提供了基于 Feed 的附加信息，您可以等到 3 月 28 日，也可以致电 build(false)。

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

不受支持的字段

在广告附加信息迁移过程中，某些字段已被弃用。对于 例如，代码段扩展中的开始日期和结束日期已弃用。 调用 withEndDate 或 withStartDate 不会对 ，而是会记录一条警告消息。请参阅以下内容 了解每个类已废弃哪些方法：