Labels

Mit Labels können Sie Elemente in Ihrem Konto in aussagekräftige Gruppen organisieren. So können Sie die für Sie interessantesten Daten schnell filtern und Berichte dazu erstellen. Google Ads-Skripts unterstützen Labels auf Konto-, Kampagnen-, Anzeigengruppen-, Anzeigen- und Keyword-Ebene.

Anwendungsfälle

In Google Ads-Konten können Labels verwendet werden, um beliebige Daten mit Google Ads-Entitäten zu verknüpfen. In Verwaltungskonten lassen sich mit Labels ähnliche untergeordnete Konten gruppieren. Labels sind für eine Reihe von Anwendungsfällen hilfreich:

  • Eine Liste von Konten verarbeiten
    • Als Agentur könnten Sie ein plumber_accounts-Label auf alle Konten für Klempner anwenden. Ein Skript kann dann in allen Kampagnen in diesen Konten Keywords mit Bezug zu Klempnern (z. B. „Notdienst für Duschen“) per Push-Funktion übertragen.
  • Eine Liste von Entitäten verarbeiten
    • Wenn Sie eine Reihe von Keywords nur an Wochenenden aktivieren möchten, können Sie ein weekend_keywords-Label darauf anwenden. Ein Script könnte dann am Freitagabend alle Keywords mit weekend_keywords aktivieren und am Montagmorgen pausieren.
  • Entitäten über mehrere Ausführungen hinweg verarbeiten
    • Wenn Sie eine große Anzahl von Entitäten haben, die nicht in weniger als 30 Minuten verarbeitet werden können, können Sie ein processed-Label in Ihrem Skript erstellen und auf bereits verarbeitete Entitäten anwenden. Planen Sie das Skript stündlich und verarbeiten Sie dann nur Entitäten, auf die das Label processed nicht angewendet ist.
  • Änderungen in zwei Schritten
    • Anstatt das Skript eine Gebotsänderung für eine große Anzahl von Keywords ausführen zu lassen, können Sie die Keywords mit dem Label increase_bid_by_10% versehen, sich auf der Google Ads-Benutzeroberfläche anmelden, die mit dem Label übereinstimmenden Keywords herausfiltern, sie überprüfen und ihre Gebote mit Bulk-Änderungen ändern, wenn Sie mit dem Ergebnis zufrieden sind.
  • Flexible Gebote
    • Ein Skript kann Labels verwenden, um den Verlauf der Gebotsänderungen zu erfassen. Wenn beispielsweise ein Skript ein Keyword-Gebot um 20 % erhöht, wird das Konto mit dem Label increased_20% gekennzeichnet. Wenn das Skript am nächsten Tag für das Label ausgeführt wird und feststellt, dass es das Gebot bereits zuvor erhöht hat, könnte es das Gebot nur um 10 % erhöhen.
  • Tracking des Qualitätsfaktors
    • Ein Skript könnte wichtige Keywords mit ihren Qualitätsfaktoren kennzeichnen und dann Keywords, deren Qualitätsfaktor nicht mehr dem Label entspricht, regelmäßig überprüfen und Berichte dazu erstellen.

Labels auf Kontoebene

Mit Google Ads-Skripts können Sie Labels in Verwaltungskonten erstellen und auf Google Ads-Konten in diesem Verwaltungskonto anwenden:

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

Sie können das Label mithilfe der Methode applyLabel auf die Konten Ihrer Wahl anwenden:

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

Ähnlich können Sie mit der Methode removeLabel ein Label aus einem Konto entfernen:

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

Kontolabels werden am häufigsten verwendet, um eine Gruppe von Konten mit demselben Kontolabel zu verarbeiten:

const labelName = 'High spending accounts';

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

Weitere Informationen zur Verarbeitung mehrerer Konten mit nur einer Skriptausführung finden Sie in unserem Leitfaden zu Skripts für Verwaltungskonten.

Labels in einem Konto

Sie können Labels erstellen und auf Kampagnen, Anzeigengruppen, Anzeigen und Keywords eines Kontos anwenden. So wenden Sie ein Label auf eine Kampagne an:

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

Entsprechend können Sie ein Label mithilfe der Methode removeLabel entfernen:

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

Labels werden am häufigsten verwendet, um eine Reihe ähnlicher Entitäten zu verarbeiten, die durch ein Label gruppiert sind. Im folgenden Code-Snippet sehen Sie, wie eine Gruppe von Kampagnen mit einem gemeinsamen Label pausiert wird:

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

Berichterstellung

Wenn Sie Leistungsberichte für Google Ads-Konten erstellen, können Sie Label-Ressourcennamen verwenden, um nach Entitäten zu filtern. Ressourcennamen sind ein Konzept der Google Ads API und werden manchmal beim Erstellen von Berichten mit GAQL verwendet. Ein Label-Ressourcenname hat immer das folgende Format:

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

Sie können den Ressourcennamen eines Labels mithilfe der Methode getResourceName abrufen.

Im folgenden Code-Snippet sehen Sie, wie Sie einen Kampagnenbericht für alle Kampagnen mit dem Label „Weihnachtsangebote“ erstellen:

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

Sie können nur die Operatoren CONTAINS_ALL, CONTAINS_ANY und CONTAINS_NONE verwenden, um nach Labelressourcennamen zu filtern.