Etykiety

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

Przypadki użycia

Na kontach Google Ads etykiety mogą służyć do powiązania dowolnych danych z elementami Google Ads. Na kontach menedżera etykiety mogą służyć do grupowania podobnych kont podrzędnych. Etykiety są przydatne w wielu przypadkach:

  • Przetwarzanie listy kont
    • Jeśli jesteś agencją, możesz zastosować etykietę plumber_accounts do wszystkich kont hydraulików, a następnie skrypt może umieszczać słowa kluczowe związane z hydrauliką (np. „awaryjna naprawa prysznica”) we wszystkich kampaniach na tych kontach.
  • Przetwarzanie listy podmiotów
    • Jeśli masz zestaw słów kluczowych, które chcesz włączać tylko w weekendy, możesz zastosować do nich etykietę weekend_keywords. Skrypt może włączyć wszystkie słowa kluczowe z symbolem weekend_keywords w piątek wieczorem i wstrzymać je w poniedziałek rano.
  • Przetwarzanie jednostek w wielu przebiegach
    • Jeśli masz dużą liczbę elementów, których nie można przetworzyć w ciągu 30 minut, możesz utworzyć w skrypcie etykietę processed i zastosować ją do elementów, które zostały już przetworzone. Zaplanuj uruchamianie skryptu co godzinę, a następnie przetwarzaj tylko jednostki, do których nie zastosowano etykiety processed.
  • Zmiany dwuetapowe
    • Zamiast wykonywać za pomocą skryptu zmiany stawek w przypadku dużej liczby słów kluczowych, możesz oznaczyć słowa kluczowe etykietą increase_bid_by_10%, zalogować się w interfejsie Google Ads, odfiltrować słowa kluczowe pasujące do etykiety, sprawdzić je, a jeśli wynik będzie zadowalający, zmienić ich stawki za pomocą edycji zbiorczych.
  • Elastyczne ustalanie stawek
    • Skrypt może używać etykiet do przechowywania historii zmian stawek. Na przykład, gdy skrypt zwiększa stawkę za słowo kluczowe o 20%, może oznaczyć konto etykietą increased_20%. Następnego dnia, gdy skrypt zostanie uruchomiony w przypadku etykiety i zorientuje się, że wcześniej już zwiększył stawkę, może ją zwiększyć tylko o 10%.
  • Śledzenie wyniku jakości
    • Skrypt może oznaczać ważne słowa kluczowe ich wynikami jakości, a następnie okresowo sprawdzać i raportować słowa kluczowe, których wynik jakości nie pasuje już do etykiety.

Etykiety na poziomie konta

Skrypty Google Ads umożliwiają tworzenie etykiet na kontach menedżera, a także 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ą tej 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 za pomocą 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();

Więcej informacji o przetwarzaniu wielu kont w ramach jednego wykonania skryptu znajdziesz w naszym przewodniku po skryptach na koncie menedżera.

Etykiety na koncie

Możesz tworzyć etykiety i stosować je do kampanii, grup reklam, reklamsłów kluczowych na koncie. Aby zastosować etykietę w kampanii:

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

Etykietę możesz też usunąć za pomocą 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 zestawu podobnych obiektów zgrupowanych razem za pomocą etykiety. Poniższy 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 skuteczności na kontach Google Ads możesz używać nazw zasobów etykiet do filtrowania encji. Nazwy zasobów to pojęcie z interfejsu Google Ads API, które jest czasami używane podczas generowania raportów za pomocą GAQL. Nazwa zasobu etykiety ma zawsze format:

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

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

Poniższy fragment kodu pokazuje, jak uruchomić raport o kampanii dla wszystkich kampanii, które mają etykietę „Promocje świąteczne”:

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 do filtrowania według nazw zasobów etykiet możesz używać tylko operatorów CONTAINS_ALL, CONTAINS_ANYCONTAINS_NONE.