Diese Seite wurde von der Cloud Translation API übersetzt.

Anzeigenerweiterungs-Skripts migrieren

In diesem Dokument wird der Migrationsprozess für Skripts beschrieben, die auf Anzeigenerweiterungen zugreifen oder diese verwalten. Ab dem 28. März 2022 werden bei Kunden, deren Anzeigenerweiterungen mithilfe von Skripts aktualisiert werden, ihre feedbasierten Erweiterungen auf neue assetbasierte Erweiterungen umgestellt. Ab dem 13. Mai 2022 werden bei Kunden mit Skripts, die Anzeigenerweiterungen abrufen (und ohne Skripts, die Anzeigenerweiterungen aktualisieren), ihre feedbasierten Erweiterungen zu neuen assetbasierten Erweiterungen migriert.

Überblick

Das bestehende feedbasierte Modell wurde eingestellt und durch assetbasierte Erweiterungen ersetzt. Feedbasierte Erweiterungen werden in der Google Ads-Benutzeroberfläche als „alte“ Erweiterungen bezeichnet. Asset-basierte Erweiterungen werden in der Google Ads-Benutzeroberfläche als „verbesserte“ Erweiterungen bezeichnet.

Ab dem 28. März 2022 werden feedbasierte Erweiterungen auf neue assetbasierte Erweiterungen umgestellt. 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 feed- als auch assetbasierte Anzeigenerweiterungen oder nur feedbasierte Anzeigenerweiterungen in Ihrem Konto verwenden.

Migrationsdetails

Wenn Sie assetbasierte Anzeigenerweiterungen aufrufen oder aktualisieren möchten, müssen Sie die neue Google Ads-Scripts-Oberfläche verwenden. Informationen zur neuen Version von Google Ads-Skripts finden Sie unter Erste Schritte.

Anzeigenerweiterungen werden abgerufen

Mit den vorhandenen Anzeigenerweiterungs-Selektoren (z. B. der SitelinkSelector) können entweder feed- oder assetbasierte Anzeigenerweiterungen abgerufen werden. Standardmäßig wird mit diesen Selektoren der derzeit bereitgestellte Anzeigenerweiterungstyp zurückgegeben. In der folgenden Tabelle ist der Typ der Anzeigenerweiterung zusammengefasst, die derzeit ausgeliefert und daher standardmäßig zurückgegeben wird:

Typ 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 bei der Anzeigenerweiterungsauswahl standardmäßig assetbasierte Anzeigenerweiterungen zurückgegeben. Es ist weiterhin möglich, feedbasierte Anzeigenerweiterungen mit der Methode withOnlyLegacy abzurufen. Dies ist nützlich, um historische 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 feedbasierter Anzeigenerweiterungen keine Änderungen am Code erforderlich. Es gibt jedoch einige Szenarien, in denen Codeänderungen erforderlich sein können.

Anzeigenerweiterungen nach ID filtern

Wenn eine feedbasierte Anzeigenerweiterung migriert wird, hat die entsprechende assetbasierte Anzeigenerweiterung eine andere ID. Wenn Ihr Skript also 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();

Um dieses Problem zu beheben, sollten Sie entweder nach einem anderen Attribut filtern oder Ihren Code so aktualisieren, dass stattdessen die IDs der Asset-basierten Anzeigenerweiterungen verwendet werden.

Anzeigenerweiterungen nach Statistiken filtern

Wenn eine feedbasierte Anzeigenerweiterung migriert wird, werden die Statistiken der entsprechenden assetbasierten Anzeigenerweiterung zurückgesetzt. Dies sollten Sie berücksichtigen, wenn Sie Anzeigenerweiterungen nach Statistiken filtern. Wenn Sie beispielsweise Sitelink-Erweiterungen mit Clicks > 100 im LAST_MONTH anfordern, sehen Sie möglicherweise weniger Anzeigenerweiterungen als gewöhnlich, wenn Ihre feedbasierten Anzeigenerweiterungen kürzlich migriert wurden.

Berücksichtigen Sie dies auch, wenn Sie Leistungsberichte für Ihre Anzeigenerweiterungen erstellen. In Ihren Berichten können erhebliche Veränderungen oder Rückgänge auftreten, wenn Ihre feedbasierten Anzeigenerweiterungen migriert werden.

Verworfene Methoden

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

Klasse	Verworfene Methoden
Buchstabe in Abbildung	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 einige Felder nicht mehr unterstützt. Beispielsweise wurden Start- und Enddatum bei Snippet-Erweiterungen eingestellt. Aufrufe an setStartDate haben keine Auswirkungen auf die Anzeigenerweiterung. Außerdem wird eine Warnmeldung protokolliert. In der folgenden Tabelle sehen Sie, welche Methoden verworfen wurden:

Klasse	Verworfene Methoden
Buchstabe in Abbildung	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 Erstellung von Anzeigenerweiterungen (z. B. SitelinkBuilder) können Sie entweder feed- oder assetbasierte Anzeigenerweiterungen erstellen. Mit diesen Tools wird standardmäßig der aktuell bereitgestellte Anzeigenerweiterungstyp erstellt. In der folgenden Tabelle ist der Typ der Anzeigenerweiterung zusammengefasst, die derzeit ausgeliefert und somit standardmäßig erstellt wird:

Typ der Anzeigenerweiterungen im Konto
Nur feedbasierte Anzeigenerweiterungen	Standardmäßig werden feedbasierte Anzeigenerweiterungen erstellt.
Nur assetbasierte Anzeigenerweiterungen	Asset-basierte 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, erstellen alle Tools zur Anzeigenerweiterungs-Toolerstellung standardmäßig assetbasierte Anzeigenerweiterungen. Das Erstellen von feedbasierten Anzeigenerweiterungen ist nicht mehr möglich, da feedbasierte Anzeigenerweiterungen nicht mehr ausgeliefert werden.

Wenn Sie eine feedbasierte Erweiterung erstellen möchten, statt sich auf das Standardverhalten zu verlassen, können Sie build(true) statt 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) aufrufen.

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 der Anzeigenerweiterungen wurden bestimmte Felder eingestellt. Beispielsweise wurden Start- und Enddatum in Snippet-Erweiterungen eingestellt. Aufrufe an withEndDate oder withStartDate haben keine Auswirkungen auf die Erweiterung. Stattdessen wird eine Warnmeldung protokolliert. In der folgenden Tabelle sehen Sie, welche Methoden für die einzelnen Klassen verworfen wurden:

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