Memigrasikan Skrip Ekstensi Iklan

Penting: Anda dapat terus menggunakan ekstensi berbasis feed saat ini melalui Skrip Google Ads versi lama. Namun, ekstensi berbasis feed akan segera tidak tersedia dan ekstensi berbasis aset hanya tersedia di Skrip Google Ads versi baru. Sebaiknya migrasikan Skrip Google Ads lama Anda ke Skrip Google Ads versi baru sesegera mungkin.

Dokumen ini menjelaskan proses migrasi untuk skrip yang mengakses atau mengelola ekstensi iklan. Mulai 28 Maret 2022, ekstensi berbasis feed akan dimigrasikan ke ekstensi berbasis aset baru untuk pelanggan dengan skrip yang memperbarui ekstensi iklan. Mulai 13 Mei 2022, ekstensi berbasis feed akan dimigrasikan ke ekstensi berbasis aset baru untuk pelanggan yang memiliki skrip yang mengambil ekstensi iklan (dan tidak memiliki skrip yang memperbarui ekstensi iklan).

Ringkasan

Catatan: Jika Anda tidak memiliki skrip yang mengakses atau memperbarui ekstensi iklan, Anda tidak perlu melakukan apa pun dan sebagai gantinya Anda dapat merujuk ke panduan ekstensi iklan.

Paradigma ekstensi berbasis feed yang ada tidak digunakan lagi dan digantikan dengan ekstensi berbasis aset. Ekstensi berbasis feed disebut sebagai ekstensi "Lama" di UI Google Ads, sedangkan ekstensi berbasis aset disebut sebagai ekstensi "Diupgrade" di UI Google Ads.

Mulai 28 Maret 2022, ekstensi berbasis feed akan dimigrasikan ke ekstensi berbasis aset baru. Setelah dimigrasikan, ekstensi berbasis feed akan berhenti ditayangkan. Panduan ini akan menjelaskan migrasi apakah Anda memiliki ekstensi iklan berbasis feed dan berbasis aset di akun Google Ads atau hanya memiliki ekstensi iklan berbasis feed di akun Anda.

Detail migrasi

Untuk mulai mengakses atau memperbarui ekstensi iklan berbasis aset, Anda harus menggunakan Skrip Google Ads versi baru. Untuk informasi tentang Skrip Google Ads versi baru, lihat Panduan Memulai.

Mengambil ekstensi iklan

Kumpulan pemilih Ekstensi Iklan yang sudah ada (misalnya, SitelinkSelector mampu mengambil ekstensi iklan berbasis feed atau ekstensi iklan berbasis aset. Secara default, pemilih ini akan menampilkan jenis ekstensi iklan apa pun yang saat ini ditayangkan. Tabel berikut merangkum jenis ekstensi iklan yang saat ini ditayangkan (sehingga akan ditampilkan secara default):

Jenis ekstensi iklan di akun
Hanya ekstensi iklan berbasis feed	Ekstensi iklan berbasis feed akan ditampilkan secara default
Hanya ekstensi iklan berbasis aset	Ekstensi iklan berbasis aset akan ditampilkan secara default
Ekstensi iklan berbasis feed dan berbasis aset	Ekstensi iklan berbasis aset akan ditampilkan secara default

Setelah semua ekstensi iklan berbasis feed dimigrasikan, semua pemilih ekstensi iklan akan menampilkan ekstensi iklan berbasis aset secara default. Anda masih dapat mengambil ekstensi iklan berbasis feed dengan metode withOnlyLegacy. Hal ini berguna untuk mengumpulkan metrik historis.

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

Pada umumnya, perubahan kode tidak diperlukan sebelum atau setelah ekstensi iklan berbasis feed dimigrasikan. Namun, ada beberapa skenario saat perubahan kode mungkin diperlukan.

Memfilter ekstensi iklan menurut ID

Saat ekstensi iklan berbasis feed dimigrasikan, ekstensi iklan berbasis aset yang sesuai akan memiliki ID yang berbeda. Artinya, jika skrip Anda saat ini memfilter ekstensi iklan menurut ID, skrip tersebut tidak akan dapat mengambil ekstensi iklan berbasis aset.

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

Untuk mengatasi hal ini, Anda harus memfilter menurut atribut yang berbeda atau memperbarui kode untuk menggunakan ID ekstensi iklan berbasis aset.

Memfilter ekstensi iklan berdasarkan statistik

Saat ekstensi iklan berbasis feed dimigrasikan, statistik ekstensi iklan berbasis aset yang sesuai akan direset. Anda harus mempertimbangkan hal ini saat memfilter ekstensi iklan berdasarkan statistik. Misalnya, jika Anda meminta ekstensi sitelink dengan Clicks > 100 di LAST_MONTH, Anda dapat melihat lebih sedikit ekstensi iklan daripada biasanya jika ekstensi iklan berbasis feed baru saja dimigrasikan.

Anda juga harus memperhatikan hal ini saat membuat laporan performa untuk ekstensi iklan. Laporan Anda mungkin mengalami perubahan atau penurunan yang signifikan saat ekstensi iklan berbasis feed dimigrasikan.

Metode yang tidak digunakan lagi

Sebagai bagian dari migrasi, beberapa kolom tidak lagi didukung. Misalnya, tanggal mulai dan tanggal akhir sudah tidak digunakan lagi dari ekstensi Cuplikan. Panggilan ke getStartDate() akan menampilkan null. Selain itu, pesan peringatan akan dicatat ke dalam log. Lihat tabel berikut untuk memahami metode mana yang tidak digunakan lagi:

Class	Metode yang tidak digunakan lagi
Keterangan	Tidak ada metode yang tidak digunakan lagi
MobileApp	getSchedules
PhoneNumber	getEndDate getStartDate
Harga	getEndDate getSchedules getStartDate
Sitelink	Tidak ada metode yang tidak digunakan lagi
Cuplikan	getEndDate getSchedules getStartDate

Memperbarui ekstensi iklan

Sebagai bagian dari migrasi, beberapa kolom tidak lagi didukung. Misalnya, tanggal mulai dan tanggal akhir sudah tidak digunakan lagi dari ekstensi Cuplikan. Panggilan ke setStartDate tidak akan memengaruhi ekstensi iklan. Selain itu, pesan peringatan akan dicatat. Lihat tabel berikut untuk memahami metode mana yang tidak digunakan lagi:

Class	Metode yang tidak digunakan lagi
Keterangan	Tidak ada metode yang tidak digunakan lagi
MobileApp	setSchedules
PhoneNumber	clearEndDate clearStartDatesetEndDate setStartDate
Harga	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
Sitelink	Tidak ada metode yang tidak digunakan lagi
Cuplikan	clearEndDate clearStartDatesetEndDate setSchedules setStartDate

Membuat ekstensi iklan

Kumpulan pembuat Ekstensi Iklan yang sudah ada (misalnya, SitelinkBuilder mampu membuat ekstensi iklan berbasis feed atau ekstensi iklan berbasis aset. Secara default, pembuat tersebut akan membuat jenis ekstensi iklan apa pun yang saat ini ditayangkan. Tabel berikut meringkas jenis ekstensi iklan yang saat ini ditayangkan (sehingga akan dibuat secara default):

Jenis ekstensi iklan di akun
Hanya ekstensi iklan berbasis feed	Ekstensi iklan berbasis feed akan dibuat secara default
Hanya ekstensi iklan berbasis aset	Ekstensi iklan berbasis aset akan dibuat secara default
Ekstensi iklan berbasis feed dan berbasis aset	Ekstensi iklan berbasis aset akan dibuat secara default

Setelah pelanggan dimigrasikan, semua pembuat ekstensi iklan akan membuat ekstensi iklan berbasis aset secara default. Pembuatan ekstensi iklan berbasis feed tidak akan didukung lagi karena ekstensi iklan berbasis feed tidak akan ditayangkan lagi.

Jika ingin membuat ekstensi berbasis feed daripada mengandalkan perilaku default, Anda dapat melakukannya dengan memanggil build(true), bukan build(), misalnya:

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

Jika ingin membuat ekstensi berbasis aset dan akun Anda saat ini hanya memiliki ekstensi berbasis feed, Anda dapat menunggu hingga 28 Maret atau memanggil 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();

Kolom yang tidak didukung

Sebagai bagian dari migrasi ekstensi iklan, kolom tertentu tidak digunakan lagi. Misalnya, tanggal mulai dan tanggal akhir sudah tidak digunakan lagi dari ekstensi Cuplikan. Panggilan ke withEndDate atau withStartDate tidak akan memengaruhi ekstensi—tetapi pesan peringatan akan dicatat ke dalam log. Lihat tabel berikut untuk memahami metode mana yang tidak digunakan lagi untuk setiap class:

Class	Metode yang tidak digunakan lagi
CalloutBuilder	withMobilePreferred
MobileAppBuilder	withMobilePreferred withSchedules
PhoneNumberBuilder	withEndDate withMobilePreferred withStartDate
PriceBuilder	withEndDate withMobilePreferred withSchedules withStartDate
SitelinkBuilder	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate