標籤

標籤可讓您將帳戶中的元素整理成有意義的群組，以便快速篩選您最感興趣的資料並製成報表。Google Ads 指令碼支援帳戶、廣告活動、廣告群組、廣告和關鍵字層級的標籤。

用途

在 Google Ads 帳戶中，標籤可用來將任意資料與 Google Ads 實體建立關聯。在管理員帳戶中，標籤可用來將相似的子帳戶分組。標籤的用途很多，例如：

  • 處理帳戶清單
    • 如果您是代理商，可以對所有水電工帳戶套用 plumber_accounts 標籤，然後指令碼就可以將水電相關關鍵字 (例如「緊急淋浴間維修」) 推送至這些帳戶中的所有廣告活動。
  • 處理實體清單
    • 如果只想在週末啟用一組關鍵字，則可對這些關鍵字套用 weekend_keywords 標籤。接著，指令碼就可以在週五晚上啟用 weekend_keywords 的所有關鍵字，並在週一上午暫停。
  • 處理多次執行作業中的實體
    • 如果您有大量實體無法在 30 分鐘內處理，則可在指令碼中建立 processed 標籤，並套用至已處理的實體。排定指令碼每小時執行一次，然後只處理未套用 processed 標籤的實體。
  • 兩步驟驗證
    • 與其讓指令碼對大量關鍵字執行出價變更，您可以為關鍵字加上標籤 increase_bid_by_10%，並登入 Google Ads UI，篩選出與標籤相符的關鍵字並加以審核；如果對結果感到滿意，就可以使用大量編輯功能變更出價。
  • 彈性出價
    • 指令碼可以使用標籤來保留出價變更記錄。舉例來說，當指令碼將關鍵字出價提高 20% 時，指令碼就能為帳戶加上 increased_20% 標籤。第二天，指令碼對標籤執行時，發現之前已提高出價，出價只能提高 10%。
  • 品質分數追蹤
    • 指令碼可以用品質分數標記重要關鍵字，然後定期檢查並回報品質分數與標籤不符的關鍵字。

帳戶層級標籤

Google Ads 指令碼可讓您在管理員帳戶中建立標籤，以及為該管理員帳戶底下的 Google Ads 帳戶套用標籤：

const labelName = 'High spending accounts';
AdsManagerApp.createAccountLabel(labelName);

您可以使用 applyLabel 方法，將標籤套用至所選帳戶：

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.applyLabel(labelName);
}

同樣地，您也可以使用 removeLabel 方法從帳戶中移除標籤：

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.removeLabel(labelName);
}

最常見的帳戶標籤用途是處理共用相同帳戶標籤的一組帳戶：

const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts()
    .withCondition(`LabelNames CONTAINS "${labelName}"`)
    .get();

如要進一步瞭解如何透過單一指令碼執行處理多個帳戶，請參閱管理員帳戶指令碼指南。

帳戶中的標籤

您可以為帳戶的廣告活動、廣告群組、廣告和關鍵字建立及套用標籤。將標籤套用至廣告活動的方法如下：

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.applyLabel('High performing campaign');

同樣地，您可以使用 removeLabel 方法移除標籤：

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.removeLabel('High performing campaign');

標籤最常用於處理由標籤分組的一組相似實體。下列程式碼片段說明如何暫停一組共用相同標籤的廣告活動：

const label = AdsApp.labels()
    .withCondition('label.name = "Christmas promotions"')
    .get().next();
var campaignIterator = label.campaigns().get();
for (const campaign of campaignIterator) {
  campaign.pause();
}

報告

執行 Google Ads 帳戶的成效報表時，您可以使用標籤資源名稱篩選實體。資源名稱是 Google Ads API 的概念，有時在透過 GAQL 執行報表時會使用。標籤資源名稱一律採用以下格式：

customers/[customer id]/labels/[label id]

您可以使用標籤的 getResourceName 方法擷取標籤資源名稱。

下列程式碼片段說明如何針對標有「聖誕節促銷」標籤的所有廣告活動執行廣告活動報表：

const label = AdsApp.labels()
    .withCondition("label.name = 'Christmas promotions'")
    .get().next();
const query = `SELECT campaign.name, metrics.clicks, metrics.impressions, metrics.cost ` +
    `FROM campaign WHERE campaign.labels CONTAINS ANY ` +
    `["${label.getResourceName()}"] AND segments.date DURING THIS_MONTH`;
const result = AdsApp.search(query);

請注意，您只能使用 CONTAINS_ALL、CONTAINS_ANY 和 CONTAINS_NONE 運算子來按照標籤資源名稱進行篩選。