Ta strona została przetłumaczona przez Cloud Translation API.

Migrowanie skryptów rozszerzeń reklam

W tym dokumencie opisujemy proces migracji skryptów, które uzyskują dostęp do rozszerzeń reklam i nimi zarządzają. Od 28 marca 2022 r. rozszerzenia oparte na plikach danych będą przekształcane w rozszerzenia oparte na plikach danych w przypadku klientów korzystających ze skryptów aktualizujących rozszerzenia reklam do nowych rozszerzeń opartych na komponentach. Od 13 maja 2022 r. rozszerzenia oparte na plikach danych będą przenoszone do nowych rozszerzeń opartych na zasobach w przypadku klientów korzystających ze skryptów pobierających rozszerzenia reklam (ale bez skryptów aktualizujących rozszerzenia reklam).

Przegląd

Obecny model rozszerzeń opartych na plikach danych został wycofany i zastąpiony rozszerzeniami opartymi na zasobach. Rozszerzenia oparte na plikach danych są w interfejsie Google Ads nazywane rozszerzeniami „starsza wersja”, a rozszerzenia oparte na komponentach – w interfejsie Google Ads.

Od 28 marca 2022 r. rozszerzenia oparte na plikach danych zostaną przekształcone w nowe rozszerzenia oparte na zasobach – po migracji rozszerzenia oparte na plikach danych przestaną się wyświetlać. Z tego przewodnika dowiesz się, jak przeprowadzić migrację, niezależnie od tego, czy masz na koncie Google Ads zarówno rozszerzenia reklam oparte na pliku danych, jak i oparte na komponentach, czy tylko rozszerzenia reklam oparte na pliku danych.

Szczegóły migracji

Aby uzyskać dostęp do rozszerzeń reklam opartych na komponentach lub je aktualizować, musisz użyć nowej wersji skryptów Google Ads. Więcej informacji o nowej wersji skryptów Google Ads znajdziesz w przewodniku dla początkujących.

Pobieram rozszerzenia reklam

Obecny zestaw selektorów rozszerzeń reklam (np. SitelinkSelector) umożliwia pobieranie rozszerzeń reklam opartych na pliku danych lub rozszerzeń reklam opartych na zasobach. Domyślnie selektory te zwracają aktualnie wyświetlany typ rozszerzenia reklamy. W tabeli poniżej znajdziesz podsumowanie typu rozszerzenia reklamy, które obecnie się wyświetla (i będzie zwracane domyślnie):

Typ rozszerzeń reklam na koncie
Tylko rozszerzenia reklam oparte na plikach danych	Rozszerzenia reklam oparte na pliku danych będą zwracane domyślnie
Tylko rozszerzenia reklam oparte na komponentach	Rozszerzenia reklam oparte na zasobach będą zwracane domyślnie
Rozszerzenia reklam oparte na plikach danych i komponentach	Rozszerzenia reklam oparte na zasobach będą zwracane domyślnie

Po przeniesieniu wszystkich rozszerzeń reklam opartych na plikach danych wszystkie selektory rozszerzeń reklam będą domyślnie zwracać rozszerzenia reklam oparte na komponentach. Rozszerzenia reklam oparte na pliku danych nadal będzie można pobierać za pomocą metody withOnlyLegacy. Jest to przydatne przy gromadzeniu danych historycznych.

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

W większości przypadków przed migracją rozszerzeń reklam opartych na pliku danych lub po ich przeniesieniu nie są wymagane żadne zmiany w kodzie. Istnieje jednak kilka sytuacji, w których konieczne mogą być zmiany w kodzie.

Filtrowanie rozszerzeń reklam według identyfikatora

Po przeniesieniu rozszerzenia reklamy opartego na pliku danych odpowiednie rozszerzenie reklamy oparte na komponentach będzie miało inny identyfikator. Oznacza to, że jeśli skrypt obecnie filtruje rozszerzenia reklam według identyfikatora, nie może pobrać tych rozszerzeń.

// 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();

Aby rozwiązać ten problem, zastosuj filtr według innego atrybutu lub zaktualizuj kod, tak aby korzystał z identyfikatorów rozszerzeń reklam opartych na zasobach.

Filtrowanie rozszerzeń reklam według statystyk

Po przeniesieniu rozszerzenia reklamy opartego na pliku danych statystyki odpowiedniego rozszerzenia reklamy opartego na komponentach zostaną zresetowane. Należy wziąć to pod uwagę, filtrując rozszerzenia reklam według statystyk. Jeśli na przykład wyślesz żądanie rozszerzeń linków do podstron z parametrem Clicks > 100 w elemencie LAST_MONTH, po przeniesieniu rozszerzeń reklam opartych na pliku danych możesz zobaczyć mniej takich rozszerzeń niż zwykle.

Pamiętaj o tym również podczas generowania raportów skuteczności rozszerzeń reklam. Po przeniesieniu rozszerzeń reklam opartych na pliku danych w raportach mogą pojawić się znaczne zmiany lub spadki.

Wycofane metody

W ramach migracji niektóre pola nie są już obsługiwane. Na przykład daty rozpoczęcia i zakończenia zostały wycofane z rozszerzeń informacji. Połączenia z numerem getStartDate() będą zwracane null. Dodatkowo rejestrowany jest komunikat ostrzegawczy. W tej tabeli znajdziesz informacje o tym, które metody zostały wycofane:

Klasa	Wycofane metody
Objaśnienie	Brak wycofanych metod
MobileApp	`getSchedules`
PhoneNumber	`getEndDate` `getStartDate`
Cena	`getEndDate` `getSchedules` `getStartDate`
Link do podstrony	Brak wycofanych metod
Krótki opis	`getEndDate` `getSchedules` `getStartDate`

Aktualizacja rozszerzeń reklam

W ramach migracji niektóre pola nie są już obsługiwane. Na przykład daty rozpoczęcia i zakończenia zostały wycofane z rozszerzeń informacji. Wywołania setStartDate nie będą miały wpływu na rozszerzenie reklamy. Dodatkowo zostanie zarejestrowany komunikat ostrzegawczy. W tej tabeli znajdziesz informacje o tym, które metody zostały wycofane:

Klasa	Wycofane metody
Objaśnienie	Brak wycofanych metod
MobileApp	`setSchedules`
PhoneNumber	`clearEndDate` `clearStartDatesetEndDate` `setStartDate`
Cena	`clearEndDate` `clearStartDatesetEndDate` `setSchedules` `setStartDate`
Link do podstrony	Brak wycofanych metod
Krótki opis	`clearEndDate` `clearStartDatesetEndDate` `setSchedules` `setStartDate`

Tworzenie rozszerzeń reklam

Dotychczasowy zestaw kreatorów rozszerzeń reklam (np. SitelinkBuilder) umożliwia tworzenie rozszerzeń reklam opartych na pliku danych lub rozszerzeń reklam opartych na komponentach. Domyślnie te kreatory utworzą każdy typ rozszerzenia reklam, który jest wyświetlany w danej chwili. W tabeli poniżej znajdziesz podsumowanie typu rozszerzenia reklamy, które obecnie się wyświetla (i zostanie utworzone domyślnie):

Typ rozszerzeń reklam na koncie
Tylko rozszerzenia reklam oparte na plikach danych	Rozszerzenia reklam oparte na pliku danych zostaną utworzone domyślnie
Tylko rozszerzenia reklam oparte na komponentach	Rozszerzenia reklam oparte na zasobach zostaną utworzone domyślnie
Rozszerzenia reklam oparte na plikach danych i komponentach	Rozszerzenia reklam oparte na zasobach zostaną utworzone domyślnie

Gdy rozszerzenia zostaną przeniesione, wszystkie kreatory rozszerzeń reklam będą domyślnie tworzyć rozszerzenia reklam oparte na komponentach. Tworzenie rozszerzeń reklam opartych na pliku danych nie będzie już obsługiwane, ponieważ rozszerzenia reklam oparte na pliku danych nie będą już wyświetlane.

Jeśli chcesz utworzyć rozszerzenie oparte na pliku danych, zamiast polegać na domyślnym działaniu, możesz to zrobić, wywołując build(true) zamiast build(), na przykład:

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();

Jeśli chcesz utworzyć rozszerzenie oparte na komponentach, a na koncie znajdują się obecnie tylko rozszerzenia oparte na pliku danych, możesz poczekać do 28 marca lub zadzwonić pod numer build(false).

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();

Nieobsługiwane pola

W ramach migracji rozszerzeń reklam niektóre pola zostały wycofane. Na przykład daty rozpoczęcia i zakończenia zostały wycofane z rozszerzeń informacji. Wywołania withEndDate i withStartDate nie będą miały żadnego wpływu na rozszerzenie – zamiast tego będzie rejestrowany komunikat z ostrzeżeniem. W tej tabeli znajdziesz informacje o tym, które metody zostały wycofane w przypadku poszczególnych klas:

Klasa	Wycofane metody
CalloutBuilder	`withMobilePreferred`
MobileAppBuilder	`withMobilePreferred` `withSchedules`
PhoneNumberBuilder	`withEndDate` `withMobilePreferred` `withStartDate`
PriceBuilder	`withEndDate` `withMobilePreferred` `withSchedules` `withStartDate`
SitelinkBuilder	`withMobilePreferred`
SnippetBuilder	`withEndDate` `withMobilePreferred` `withSchedules` `withStartDate`