遷移廣告額外資訊指令碼

本文件說明存取或管理廣告額外資訊的指令碼遷移程序。自 2022 年 3 月 28 日起，如果客戶使用指令碼更新廣告額外資訊，系統會將動態饋給型額外資訊遷移至新的素材資源型額外資訊。自 2022 年 5 月 13 日起，若客戶使用指令碼擷取廣告額外資訊 (且沒有更新廣告額外資訊的指令碼)，系統會將動態饋給型額外資訊遷移至新的素材資源型額外資訊。

總覽

已淘汰現有的動態饋給型擴充功能範例，並改用資產型額外資訊。動態饋給型額外資訊在 Google Ads 使用者介面中稱為「舊版」額外資訊，素材資源型額外資訊在 Google Ads 使用者介面中則稱為「升級版」額外資訊。

自 2022 年 3 月 28 日起，動態饋給型額外資訊會遷移至新的素材資源型額外資訊。遷移完成後，動態饋給型額外資訊就會停止放送。 本指南將概述遷移流程，說明您的 Google Ads 帳戶同時含有動態饋給型和素材資源型廣告額外資訊，還是帳戶中只包含動態饋給型廣告額外資訊。

遷移作業詳細資料

若要開始存取或更新素材資源型廣告額外資訊，您必須使用新版 Google Ads 指令碼服務。如要瞭解新版 Google Ads 指令碼體驗，請參閱入門指南。

正在擷取廣告額外資訊

現有的廣告額外資訊選取器 (例如 SitelinkSelector) 能擷取動態饋給型廣告額外資訊或素材資源型廣告額外資訊。根據預設，這些選取器會傳回目前放送中的任一廣告額外資訊類型。下表總結了目前放送的廣告額外資訊類型 (因此系統預設會傳回這類額外資訊)：

帳戶中的廣告額外資訊類型
僅限動態饋給型廣告額外資訊 根據預設，系統會傳回動態饋給型廣告額外資訊
僅限素材資源型廣告額外資訊 根據預設，系統會傳回素材資源型廣告額外資訊
同時採用動態饋給型和素材資源型廣告額外資訊 根據預設，系統會傳回素材資源型廣告額外資訊

所有動態饋給型廣告額外資訊都遷移完畢後，根據預設，所有廣告額外資訊選擇器都會傳回素材資源型廣告額外資訊。您仍可使用 withOnlyLegacy 方法擷取動態饋給型廣告額外資訊。有助於收集歷來指標。

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

在多數情況下，您不需要在動態饋給型廣告額外資訊之前或之後修改程式碼。但是，在某些情況下，可能需要變更程式碼。

按 ID 篩選廣告額外資訊

遷移動態饋給型廣告額外資訊時，對應的素材資源型廣告額外資訊會有「不同的」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。

按統計資料篩選廣告額外資訊

遷移動態饋給型廣告額外資訊後，對應的素材資源型廣告額外資訊統計資料會重設。依統計資料篩選廣告額外資訊時，應該將這一點列入考量。舉例來說，如果您在 LAST_MONTH 中使用 Clicks > 100 要求網站連結額外資訊，則如果動態饋給型廣告額外資訊最近才剛遷移，額外資訊可能會比一般廣告少。

產生廣告額外資訊的成效報表時，也請務必記住這一點。遷移動態饋給型廣告額外資訊後，報表可能會有大幅變動或下滑。

已淘汰的方法

我們在遷移過程中停止支援數個欄位。舉例來說，在網站簡介額外資訊中，開始日期和結束日期就已淘汰。呼叫 getStartDate() 會傳回 null。此外，系統也會記錄警告訊息。請參閱下表，瞭解已淘汰的方法：

類別 已淘汰的方法
摘要 沒有任何已淘汰的方法
MobileApp getSchedules
PhoneNumber getEndDate
getStartDate
價格 getEndDate
getSchedules
getStartDate
網站連結 沒有任何已淘汰的方法
文字片段 getEndDate
getSchedules
getStartDate

正在更新廣告額外資訊

我們在遷移過程中停止支援數個欄位。舉例來說，在網站簡介額外資訊中，開始日期和結束日期就已淘汰。呼叫 setStartDate 並不會影響廣告額外資訊。此外，系統也會記錄警告訊息。請參閱下表，瞭解已淘汰的方法：

類別 已淘汰的方法
摘要 沒有任何已淘汰的方法
MobileApp setSchedules
PhoneNumber clearEndDate
clearStartDatesetEndDate
setStartDate
價格 clearEndDate
clearStartDatesetEndDate
setSchedules
setStartDate
網站連結 沒有任何已淘汰的方法
文字片段 clearEndDate
clearStartDatesetEndDate
setSchedules
setStartDate

建立廣告額外資訊

現有的廣告額外資訊製作工具 (例如 SitelinkBuilder 能夠建立動態饋給型廣告額外資訊或素材資源型廣告額外資訊)。根據預設，這些建構工具會建立目前正在放送的任何廣告額外資訊類型。下表歸納了目前正在放送的廣告額外資訊類型 (因此預設為建立)：

帳戶中的廣告額外資訊類型
僅限動態饋給型廣告額外資訊 根據預設，系統會建立動態饋給型廣告額外資訊
僅限素材資源型廣告額外資訊 根據預設，系統會建立素材資源型廣告額外資訊
同時採用動態饋給型和素材資源型廣告額外資訊 根據預設，系統會建立素材資源型廣告額外資訊

客戶遷移額外資訊後，根據預設，所有廣告額外資訊製作工具都會建立素材資源型廣告額外資訊。由於系統將不再放送動態饋給型廣告額外資訊， 因此不再支援建立動態饋給型廣告額外資訊的功能。

如果您想建立以動態饋給為基礎的擴充功能，而非依賴預設行為，可以呼叫 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();

如果您想建立素材資源型額外資訊，但帳戶目前只有動態饋給型額外資訊，可以等到 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 不會對擴充功能造成任何影響，而是會記錄警告訊息。請參閱下表，瞭解各個類別淘汰的方法：

類別 已淘汰的方法
CalloutBuilder withMobilePreferred
MobileAppBuilder withMobilePreferred
withSchedules
PhoneNumberBuilder withEndDate
withMobilePreferred
withStartDate
PriceBuilder withEndDate
withMobilePreferred
withSchedules
withStartDate
SitelinkBuilder withMobilePreferred
SnippetBuilder withEndDate
withMobilePreferred
withSchedules
withStartDate