Labels

Mit Labels können Sie Elemente in Ihrem Konto in aussagekräftige Gruppen unterteilen. So können Sie die Ergebnisse schnell filtern und Berichte zu den Daten erstellen, die für Sie am wichtigsten sind. Google Ads-Scripts 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-Einheiten zu verknüpfen. In Verwaltungskonten können Labels verwendet werden, um ähnliche untergeordnete Konten zu gruppieren. Labels können für verschiedene Anwendungsfälle hilfreich sein:

• Liste mit Konten verarbeiten
  • Wenn Sie eine Agentur sind, können Sie beispielsweise das Label plumber_accounts auf alle Konten für Klempner anwenden. Anschließend können Sie mit einem Script Keywords für Klempner (z. B. „Dusche reparieren“) in alle Kampagnen in diesen Konten einfügen.
• Liste von Entitäten verarbeiten
  • Wenn Sie eine Gruppe von Keywords haben, die nur am Wochenende aktiviert werden sollen, können Sie das Label weekend_keywords darauf anwenden. Ein Skript könnte dann alle Keywords mit weekend_keywords am Freitagabend aktivieren und am Montagmorgen pausieren.
• Entitäten über mehrere Läufe hinweg verarbeiten
  • Wenn Sie eine große Anzahl von Einheiten haben, die nicht in weniger als 30 Minuten verarbeitet werden können, können Sie in Ihrem Script ein processed-Label erstellen und es auf bereits verarbeitete Einheiten anwenden. Planen Sie das Skript 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 Gebot für eine große Anzahl von Keywords über das Skript ändern zu lassen, können Sie die Keywords mit increase_bid_by_10% kennzeichnen, sich in der Google Ads-Benutzeroberfläche anmelden, die Keywords mit dem Label herausfiltern, sie überprüfen und, wenn Sie mit dem Ergebnis zufrieden sind, die Gebote mit Bulk-Bearbeitungen ändern.
• Flexible Gebote
  • Ein Skript kann Labels verwenden, um den Verlauf der Gebotsänderungen zu erfassen. Wenn ein Script beispielsweise das Gebot für ein Keyword um 20 % erhöht, kann es das Konto mit dem Label increased_20% kennzeichnen. Am nächsten Tag wird das Gebot beim Ausführen des Skripts für das Label nur um 10 % erhöht, da es bereits zuvor erhöht wurde.
• Qualitätsfaktor im Blick behalten
  • In einem Skript könnten wichtige Keywords mit ihrem Qualitätsfaktor gekennzeichnet werden. Anschließend wird regelmäßig geprüft, ob der Qualitätsfaktor der Keywords noch mit dem Label übereinstimmt.

Labels auf Kontoebene

Mit Google Ads-Skripts können Sie Labels in Verwaltungskonten erstellen und Labels auf Google Ads-Konten unter 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);
}

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 zum Verarbeiten mehrerer Konten in einem einzigen Skriptlauf finden Sie in unserem Leitfaden zu Verwaltungskonto-Skripts.

Labels in einem Konto

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

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

Sie können ein Label auch 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 Gruppe ähnlicher Entitäten zu verarbeiten, die durch ein Label zusammengefasst werden. Das folgende Code-Snippet zeigt, wie Sie eine Gruppe von Kampagnen pausieren, die ein gemeinsames Label haben:

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 Label-Ressourcennamen verwenden, um Entitäten zu filtern, wenn Sie Leistungsberichte für Google Ads-Konten erstellen. Ressourcennamen sind ein Konzept aus der Google Ads API und werden manchmal verwendet, wenn Berichte mit GAQL erstellt werden. Ein Label-Ressourcenname hat immer das folgende Format:

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

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

Das folgende Code-Snippet zeigt, wie Sie einen Kampagnenbericht für alle Kampagnen mit dem Label „Weihnachtsangebote“ ausführen:

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 Label-Ressourcennamen nur die Operatoren CONTAINS_ALL, CONTAINS_ANY und CONTAINS_NONE verwenden können.