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-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 können Labels verwendet werden, um ähnliche untergeordnete Konten zu gruppieren. Labels sind in einer Reihe von Anwendungsfällen hilfreich:

  • Liste von Konten verarbeiten
    • Wenn Sie eine Agentur sind, können Sie allen Konten für Klempner das Label plumber_accounts zuweisen. Anschließend kann ein Skript Keywords für Klempner (z. B. „Notfallreparatur Dusche“) in alle Kampagnen in diesen Konten einfügen.
  • Liste von Entitäten verarbeiten
    • Wenn Sie eine Reihe von Keywords haben, die nur an Wochenenden aktiviert werden sollen, können Sie ihnen das Label weekend_keywords zuweisen. Ein Skript kann dann alle Keywords mit weekend_keywords am Freitagabend aktivieren und am Montagmorgen pausieren.
  • Entitäten in mehreren Ausführungen 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 Skript ein Label processed erstellen und es auf Entitäten anwenden, die bereits verarbeitet wurden. Planen Sie die Ausführung des Skripts stündlich und verarbeiten Sie dann nur Entitäten, auf die das Label processed nicht angewendet wurde.
  • Ä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 increase_bid_by_10% kennzeichnen, sich in der Google Ads-Benutzeroberfläche anmelden, die Keywords herausfiltern, die dem Label entsprechen, sie überprüfen und bei Zufriedenheit mit dem Ergebnis die Gebote mithilfe von Massenbearbeitungen ändern.
  • Flexible Gebote
    • Ein Skript kann Labels verwenden, um den Verlauf der Gebotsänderungen zu erfassen. Wenn ein Skript beispielsweise ein Keyword-Gebot um 20 % erhöht, kann es das Konto mit dem Label increased_20% kennzeichnen. Wenn das Skript am nächsten Tag das Label durchläuft und feststellt, dass das Gebot bereits erhöht wurde, kann es das Gebot nur um 10 % erhöhen.
  • Tracking des Qualitätsfaktors
    • Ein Skript kann wichtige Keywords mit ihren Qualitätsfaktoren kennzeichnen und dann regelmäßig prüfen und Berichte zu Keywords erstellen, deren Qualitätsfaktor nicht mehr 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);

Mit der applyLabel Methode können Sie das Label 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 removeLabel Methode 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);
}

Labels auf Kontoebene werden am häufigsten verwendet, um eine Gruppe von Konten zu verarbeiten, die dasselbe Label haben:

const labelName = 'High spending accounts';

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

Weitere Informationen zur Verarbeitung mehrerer Konten in einer einzigen Skriptausführung finden Sie in unserem Leitfaden zu Skripts 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 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');

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

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

Sie können den Ressourcennamen eines Labels mit der getResourceName Methode 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 nur die Operatoren CONTAINS_ALL, CONTAINS_ANY und CONTAINS_NONE verwenden können, um nach Ressourcennamen von Labels zu filtern.