Etykiety

Etykiety służą do grupowania elementów na koncie, aby szybko i łatwo filtrować potrzebne dane oraz tworzyć o nich raporty. Skrypty Google Ads obsługują etykiety na poziomie konta, kampanii, grupy reklam, reklamysłowa kluczowego.

Przypadki użycia

Na kontach Google Ads za pomocą etykiet można powiązać wybrane dane z elementów Google Ads. Na kontach menedżera można używać etykiet do grupowania podobnych subkont. Etykiety mają wiele zastosowań:

  • Przetwarzanie listy kont
    • Jeśli reprezentujesz agencję, możesz zastosować etykietę plumber_accounts do wszystkich kont dla hydraulików, dzięki któremu skrypt może przekazać słów kluczowych (np. „naprawa pryszniców awaryjnych”) we wszystkich kampaniach tych kont.
  • Przetwarzanie listy encji
    • Jeśli masz zestaw słów kluczowych, które mają być włączane tylko podczas w weekendy, możesz zastosować do nich etykietę weekend_keywords. Skrypt może wtedy włączyć wszystkie słowa kluczowe z wartością weekend_keywords w piątek wieczorem i wstrzymać w poniedziałek rano.
  • Przetwarzanie encji w wielu uruchomieniach
    • Jeśli masz dużą liczbę elementów, których nie można przetworzyć w 30 minut, możesz utworzyć etykietę processed w i zastosuje go w elementach, które zostały już przetworzone. Zaplanuj uruchamianie skryptu co godzinę, a następnie przetwarzaj tylko te elementy, które nie mają etykiety processed.
  • Zmiany dotyczące weryfikacji dwuetapowej
    • Zamiast uruchamiać skrypt, który zmienia stawki za dużą liczbę słów kluczowych, możesz oznaczyć te słowa kluczowe etykietą increase_bid_by_10%, zalogować się w interfejsie Google Ads, odfiltrować słowa kluczowe pasujące do tej etykiety, przejrzeć je i w razie potrzeby zmienić ich stawki za pomocą edycji zbiorczych.
  • Elastyczne określanie stawek
    • Skrypt może używać etykiet do utrzymywania historii zmian stawek. Dla: gdy skrypt podnosi stawkę za słowo kluczowe o 20%, może konto z etykietą increased_20%. Gdy następnego dnia skrypt wykona się na nowej etykiecie i wykryje, że stawka została już wcześniej podwyższona, może ją zwiększyć tylko o 10%.
  • Śledzenie wyniku jakości
    • Skrypt może oznaczyć ważne słowa kluczowe wynikami jakości, a następnie okresowo sprawdzać i raportować słowa kluczowe, których Wynik Jakości przestaje być niski pasuje do etykiety.

Etykiety na poziomie konta

Skrypty Google Ads umożliwiają tworzenie etykiet na kontach menedżera oraz stosowanie ich na kontach Google Ads podlegających temu kontu menedżera:

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

Etykietę możesz zastosować do wybranych kont za pomocą metody 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);
}

Podobnie możesz usunąć etykietę z konta, korzystając z metody 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);
}

Najczęstszym zastosowaniem etykiet kont jest przetwarzanie grupy kont, które mają tę samą etykietę:

const labelName = 'High spending accounts';

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

Zapoznaj się ze skryptami konta menedżera , aby dowiedzieć się więcej. o przetwarzaniu wielu kont w ramach jednego wykonania skryptu.

Etykiety na koncie

Możesz tworzyć etykiety i stosować je do kampanii, grup reklam na koncie, reklamy i słowa kluczowe. Aby przypisać etykietę do kampanii:

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

W podobny sposób możesz usunąć etykietę, korzystając z metody removeLabel:

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

Etykiety są najczęściej używane do przetwarzania zbioru podobnych elementów zgrupowanych według etykiety. Ten fragment kodu pokazuje, jak wstrzymać grupę kampanii, które mają wspólną etykietę:

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

Raportowanie

Podczas generowania raportów o wydajności na kontach Google Ads możesz używać nazw zasobów etykiet do filtrowania według elementów. Nazwy zasobów są pojęciem z Google Ads API i czasami są używane do generowania raportów z GAQL. Zasób etykiety nazwa ma zawsze format:

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

Nazwę zasobu etykiety możesz pobrać za pomocą metody getResourceName.

Fragment kodu poniżej pokazuje, jak uruchomić kampanię raportu dla wszystkich kampanii, które mają „Promocje świąteczne”. etykieta:

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);

Pamiętaj, że możesz używać tylko tych atrybutów: CONTAINS_ALL, CONTAINS_ANY i CONTAINS_NONE – operatory do filtrowania według nazw zasobów etykiet.