Etykiety

Etykiety umożliwiają grupowanie elementów na koncie, co pozwala szybko filtrować i tworzyć raporty na podstawie danych, które najbardziej Cię interesują. Skrypty Google Ads obsługują etykiety na poziomie konta, kampanii, grupy reklam, reklamy i słowa kluczowego.

Przypadki użycia

Na kontach Google Ads etykiety można używać do dowolnego powiązania danych z elementami Google Ads. Na kontach menedżera można używać etykiet do grupowania podobnych kont podrzędnych. Etykiety ułatwiają realizację wielu przypadków użycia:

  • Przetwarzanie listy kont
    • Jeśli jesteś właścicielem agencji, możesz zastosować etykietę plumber_accounts do wszystkich kont należących do hydraulików, a potem skrypt może dodawać do wszystkich kampanii na tych kontach słowa kluczowe związane z hydrauliką (np. „awaryjny remont prysznica”).
  • Przetwarzanie listy jednostek
    • Jeśli masz zbiór słów kluczowych, które chcesz włączyć tylko w weekendy, możesz zastosować do nich etykietę weekend_keywords. Skrypt może następnie włączyć wszystkie słowa kluczowe z dodatkiem weekend_keywords w piątek wieczorem, a w poniedziałek rano je wstrzymać.
  • Przetwarzanie jednostek w wielu przebiegach
    • Jeśli masz dużą liczbę elementów, których nie można przetworzyć w mniej niż 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 potem przetwarzaj tylko te elementy, do których nie zastosowano etykiety processed.
  • Zmiany dotyczące weryfikacji dwuetapowej
    • Zamiast uruchamiać skrypt, aby zmienić stawki za dużą liczbę słów kluczowych, możesz je oznaczyć 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. Jeśli np. skrypt zwiększa stawkę za słowo kluczowe o 20%, może oznaczyć konto etykietą increased_20%. Gdy następnego dnia skrypt wykona się na nowej etykiecie i sprawdzi, że stawka została już wcześniej podwyższona, 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ć o słowach kluczowych, których wynik jakości nie odpowiada już etykietce.

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

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

Etykiety na koncie

Etykiety możesz tworzyć i stosować do kampanii, grup reklam, reklam i słów kluczowych na koncie. Aby przypisać etykietę do kampanii:

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

Możesz też 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 to koncepcja z interfejsu Google Ads API, która jest czasami używana podczas uruchamiania 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.

Ten fragment kodu pokazuje, jak uruchomić raport dotyczący kampanii dla wszystkich kampanii oznaczonych 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_ANY i CONTAINS_NONE.