Menggunakan fungsi di kolom kustom

Untuk daftar fungsi yang tersedia untuk digunakan di kolom kustom dan pengantar umum, lihat artikel Fungsi di kolom kustom.

Saat membuat formula kolom kustom terkait template, ada opsi sub-menu sensitif konteks pada menu Functions. Arahkan kursor perangkat input ke opsi untuk menampilkan informasi tambahan. Dalam teks formula, klik kanan untuk melihat menu fungsi yang valid untuk konteks saat ini.

Fungsi kolom kustom standar dalam template

Opsi tersebut dapat mencakup hal berikut:

Logic — Opsi untuk fungsi logika standar seperti if, and, not, or, if_error, is_error, dan is_not_finite.
Text — Opsi untuk fungsi teks seperti concat, is_empty, trim, starts_with, ends_with, search, substitute, right, left, contains, upper, lower, length, clean_keyword, string_len_byte, regex_extract, regex_match, regex_replace, search_byte, bmm, reduce_word, title_case, unescape, dan substitute_all.
Arithmetic — Opsi untuk fungsi aritmetika seperti round, ceiling, dan floor.
Conversion — Opsi untuk fungsi konversi seperti to_text, to_number, dan extract_percentage.
Date — Opsi untuk fungsi tanggal seperti date, day, month, quarter, year, weekday, weeknum, daynum, days_between, offset_days, offset_months, offset_years, today, yesterday, week_start_sunday, week_start_monday, month_start, dan year_start yang diuraikan dalam artikel Fungsi di kolom kustom.
Aggregation — Opsi untuk fungsi agregasi seperti min, max, dan any.

Fungsi kolom kustom template

Ada berbagai fungsi kolom kustom yang secara khusus tersedia dalam konteks template. Berbagai fungsi ini dijelaskan dalam tabel berikut.

Catatan

Fungsi ini dapat digunakan dalam fitur Templates.
Jika kata "value" ditampilkan dalam tanda kutip, nilai teks akan diperlukan.
Istilah needle, needles, dan haystack digunakan di beberapa fungsi dalam tabel berikut. “Needle” atau “needles” menunjukkan nilai spesifik yang dapat ditemukan dalam serangkaian nilai, yaitu “haystack”.

Submenu	Jenis nilai yang ditampilkan	Ekspresi fungsi otomatisasi	Deskripsi
Logic	Boolean atau angka	`is_not_finite(value, alternate)`	Mengevaluasi `value`. Jika `value` bukan angka atau angka terbatas, fungsi akan mengevaluasi `alternate`. Jika tidak, fungsi akan menampilkan `value`.
	Boolean, angka, atau teks	`if_error(value, error_value)`	`if_error(value, error_value)` mengevaluasi `value`. Jika `value` menampilkan error, fungsi tersebut akan mengevaluasi alternatif yang ditentukan dalam `error_value`. Jika tidak, fungsi akan menampilkan `value`.
	Boolean, angka, atau teks	`is_error(value)`	Mengevaluasi ke true (benar) jika `value` adalah error.
Text	Teks	`clean_keyword(“text”, “replacement”)`	Memindai string dan mengganti karakter yang tidak didukung platform periklanan untuk kata kunci `text` dengan nilai teks `replacement`.
	Angka	`string_len_byte(“value”)`	Menampilkan jumlah byte dalam atribut feed atau nilai teks.
	Teks	`regex_extract(“value”, “regular_expression”)`	Menelusuri `value` dan menampilkan teks yang cocok dengan `regular_expression`.
	Boolean	`regex_match(“value”, “regular_expression”)`	Mengevaluasi sebagai true (benar) jika `value` cocok dengan semua atau sebagian dari `regular_expression`. Gunakan fungsi ini sebagai kondisi pada fungsi `if`.
	Teks	`regex_replace(“value”, “regular_expression”, “replacement”)`	Menelusuri `value` untuk teks yang cocok dengan `regular_expression`, lalu mengganti teks yang cocok dengan `replacement`.
	Angka atau null	`search_byte(“needle”, “haystack”)`	Menampilkan posisi awal dalam byte instance needle pertama di haystack. Menampilkan null jika needle tidak ada di haystack. Menghitung mulai dari 1 (bukan 0). Selalu menghitung ke arah alami lokalitas pengiklan. Ditujukan terutama untuk bahasa yang tidak menggunakan himpunan karakter Latin, seperti Jepang dan China.
	Teks	`reduce_word(“value”, length, “delimiter”)`	Menampilkan sebanyak mungkin karakter, mulai dari awal string dan penghitungan hingga (tetapi tidak termasuk) pemisah, dengan tetap berada dalam `max_length`. Jika `value` sudah dalam `max_length`, fungsi akan menampilkan `value` persis seperti yang diteruskan.
	Teks	`title_case(“value”)`	Mengonversi `value` menjadi kapitalisasi judul. Anda dapat menentukan atribut feed atau nilai teks statis.
	Teks	`unescape(“value”)`	Mendekode URL yang telah dienkode URL.
	Teks	`substitute_all(“haystack”, replacement, “needles”)`	Mengganti beberapa nilai atribut dengan satu nilai.
Conversion	Angka	`extract_percent(“x%”)`	Mengonversi nilai teks, angka, atau rasio ke persentase.
Aggregation	Boolean, angka, atau teks	`max(value)`	Menampilkan `value` maksimum atribut feed numerik di antara item yang dipilih oleh template.
	Boolean, angka, atau teks	`min(value)`	Menampilkan `value` minimum dari atribut feed numerik di antara item yang dipilih oleh template.
	Boolean, angka, atau teks	`any(value)`	Memilih `value` untuk atribut dari salah satu item yang dipilih oleh template. Fungsi ini dapat menghasilkan `value` yang berbeda setiap kali dijalankan.

Menggunakan fungsi di kolom kustom template dan feed

Untuk menggunakan fungsi di kolom kustom template dan feed, lakukan tindakan berikut:

Pilih fungsi dari menu . Saat Anda mengarahkan perangkat input ke suatu fungsi di menu, detail tentang fungsi tersebut akan ditampilkan.
Pilih fungsi untuk disertakan dalam formula. Teks berformat fungsi ditampilkan dengan elemen placeholder hitam.
Ganti elemen placeholder dengan informasi khusus untuk kasus penggunaan Anda. Misalnya, lihat bagian Fungsi logika if dan Fungsi teks concat.

Jangan edit teks berwarna hijau. Teks ini adalah bagian yang diperlukan dari fungsi.

Saat membuat template, Search Ads 360 versi baru hanya menampilkan fungsi yang valid untuk konteks saat ini.

Fungsi logika if

if(condition, if_true, if_false)

Fungsi logika ini mengevaluasi kondisi yang ditentukan sebagai true (benar) atau false (salah), lalu menghasilkan nilai yang Anda tentukan dalam if_true dan if_false, bergantung pada apakah kondisi tersebut ternyata benar atau salah.

Edit condition untuk menentukan kriteria yang akan dievaluasi.
Edit if_true untuk menentukan apa yang akan terjadi jika kondisinya benar.
Edit if_false untuk menentukan apa yang akan terjadi jika kondisinya salah.

Fungsi teks concat

concat("text1", “text2”)

Fungsi teks ini menggabungkan konten dari dua atau beberapa nilai. Untuk menambahkan nilai tambahan, sisipkan koma yang diikuti dengan nilai tambahan. Nilai harus berupa teks, tetapi dapat berasal dari fungsi lain. Fungsi text_to mengonversi nilai kolom menjadi teks.

concat(“Origin “, f:"Origin"),” Destination ”, f:"Destination_country", f:"Destination_name”,” - ”, text_to(f:"Price"))

Mengatasi error nilai fungsi

Search Ads 360 versi baru tidak menghasilkan kampanye, iklan, dan item lainnya jika fungsi menampilkan nilai kosong atau tidak valid. Untuk mengatasi error, pertimbangkan menggunakan opsi berikut untuk memecahkan masalah:

Menggabungkan fungsi di if_error(parameter, alternate)
Parameter ini dapat berupa salah satu dari hal berikut: fungsi, kolom feed, teks, atau kombinasi dari jenis ini. Jika fungsi menampilkan error atau kosong, alternate akan ditampilkan.

Contoh: if_error(f:"brand", "Unbranded")
Hasil: Menampilkan f:"brand" jika memiliki nilai, "Unbranded" jika tidak memiliki nilai.

Biasanya, jika parameter tidak valid, seluruh fungsi akan tidak valid.
Contoh: if(f:"product_type" = "sepatu", 1, 2)

Saat elemen feed tidak memiliki product_type, keseluruhan ekspresi if akan tidak valid. Menggabungkan fungsi if_error di sekeliling fungsi if :

Contoh: if_error(if(f:'product_type" = "shoes", 1, 2), 3)
Hasil: Fungsi menampilkan "3" jika product_type tidak ditentukan di item feed.

Menggabungkan fungsi di is_error
Gunakan if(is_error(parameter), alternate, value)
Parameter dapat menyertakan referensi kolom feed. f:”column_name” mereferensikan kolom feed.
Saat error ditampilkan, misalnya, jika kolom feed kosong, alternate akan digunakan. Jika tidak, value akan digunakan.

Menggunakan agregasi
Gunakan min(value), max(value), atau any(value) kecuali jika setiap grup iklan hanya berisi satu nilai untuk atribut. Tentukan max(f:”price”) jika grup iklan dapat berisi produk dengan harga yang berbeda.

Mengatasi error logika

Untuk mengatasi error logika, gunakan fungsi if(condition, true, false) untuk memfilter atau mengubah hasil yang tidak diinginkan. Misalnya, gunakan fungsi if untuk mempersingkat teks yang terlalu panjang.

Link terkait

Apakah ini membantu?

Bagaimana cara meningkatkannya?