Memigrasikan Skrip Ekstensi Iklan

Penting: Anda dapat terus menggunakan ekstensi berbasis feed saat ini melalui pengalaman Skrip Google Ads lama. Namun, ekstensi berbasis feed tidak akan lama lagi tersedia dan ekstensi berbasis aset hanya tersedia di Google Ads Skrip 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 dari pelanggan dengan skrip yang memperbarui ekstensi iklan akan dimigrasikan ke ekstensi berbasis aset baru. Mulai 13 Mei 2022, pelanggan dengan skrip yang mengambil ekstensi iklan (dan tidak ada skrip yang memperbarui ekstensi iklan) akan memigrasikan ekstensi berbasis feed mereka ke ekstensi berbasis aset baru.

Ringkasan

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

Paradigma ekstensi berbasis feed yang ada tidak digunakan lagi dan diganti 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, baik Anda memiliki ekstensi iklan berbasis feed maupun 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 versi Skrip Google Ads yang baru. Untuk informasi tentang pengalaman Skrip Google Ads versi baru, lihat Panduan memulai.

Mengambil ekstensi iklan

Kumpulan pemilih Ekstensi Iklan yang ada (misalnya, SitelinkSelector dapat mengambil ekstensi iklan berbasis feed atau ekstensi iklan berbasis aset. Secara default, pemilih ini akan menampilkan jenis ekstensi iklan yang saat ini ditayangkan. Tabel berikut merangkum jenis ekstensi iklan yang saat ini ditayangkan (dan 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 tetap 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 yang memerlukan perubahan kode.

Memfilter ekstensi iklan menurut ID

Saat ekstensi iklan berbasis feed dimigrasikan, ekstensi iklan berbasis aset yang sesuai akan memiliki ID yang berbeda. Artinya, jika saat ini skrip Anda 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 lain 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 menurut 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 mengingat hal ini saat membuat laporan performa untuk ekstensi iklan. Laporan Anda dapat 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 tidak digunakan lagi dari ekstensi Ringkasan. 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:

Kelas	Metode yang tidak digunakan lagi
Info	Tidak ada metode yang tidak digunakan lagi
MobileApp	getSchedules
NomorTelepon	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 tidak digunakan lagi dari ekstensi Cuplikan. Panggilan ke setStartDate tidak akan memengaruhi ekstensi iklan. Selain itu, pesan peringatan akan dicatat ke dalam log. Lihat tabel berikut untuk memahami metode mana yang tidak digunakan lagi:

Kelas	Metode yang tidak digunakan lagi
Info	Tidak ada metode yang tidak digunakan lagi
MobileApp	setSchedules
NomorTelepon	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 ada (misalnya, SitelinkBuilder dapat membuat ekstensi iklan berbasis feed atau ekstensi iklan berbasis aset. Secara default, builder ini akan membuat jenis ekstensi iklan yang saat ini ditayangkan. Tabel berikut merangkum jenis ekstensi iklan yang saat ini ditayangkan (dan 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 ekstensi 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, bukan 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 menghubungi 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 tidak digunakan lagi dari ekstensi Ringkasan. Panggilan ke withEndDate atau withStartDate tidak akan memengaruhi ekstensi. Sebagai gantinya, pesan peringatan akan dicatat ke dalam log. Lihat tabel berikut untuk memahami metode mana yang tidak digunakan lagi untuk setiap class:

Kelas	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