Anzeigenerweiterungs-Skripts migrieren

Wichtig: Sie können weiterhin über die alte Google Ads-Script-Version mit Ihren aktuellen feedbasierten Erweiterungen arbeiten. Feedbasierte Erweiterungen werden jedoch bald eingestellt und assetbasierte Erweiterungen sind nur in der neuen Google Ads-Scriptlaufzeit verfügbar. Wir empfehlen, Ihre bisherigen Google Ads-Scripts so bald wie möglich auf die neue Version von Google Ads-Scripts umzustellen.

In diesem Dokument wird der Migrationsprozess für Skripts beschrieben, die auf Anzeigenerweiterungen zugreifen oder diese verwalten. Ab dem 28. März 2022 werden die feedbasierten Erweiterungen von Kunden, die Skripts zum Aktualisieren von Anzeigenerweiterungen verwenden, zu neuen assetbasierten Erweiterungen migriert. Ab dem 13. Mai 2022 werden die feedbasierten Erweiterungen von Kunden, die Skripts zum Abrufen von Anzeigenerweiterungen, aber keine Skripts zum Aktualisieren von Anzeigenerweiterungen verwenden, auf neue assetbasierte Erweiterungen umgestellt.

Übersicht

Hinweis: Wenn Sie keine Scripts haben, die auf Anzeigenerweiterungen zugreifen oder diese aktualisieren, sind keine Maßnahmen erforderlich. Sie können stattdessen den Leitfaden zu Anzeigenerweiterungen lesen.

Das bestehende Paradigma für feedbasierte Erweiterungen wird zugunsten von assetbasierten Erweiterungen eingestellt. In der Google Ads-Benutzeroberfläche werden feedbasierte Erweiterungen als „alte Erweiterungen“ bezeichnet. In der Google Ads-Benutzeroberfläche werden assetbasierte Erweiterungen als „aktualisierte Erweiterungen“ bezeichnet.

Ab dem 28. März 2022 werden feedbasierte Erweiterungen zu neuen assetbasierten Erweiterungen migriert. Nach der Migration werden feedbasierte Erweiterungen nicht mehr ausgeliefert. In diesem Leitfaden wird die Migration beschrieben, unabhängig davon, ob Sie in Ihrem Google Ads-Konto sowohl feedbasierte als auch assetbasierte Anzeigenerweiterungen oder nur feedbasierte Anzeigenerweiterungen haben.

Migrationsdetails

Wenn Sie auf assetbasierte Anzeigenerweiterungen zugreifen oder sie aktualisieren möchten, müssen Sie die neuen Google Ads-Skripts verwenden. Informationen zu den neuen Google Ads-Scripts finden Sie im Einführungsleitfaden.

Anzeigenerweiterungen abrufen

Mit den vorhandenen Auswahltools für Anzeigenerweiterungen (z. B. SitelinkSelector) können entweder feedbasierte oder assetbasierte Anzeigenerweiterungen abgerufen werden. Standardmäßig wird mit dieser Auswahl der Anzeigenerweiterungstyp zurückgegeben, der derzeit bereitgestellt wird. In der folgenden Tabelle sind die Arten von Anzeigen-Assets zusammengefasst, die derzeit ausgeliefert werden (und daher standardmäßig zurückgegeben werden):

Art der Anzeigenerweiterungen im Konto
Nur feedbasierte Anzeigenerweiterungen	Feedbasierte Anzeigenerweiterungen werden standardmäßig zurückgegeben.
Nur assetbasierte Anzeigenerweiterungen	Asset-basierte Anzeigenerweiterungen werden standardmäßig zurückgegeben
Sowohl feed- als auch assetbasierte Anzeigenerweiterungen	Asset-basierte Anzeigenerweiterungen werden standardmäßig zurückgegeben

Nachdem alle feedbasierten Anzeigenerweiterungen migriert wurden, werden in allen Auswahltools für Anzeigenerweiterungen standardmäßig assetbasierte Anzeigenerweiterungen zurückgegeben. Sie können weiterhin feedbasierte Anzeigenerweiterungen mit der Methode withOnlyLegacy abrufen. Dies ist nützlich, um bisherige Messwerte zu erfassen.

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

In den meisten Fällen sind vor oder nach der Migration von feedbasierten Anzeigenerweiterungen keine Codeänderungen erforderlich. Es gibt jedoch einige Szenarien, in denen Codeänderungen erforderlich sein könnten.

Anzeigenerweiterungen nach ID filtern

Wenn eine feedbasierte Anzeigenerweiterung migriert wird, hat die entsprechende assetbasierte Anzeigenerweiterung eine andere ID. Wenn Ihr Script derzeit Anzeigenerweiterungen nach ID filtert, können keine assetbasierten Anzeigenerweiterungen abgerufen werden.

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

Sie können entweder nach einem anderen Attribut filtern oder Ihren Code so aktualisieren, dass stattdessen die IDs der assetbasierten Anzeigen-Erweiterungen verwendet werden.

Anzeigenerweiterungen nach Statistiken filtern

Wenn eine feedbasierte Anzeigenerweiterung migriert wird, werden die Statistiken der entsprechenden assetbasierten Anzeigenerweiterung zurückgesetzt. Berücksichtigen Sie dies, wenn Sie Anzeigenerweiterungen nach Statistiken filtern. Wenn Sie beispielsweise Sitelink-Erweiterungen mit Clicks > 100 in der LAST_MONTH anfordern, sehen Sie möglicherweise weniger Anzeigenerweiterungen als normal, wenn Ihre feedbasierten Anzeigenerweiterungen vor Kurzem migriert wurden.

Berücksichtigen Sie dies auch, wenn Sie Leistungsberichte für Ihre Anzeigenerweiterungen erstellen. Wenn Sie Ihre feedbasierten Anzeigen-Erweiterungen migrieren, kann es in Ihren Berichten zu erheblichen Schwankungen oder Rückgängen kommen.

Eingestellte Methoden

Im Rahmen der Migration werden mehrere Felder nicht mehr unterstützt. Beispielsweise werden Start- und Enddatum für Snippet-Erweiterungen nicht mehr unterstützt. Bei Aufrufen von getStartDate() wird null zurückgegeben. Außerdem wird eine Warnmeldung protokolliert. In der folgenden Tabelle sehen Sie, welche Methoden eingestellt werden:

Klasse	Eingestellte Methoden
Zusatzinformationen	Keine eingestellten Methoden
MobileApp	getSchedules
PhoneNumber	getEndDate getStartDate
Preis	getEndDate getSchedules getStartDate
Sitelink	Keine eingestellten Methoden
Snippet	getEndDate getSchedules getStartDate

Anzeigenerweiterungen aktualisieren

Im Rahmen der Migration werden mehrere Felder nicht mehr unterstützt. So sind beispielsweise das Start- und das Enddatum für Snippet-Erweiterungen nicht mehr verfügbar. Anrufe an setStartDate haben keine Auswirkungen auf die Anzeigenerweiterung. Außerdem wird eine Warnmeldung protokolliert. In der folgenden Tabelle sehen Sie, welche Methoden eingestellt werden:

Klasse	Eingestellte Methoden
Zusatzinformationen	Keine eingestellten Methoden
MobileApp	setSchedules
PhoneNumber	clearEndDate clearStartDatesetEndDate setStartDate
Preis	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
Sitelink	Keine eingestellten Methoden
Snippet	clearEndDate clearStartDatesetEndDate setSchedules setStartDate

Anzeigenerweiterungen erstellen

Mit den vorhandenen Tools zur Anzeigenerstellung (z. B. SitelinkBuilder) können Sie entweder feedbasierte oder assetbasierte Anzeigenerweiterungen erstellen. Standardmäßig wird mit diesen Tools der Anzeigen-Add-on-Typ erstellt, der derzeit ausgeliefert wird. In der folgenden Tabelle sind die Arten von Anzeigen-Assets zusammengefasst, die derzeit ausgeliefert werden (und daher standardmäßig erstellt werden):

Art der Anzeigenerweiterungen im Konto
Nur feedbasierte Anzeigenerweiterungen	Feedbasierte Anzeigenerweiterungen werden standardmäßig erstellt
Nur assetbasierte Anzeigenerweiterungen	Assetbasierte Anzeigenerweiterungen werden standardmäßig erstellt
Sowohl feed- als auch assetbasierte Anzeigenerweiterungen	Asset-basierte Anzeigenerweiterungen werden standardmäßig erstellt

Nachdem die Erweiterungen eines Kunden migriert wurden, werden in allen Tools zum Erstellen von Anzeigenerweiterungen standardmäßig assetbasierte Anzeigenerweiterungen erstellt. Das Erstellen von feedbasierten Anzeigen-Erweiterungen wird nicht mehr unterstützt, da sie nicht mehr ausgeliefert werden.

Wenn Sie eine feedbasierte Erweiterung erstellen möchten, anstatt sich auf das Standardverhalten zu verlassen, können Sie build(true) anstelle von build() aufrufen. Beispiel:

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

Wenn Sie eine assetbasierte Erweiterung erstellen möchten und in Ihrem Konto derzeit nur feedbasierte Erweiterungen vorhanden sind, können Sie entweder bis zum 28. März warten oder build(false) anrufen.

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

Nicht unterstützte Felder

Im Rahmen der Migration von Anzeigenerweiterungen wurden bestimmte Felder eingestellt. So sind beispielsweise das Start- und das Enddatum für Snippet-Erweiterungen nicht mehr verfügbar. Aufrufe von withEndDate oder withStartDate haben keine Auswirkungen auf die Erweiterung. Stattdessen wird eine Warnmeldung protokolliert. In der folgenden Tabelle sehen Sie, welche Methoden für jede Klasse eingestellt werden:

Klasse	Eingestellte Methoden
CalloutBuilder	withMobilePreferred
MobileAppBuilder	withMobilePreferred withSchedules
PhoneNumberBuilder	withEndDate withMobilePreferred withStartDate
PriceBuilder	withEndDate withMobilePreferred withSchedules withStartDate
SitelinkBuilder	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate