Labels

Mithilfe von Labels können Sie Elemente in Ihrem Konto in aussagekräftige Gruppen unterteilen. So können Sie die Ergebnisse schnell und einfach filtern sowie Berichte zu den Daten erstellen, die für Sie am wichtigsten sind. Google Ads-Scripts unterstützen Labels auf Ebene des Kontos, der Kampagne, der Anzeigengruppe, der Anzeige und des Keywords.

Anwendungsfälle

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

  • Liste mit Konten verarbeiten
    • Als Agentur können Sie allen Konten für Klempner das Label plumber_accounts zuweisen. Anschließend kann ein Script Keywords für Klempner (z. B. „Reparatur von Duschen bei Notfällen“) in alle Kampagnen in diesen Konten einfügen.
  • Liste mit Entitäten verarbeiten
    • Wenn Sie eine Gruppe von Keywords nur an Wochenenden aktivieren möchten, können Sie ein Label vom Typ weekend_keywords darauf anwenden. Ein Script könnte dann alle Keywords mit weekend_keywords am Freitagabend aktivieren und sie 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 in Ihrem Script ein processed-Label erstellen und auf bereits verarbeitete Entitäten anwenden. Planen Sie das Script so, dass es stündlich ausgeführt wird, und verarbeiten Sie dann nur Entitäten, auf die das Label processed nicht angewendet wurde.
  • Änderungen in zwei Schritten
    • Anstatt das Script eine Gebotsänderung für eine große Anzahl von Keywords ausführen zu lassen, können Sie die Keywords mit increase_bid_by_10% kennzeichnen, sich in der Google Ads-Benutzeroberfläche anmelden, die Keywords herausfiltern, die mit dem Label übereinstimmen, sie überprüfen und die Gebote mithilfe der Bulk-Bearbeitung ändern, wenn Sie mit dem Ergebnis zufrieden sind.
  • Flexible Gebote
    • Ein Skript kann Labels verwenden, um den Verlauf der Gebotsänderungen zu erfassen. Wenn ein Script beispielsweise einen Keyword-Gebot um 20 % erhöht, kann das Konto mit dem Label increased_20% gekennzeichnet werden. Wenn das Script am nächsten Tag das Label auswertet und feststellt, dass das Gebot bereits erhöht wurde, kann es nur um 10 % erhöht werden.
  • Qualitätsfaktor im Blick behalten
    • Ein Script könnte wichtige Keywords mit ihren Qualitätsfaktoren kennzeichnen und dann regelmäßig Keywords prüfen und Berichte zu Keywords erstellen, deren Qualitätsfaktor nicht mehr mit dem Label übereinstimmt.

Labels auf Kontoebene

Mit Google Ads-Scripts 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 mit der Methode applyLabel auf die gewünschten Konten 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);
}

Ebenso können Sie ein Label mit der Methode removeLabel 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);
}

Am häufigsten werden Kontolabels 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 in einer einzigen Scriptausführung finden Sie in unserem Leitfaden zu Scripts für Verwaltungskonten.

Labels in einem Konto

Sie können Labels für die Kampagnen, Anzeigengruppen, Anzeigen und Keywords eines Kontos erstellen und anwenden. So fügen Sie einer Kampagne ein Label hinzu:

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

Ebenso können Sie ein Label mit 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 nach einem Label gruppiert sind. Im folgenden Code-Snippet wird gezeigt, 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();
}

Berichte

Sie können Labelressourcennamen verwenden, um bei der Ausführung von Leistungsberichten für Google Ads-Konten nach Entitäten zu filtern. Ressourcennamen sind ein Konzept aus der Google Ads API und werden manchmal beim Ausführen von Berichten mit GAQL verwendet. Der Name einer Labelressource hat immer das Format:

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

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

Im folgenden Code-Snippet wird gezeigt, 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);

Beachten Sie, dass Sie zum Filtern nach Labelressourcennamen nur die Operatoren CONTAINS_ALL, CONTAINS_ANY und CONTAINS_NONE verwenden können.