標籤

您可以使用標籤將帳戶中的元素分類為有意義的群組，以便快速篩選所需資料並製作相關報表。Google Ads 指令碼支援帳戶、廣告活動和 廣告群組、廣告和關鍵字層級。

用途

在 Google Ads 帳戶中，標籤可用來連結任意資料 Google Ads 實體管理員帳戶可使用標籤將相似的標籤分組 孩童帳戶。標籤可用於多種用途：

  • 處理帳戶清單
    • 如果您是代理商，可以將 plumber_accounts 標籤套用至所有水管工帳戶，然後透過指令碼將水管工相關關鍵字 (例如「緊急淋浴設備維修」) 推送至這些帳戶中的所有廣告活動。
  • 處理實體清單
    • 如果您希望啟用一組關鍵字，但只想在 則可以套用 weekend_keywords 標籤。 接著指令碼可以在星期五啟用所有帶有weekend_keywords的關鍵字 然後在週一早上暫停
  • 處理多個執行作業中的實體
    • 如果有大量實體無法在 30 分鐘後，您可以在以下位置建立 processed 標籤： 並套用至已處理的實體。 排定指令碼每小時執行一次，然後只處理符合以下條件的實體 未套用「processed」標籤
  • 兩步驟變更
    • 您可以使用 increase_bid_by_10% 為關鍵字加上標籤，然後登入 Google Ads 使用者介面，篩選出符合標籤的關鍵字，並查看這些關鍵字。如果您對結果感到滿意，可以使用大量編輯功能變更出價。
  • 彈性出價
    • 指令碼可以使用標籤來維護出價變更記錄。舉例來說，如果指令碼將關鍵字出價調高 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 運算子，依標籤資源名稱篩選。