Penyelesaian masalah konten Checkout Blocks Anda

Konten Checkout Blocks Anda mungkin tidak ditampilkan seperti yang diharapkan karena berbagai alasan, yang mengakibatkan elemen menghilang atau tidak berfungsi dengan benar. Masalah umum meliputi aturan tampilan yang tidak terpenuhi, kesalahan konfigurasi izin akses, atau ketidaksesuaian antara pengaturan di blok itu sendiri dan cara blok ditambahkan ke editor checkout dan akun.

Panduan ini membantu Anda menyelesaikan masalah umum Checkout Blocks sendiri. Jika Anda masih mengalami masalah setelah meninjau langkah-langkah dalam panduan ini, hubungi Dukungan Shopify untuk mendapatkan bantuan.

Di halaman ini

Penyelesaian masalah blok

Blok adalah elemen kustomisasi yang menampilkan konten di checkout Anda, seperti kolom kustom, konten dinamis, dan banner. Jika sebuah blok tidak berfungsi seperti yang diharapkan, gunakan bagian berikut untuk mengidentifikasi dan mengatasi masalahnya.

Blok tidak ditampilkan di checkout

Blok tidak ditambahkan ke editor

Membuat blok di aplikasi Checkout Blocks tidak secara otomatis menambahkannya ke checkout Anda. Anda perlu menambahkan blok tersebut ke konfigurasi checkout Anda menggunakan editor checkout dan akun.

Langkah-langkah:

Dari admin Shopify Anda, buka Pengaturan > Checkout.

Di bagian Konfigurasi, klik Sesuaikan di sebelah konfigurasi yang ingin Anda ubah.

Buka halaman checkout tempat Anda ingin blok ditampilkan.

Klik ⊕ Tambah blok, lalu pilih jenis blok yang sesuai.

Konfigurasikan ID Blok agar cocok dengan ID blok yang Anda buat di Checkout Blocks.

Klik Simpan.

Blok tidak diatur ke Aktif

Sebuah blok harus diatur ke Aktif agar dapat ditampilkan dalam checkout. Blok draf tidak ditampilkan kepada pelanggan.

Langkah-langkah:

Dari admin Shopify Anda, buka Aplikasi > Checkout Blocks.

Klik Blok.

Klik blok yang ingin Anda aktifkan.

Di bagian Status, pilih Aktif.

Klik Simpan.

Blok tidak dipublikasikan ke pasar atau halaman

Jika blok Anda dikonfigurasi dengan pengaturan penerbitan khusus pasar, blok tersebut hanya ditampilkan di pasar yang telah Anda pilih. Jika blok hanya dipublikasikan ke halaman checkout tertentu, blok tidak akan ditampilkan di halaman lain.

Langkah-langkah:

Dari admin Shopify Anda, buka Aplikasi > Checkout Blocks.

Klik Blok.

Klik blok yang ingin Anda tinjau.

Di bagian Penerbitan, konfirmasikan bahwa blok tersebut dipublikasikan ke semua pasar yang berlaku.

Di bagian Halaman checkout, konfirmasikan bahwa blok tersebut diatur untuk ditampilkan di semua halaman checkout yang berlaku.

Klik Simpan.

Aturan tampilan tidak terpenuhi

Aturan tampilan menentukan kondisi yang harus dipenuhi agar blok dapat ditampilkan di checkout. Jika kondisi ini tidak terpenuhi selama sesi checkout pelanggan, blok tersebut tidak akan ditampilkan.

Langkah-langkah:

Dari admin Shopify Anda, buka Aplikasi > Checkout Blocks.

Klik Blok.

Klik blok yang tidak ditampilkan.

Tinjau aturan tampilan yang dikonfigurasi untuk blok tersebut.

Verifikasi apakah checkout percobaan Anda memenuhi semua kondisi yang diperlukan, seperti ambang batas total keranjang, jenis produk, atau status login pelanggan.

Jika Anda telah mengatur Hanya tampilkan saat: Semua aturan terpenuhi, pastikan bahwa setiap aturan terpenuhi. Jika Anda telah mengatur Hanya tampilkan saat: Salah satu aturan terpenuhi, pastikan bahwa setidaknya satu aturan terpenuhi.

Ketidakcocokan ID Blok

Setiap jenis blok di editor checkout dan akun memiliki pengaturan ID Blok. ID Blok di editor harus cocok dengan ID Blok dari blok yang Anda buat di aplikasi Checkout Blocks. Jika ID tidak cocok, blok tidak akan ditampilkan.

Misalnya, jika blok Anda memiliki ID Blok 4 di aplikasi Checkout Blocks, blok di editor checkout dan akun juga harus memiliki ID Blok yang diatur ke 4.

Langkah-langkah:

Dari admin Shopify Anda, buka Aplikasi > Checkout Blocks.

Klik Blok.

Klik blok yang tidak ditampilkan, lalu catat ID Blok-nya.

Buka Pengaturan > Checkout.

Di bagian Konfigurasi, klik Sesuaikan di sebelah konfigurasi yang ingin Anda periksa.

Klik blok di editor yang seharusnya menampilkan konten Anda.

Di Pengaturan blok, konfirmasikan bahwa ID Blok cocok dengan ID dari langkah 3.

Jika ID tidak cocok, perbarui ID Blok agar cocok.

Klik Simpan.

Kolom ID blok pratinjau berisi nilai

Kolom ID blok pratinjau (Untuk tujuan pengujian) di editor checkout dan akun hanya ditujukan untuk pengujian. Jika kolom ini berisi nilai setelah Anda menyimpan checkout, kolom dapat mengganti aturan tampilan blok dan menyebabkan perilaku yang tidak terduga.

Langkah-langkah:

Dari admin Shopify Anda, buka Pengaturan > Checkout.

Di bagian Konfigurasi, klik Sesuaikan di sebelah konfigurasi yang ingin Anda periksa.

Klik blok yang tidak ditampilkan dengan benar.

Di kolom ID blok pratinjau (Untuk tujuan pengujian), hapus nilai apa pun agar kolom menjadi kosong.

Klik Simpan.

Blok berprioritas lebih tinggi ditampilkan

Jika Anda memiliki beberapa blok dengan jenis yang sama dan aturan tampilan yang tumpang tindih, hanya blok dengan prioritas tertinggi yang akan ditampilkan. Pelajari selengkapnya tentang prioritas blok.

Langkah-langkah:

Dari admin Shopify Anda, buka Aplikasi > Checkout Blocks.

Klik Blok.

Klik ⇅ Edit prioritas.

Pilih jenis blok yang tidak ditampilkan.

Tinjau urutan prioritas. Blok dengan nomor lebih rendah memiliki prioritas lebih tinggi.

Sesuaikan nomor Prioritas untuk mengubah blok mana yang ditampilkan terlebih dahulu.

Klik Simpan.

Menyelesaikan masalah batas blok aktif tercapai

Checkout Blocks mendukung hingga 30 blok aktif per jenis blok. Jika Anda memiliki lebih dari 30 blok aktif dengan jenis yang sama, seperti 35 blok kolom kustom aktif, hanya 30 blok pertama yang dapat ditampilkan di checkout.

Langkah-langkah:

Dari admin Shopify Anda, buka Aplikasi > Checkout Blocks.

Klik Blok.

Filter berdasarkan jenis blok yang sedang Anda selesaikan masalahnya.

Hitung jumlah blok aktif.

Jika Anda memiliki lebih dari 30 blok aktif, nonaktifkan atau hapus blok yang tidak lagi Anda perlukan.

Blok ditampilkan beberapa kali di checkout

Menyelesaikan masalah blok yang ditambahkan ke bagian bersama

Tergantung di mana Anda menambahkan blok di dalam editor checkout dan akun, blok tersebut mungkin ditampilkan di setiap langkah checkout. Bagian Ringkasan pesanan dan area yang terlampir pada tombol Lanjutkan atau kembali konsisten di semua halaman checkout.

Untuk menampilkan blok pada langkah tertentu saja, tambahkan blok tersebut ke area konten utama dari langkah itu.

Langkah-langkah:

Dari admin Shopify Anda, buka Pengaturan > Checkout.

Di bagian Konfigurasi, klik Sesuaikan di samping konfigurasi yang ingin Anda ubah.

Klik blok yang ditampilkan beberapa kali.

Perhatikan di bagian mana blok tersebut berada. Jika berada di Ringkasan pesanan atau terlampir pada tombol Lanjutkan atau kembali, blok akan ditampilkan di setiap halaman checkout.

Untuk menampilkan blok di halaman tertentu saja, hapus blok dari bagian saat ini dan tambahkan ke area konten utama dari halaman checkout yang diinginkan.

Klik Simpan.

Menyelesaikan masalah beberapa instance blok ditambahkan

Beberapa jenis blok, seperti blok Edit item baris, biasanya hanya perlu ditambahkan ke checkout satu kali. Blok ini mengandalkan aturan tampilan untuk menampilkan konten yang berbeda untuk skenario yang berbeda. Jika konten blok terduplikasi, Anda mungkin tidak sengaja menambahkan blok lebih dari yang diperlukan.

Langkah-langkah:

Dari admin Shopify Anda, buka Pengaturan > Checkout.

Di bagian Konfigurasi, klik Sesuaikan di sebelah konfigurasi yang ingin Anda periksa.

Navigasikan setiap halaman checkout Anda dan tinjau blok yang telah ditambahkan.

Jika Anda menemukan blok duplikat dengan jenis dan ID Blok yang sama, hapus blok tambahan dengan mengeklik blok tersebut dan memilih Hapus blok.

Klik Simpan.

Penyelesaian masalah eror saat membuat atau menyimpan blok

Jika Anda menerima eror saat mencoba membuat atau menyimpan blok, tinjau bagian berikut.

Menyelesaikan masalah eror "Ada beberapa masalah dengan pengiriman formulir Anda"

Eror ini biasanya menunjukkan bahwa akun staf Anda tidak memiliki izin akses yang diperlukan untuk membuat blok di Checkout Blocks.

Izin akses yang diperlukan:

Izin toko > Konten: Staf harus memiliki izin akses untuk Melihat dan Membuat serta mengedit definisi metaobjek, serta Melihat dan Membuat serta mengedit entri.
Izin toko > Pengaturan toko: Staf harus memiliki izin akses Kelola pengaturan.
Izin aplikasi: Staf harus memiliki setidaknya izin akses untuk Checkout Blocks.

Langkah-langkah:

Dari admin Shopify Anda, buka Pengaturan > Pengguna dan izin akses.
Klik akun staf yang mengalami eror.
Di bagian Izin toko, perluas bagian Konten.
Pastikan izin akses Melihat dan Membuat serta mengedit dipilih untuk Definisi metaobjek.
Pastikan izin akses Melihat dan Membuat serta mengedit dipilih untuk Entri.
Di bagian Pengaturan toko, pastikan Kelola pengaturan dipilih.
Di bagian Izin aplikasi, pastikan Checkout Blocks dipilih.
Klik Simpan.

Jika Anda tidak memiliki izin akses untuk mengubah izin staf, hubungi pemilik toko atau anggota staf yang memiliki izin akses pengelolaan pengguna.

Penyelesaian masalah diskon khusus

Diskon khusus yang dibuat di Checkout Blocks mungkin tidak diterapkan seperti yang diharapkan karena beberapa faktor.

Menyelesaikan masalah batas diskon otomatis aktif tercapai

Shopify mengizinkan maksimum 25 diskon otomatis aktif pada satu waktu, termasuk diskon berbasis aplikasi dari semua aplikasi yang terinstal. Batas ini berlaku di seluruh toko Anda, bukan hanya Checkout Blocks.

Jika Anda mencoba mengaktifkan diskon otomatis ke-26, diskon tersebut tidak akan diterapkan di checkout.

Langkah-langkah:

Dari admin Shopify Anda, buka Diskon.
Filter untuk hanya menampilkan diskon Otomatis.
Hitung berapa banyak diskon otomatis yang saat ini aktif.
Jika Anda memiliki 25 atau lebih diskon otomatis aktif, nonaktifkan atau hapus diskon yang tidak lagi Anda perlukan sebelum mengaktifkan yang baru.

Pelajari selengkapnya tentang batasan saat menggabungkan diskon.

Menyelesaikan masalah diskon tidak aktif

Diskon khusus harus diatur ke Aktif agar dapat diterapkan di dalam checkout. Diskon juga tidak boleh kedaluwarsa berdasarkan tanggal mulai dan berakhir yang dikonfigurasi.

Langkah-langkah:

Dari admin Shopify Anda, buka Aplikasi > Checkout Blocks.

Klik Diskon.

Klik diskon yang tidak diterapkan.

Di bagian Status, pastikan diskon diatur ke Aktif.

Di bagian Tanggal aktif, pastikan tanggal saat ini berada dalam rentang tanggal mulai dan berakhir yang dikonfigurasi.

Klik Simpan.

Menyelesaikan masalah aturan diskon tidak terpenuhi

Diskon khusus di Checkout Blocks dapat memiliki aturan kondisional mendetail yang menentukan kapan diskon berlaku. Jika kondisi ini tidak terpenuhi selama sesi checkout pelanggan, diskon tidak akan berlaku.

Langkah-langkah:

Dari admin Shopify Anda, buka Aplikasi > Checkout Blocks.

Klik Diskon.

Klik diskon yang tidak diterapkan.

Tinjau aturan dan kondisi yang dikonfigurasi untuk diskon tersebut.

Verifikasi apakah checkout percobaan Anda memenuhi semua kondisi yang diperlukan, seperti nilai pesanan minimum, produk atau koleksi tertentu, atau persyaratan kelayakan pelanggan.

Sesuaikan aturan diskon jika perlu.

Klik Simpan.

Penyelesaian masalah kustomisasi metode penyerahan dan pembayaran

Jika metode penyerahan atau pembayaran tidak disembunyikan, diganti namanya, atau diatur ulang urutannya seperti yang diharapkan, tinjau bagian berikut.

Menyelesaikan masalah kustomisasi tidak aktif

Kustomisasi metode penyerahan atau pembayaran harus diatur ke Aktif agar dapat diterapkan dalam checkout.

Langkah-langkah:

Dari admin Shopify Anda, buka Aplikasi > Checkout Blocks.

Klik Functions.

Klik kustomisasi yang tidak berfungsi.

Di bagian Status, konfirmasikan kustomisasi diatur ke Aktif.

Klik Simpan.

Menyelesaikan masalah batas fungsi aktif tercapai

Shopify Functions memiliki batasan jumlah fungsi aktif yang dapat Anda miliki per jenis. Anda dapat mengaktifkan maksimal 25 fungsi kustomisasi pembayaran di setiap toko. Jika Anda melebihi batas ini, Anda mungkin akan menerima eror: Failed to enable customization. Please try again or contact support.

Batasan ini membantu memastikan checkout mempertahankan performa tinggi. Anda perlu menggabungkan atau menghapus kustomisasi agar tidak melebihi batas.

Langkah-langkah:

Dari admin Shopify Anda, buka Aplikasi > Checkout Blocks.

Klik Functions.

Hitung jumlah kustomisasi metode penyerahan aktif yang Anda miliki (jika menyelesaikan masalah pengiriman) atau jumlah kustomisasi metode pembayaran aktif yang Anda miliki (jika menyelesaikan masalah pembayaran).

Jika Anda telah mencapai batas untuk jenis tersebut, nonaktifkan atau hapus kustomisasi yang tidak lagi diperlukan.

Coba aktifkan lagi kustomisasi baru Anda.

Menyelesaikan masalah aturan kustomisasi tidak terpenuhi

Kustomisasi metode penyerahan dan pembayaran bergantung pada aturan yang menentukan kapan kustomisasi diterapkan. Jika kondisi ini tidak terpenuhi selama sesi checkout pelanggan, kustomisasi tidak akan diterapkan.

Langkah-langkah:

Dari admin Shopify Anda, buka Aplikasi > Checkout Blocks.

Klik Functions.

Klik kustomisasi yang tidak berfungsi.

Tinjau aturan yang dikonfigurasikan untuk kustomisasi.

Verifikasi apakah checkout percobaan Anda memenuhi semua kondisi yang diperlukan.

Sesuaikan aturan jika perlu.

Klik Simpan.

Memvalidasi perubahan Anda dengan checkout percobaan

Sebelum mengandalkan kustomisasi Checkout Blocks Anda di lingkungan live, Anda harus memvalidasi bahwa kustomisasi tersebut berfungsi seperti yang diharapkan menggunakan checkout percobaan.

Langkah-langkah:

Dari toko online Anda, tambahkan produk ke keranjang yang cocok dengan kondisi untuk blok, diskon, atau kustomisasi yang ingin Anda uji.
Lanjutkan ke checkout, tetapi jangan selesaikan pembelian.
Tinjau setiap langkah checkout dan verifikasi hal berikut:
- Blok ditampilkan di lokasi yang benar dengan konten yang benar.
- Diskon khusus diterapkan saat persyaratan kelayakan terpenuhi.
- Kustomisasi metode penyerahan dan pembayaran berfungsi seperti yang diharapkan.
Jika Anda menguji aturan tampilan berdasarkan total keranjang, coba nilai keranjang yang berbeda untuk mengonfirmasi blok muncul dan hilang pada ambang batas yang benar.
Jika Anda menguji aturan tampilan berbasis pelanggan, uji skenario checkout sebagai tamu dan saat login.

Pertanyaan umum

Berapa banyak blok yang dapat saya aktifkan secara bersamaan?

Anda dapat memiliki hingga 30 blok aktif per jenis blok. Misalnya, Anda dapat memiliki 30 kolom kustom aktif, 30 blok konten dinamis aktif, dan 30 blok edit item pesanan aktif secara bersamaan. Anda dapat membuat lebih dari 30 blok dari satu jenis, tetapi hanya 30 blok aktif pertama yang dapat ditampilkan di checkout.

Mengapa saya memerlukan izin staf khusus untuk menggunakan Checkout Blocks?

Checkout Blocks membuat definisi metaobjek untuk menyimpan konfigurasi blok. Anggota staf memerlukan izin akses untuk membuat dan mengedit definisi serta entri metaobjek agar dapat menyimpan blok di aplikasi. Selain itu, staf memerlukan izin Kelola pengaturan di bawah Pengaturan toko dan Izin aplikasi eksplisit untuk Checkout Blocks.

Dapatkah saya menggunakan Checkout Blocks jika saya tidak menggunakan paket Shopify Plus?

Penjual dengan paket Basic atau yang lebih tinggi dapat menggunakan blok konten dinamis dan konten statis hanya di halaman Terima Kasih dan Status Pesanan mereka. Semua fitur Checkout Blocks lainnya, termasuk kolom kustom, diskon khusus, dan kustomisasi metode pengiriman/pembayaran, memerlukan paket Shopify Plus.

Bagaimana cara mengetahui ID Blok mana yang harus digunakan?

Saat Anda membuat blok di aplikasi Checkout Blocks, blok tersebut akan diberi ID Blok (defaultnya adalah 0). Saat Anda menambahkan jenis blok tersebut ke checkout di editor, Anda perlu mengatur ID Blok yang sama agar editor tahu blok spesifik mana yang akan ditampilkan. Jika Anda ingin menampilkan blok berbeda dengan jenis yang sama di lokasi yang berbeda, tetapkan ID Blok unik untuk setiap blok dan cocokkan ID tersebut di editor. Pelajari selengkapnya tentang ID Blok.

Dapatkah saya menggabungkan diskon Checkout Blocks dengan diskon lain?

Diskon khusus yang dibuat di Checkout Blocks adalah diskon otomatis yang didukung oleh Shopify Functions. Diskon tersebut mengikuti aturan kombinasi diskon yang sama dengan diskon otomatis lainnya. Anda dapat memiliki maksimal 25 diskon otomatis aktif di seluruh toko Anda, termasuk yang dibuat di Checkout Blocks dan aplikasi lain.

Sebelum Anda menghubungi Dukungan Shopify tentang Checkout Blocks

Jika Anda telah mencoba langkah-langkah penyelesaian masalah di atas dan masalah Checkout Blocks Anda tetap ada, Anda dapat menghubungi Dukungan Shopify untuk mendapatkan bantuan. Sebelum menghubungi Dukungan Shopify, kumpulkan informasi khusus Checkout Blocks berikut untuk membantu menyelesaikan masalah Anda lebih cepat:

Detail blok: Nama, jenis (seperti kolom kustom, konten dinamis, atau edit item pesanan), dan ID Blok dari blok yang tidak berfungsi
Tangkapan layar konfigurasi: Tangkapan layar pengaturan blok di aplikasi Checkout Blocks, termasuk aturan tampilan, pengaturan publikasi, dan status apa pun
Tangkapan layar editor: Tangkapan layar tentang cara blok dikonfigurasikan di editor checkout dan akun, termasuk kolom ID Blok dan ID Blok Pratinjau
Pesan kesalahan: Tangkapan layar atau teks persis dari setiap pesan kesalahan yang Anda terima saat membuat, menyimpan, atau melihat pratinjau blok
URL checkout percobaan: Tautan ke checkout percobaan atau checkout yang ditinggalkan tempat masalah dapat direproduksi, beserta konten keranjang yang digunakan untuk memicu aturan tampilan
Perilaku yang diharapkan vs. aktual: Deskripsi yang jelas tentang apa yang Anda harapkan terjadi vs. apa yang sebenarnya terjadi di checkout
Langkah-langkah penyelesaian masalah yang telah diselesaikan: Bagian mana dari panduan ini yang telah Anda tinjau dan apa yang telah Anda coba
Izin staf: Konfirmasi bahwa akun Anda memiliki izin yang diperlukan untuk Konten (definisi dan entri metaobjek), Pengaturan toko (Kelola pengaturan), dan Izin aplikasi (Checkout Blocks)

Menyiapkan informasi khusus Checkout Blocks ini membantu Dukungan Shopify untuk mendiagnosis dan menyelesaikan masalah Anda secara lebih efisien.