Bantuan
Masuk

Persyaratan dan batasan Skrip Shopify

Beberapa batasan Skrip Shopify ada untuk meningkatkan keamanan dan untuk memastikan bahwa skrip dapat berjalan, berapa pun jumlah pelanggan yang menggunakan toko Anda pada waktu tertentu. Ingatlah batasan berikut jika Anda mengembangkan skrip untuk Toko Shopify Anda.

Di halaman ini

Toko online dan Storefront API

Saat membuat atau mengedit skrip, Anda dapat memilih apakah skrip tersebut hanya akan berjalan di toko online Anda, atau di toko online Anda dan di aplikasi berikut:

Agar skrip berfungsi, situs web Anda harus memiliki fungsionalitas keranjang belanja bawaan. Jadi, Anda tidak dapat menggunakan skrip dengan Buy Buttons atau saluran penjualan Facebook dan Instagram by Meta.

Skrip yang diterbitkan

Hanya satu skrip per jenis skrip yang dapat diterbitkan pada satu waktu. Misalnya, Anda dapat menerbitkan skrip item pesanan dan skrip tarif pengiriman, tetapi Anda tidak dapat menerbitkan dua skrip item pesanan secara bersamaan.

Jumlah maksimum Skrip Shopify

Anda dapat membuat hingga 200 Skrip Shopify.

Draf pesanan

Skrip item pesanan, skrip tarif pengiriman, dan skrip pembayaran tidak berfungsi dengan draf pesanan atau checkout draf pesanan.

Bidang meta

Skrip Shopify tidak dapat mengakses bidang meta.

Atribut keranjang/checkout

Skrip Shopify tidak dapat mengakses atribut keranjang Liquid Shopify. Anda dapat menambahkan atribut ini ke halaman keranjang untuk mengumpulkan informasi tambahan dari pelanggan, tetapi tidak dapat membuat skrip yang menggunakannya.

Kode diskon

Skrip dapat mengakses apakah kode diskon diterapkan, jumlah diskon, dan jenis diskon, seperti jumlah tetap, persentase, atau pengiriman. Skrip tidak dapat mengakses cara kode diskon diterapkan, misalnya apakah kode tersebut khusus untuk keranjang atau item pesanan. Ini berarti Skrip tidak dapat mengakses total pasca-diskon atau diskon otomatis.

Skrip item pesanan dan pengiriman yang mengakses diskon yang diterapkan pada keranjang tidak kompatibel dengan kombinasi diskon. Metode .discount_code hanya dapat mengembalikan satu kode diskon. Keranjang yang menyertakan beberapa kode diskon menggunakan kombinasi diskon tidak didukung.

Item pesanan

Skrip tidak dapat menambahkan item ke keranjang atau menaikkan harga item.

Tarif pengiriman

Skrip tidak dapat menaikkan harga tarif pengiriman.

Multi-mata uang

Skrip Anda mungkin tidak berfungsi seperti yang diharapkan dengan multi-mata uang. Untuk memastikan skrip Anda berfungsi untuk keranjang atau checkout yang menggunakan mata uang selain mata uang utama toko Anda, Anda perlu memigrasikan skrip ke Shopify Functions.

Ekspresi reguler

Pencocokan ekspresi reguler tidak didukung. Jika Anda membuat skrip item pesanan, Anda mungkin dapat menggunakan salah satu metode berikut sebagai solusinya:

  • Metode split
  • Metode start_with dan end_with
  • Metode include

Tema

Anda mungkin perlu memperbarui tema Liquid untuk mendukung skrip Anda dan agar tidak membingungkan pelanggan. Misalnya, tidak semua tema menampilkan diskon item pesanan di keranjang. Jika demikian, Anda perlu mengedit tema untuk menampilkan diskon item pesanan di keranjang. Pelajari selengkapnya tentang jenis modifikasi yang dapat Anda buat pada tema Liquid Anda.

Sumber daya

Jumlah CPU dan memori yang tersedia untuk skrip terbatas. Sumber daya yang dicadangkan untuk skrip bergantung pada ukuran keranjang dan jumlah kalkulasi yang dibutuhkan skrip. Shopify melacak batas sumber daya ini dengan cermat untuk memastikan batas tersebut tidak menghalangi skrip Anda berfungsi sebagaimana mestinya.

Saat Anda menguji skrip, konsol Script Editor akan mencetak persentase sumber daya teralokasi yang digunakan skrip.

Input/output

Dengan beberapa pengecualian, Skrip Shopify tidak mampu melakukan input/output. Ini berarti skrip tidak dapat mengeksekusi permintaan web atau panggilan basis data, dan tidak dapat memperoleh input dari pengguna.

Metode puts dapat digunakan untuk mencetak teks ke konsol di aplikasi Script Editor.

Waktu dan keacakan

Skrip tidak dapat melibatkan kalkulasi acak atau berbasis waktu. Objek Time dan metode rand tidak dapat diakses oleh Skrip Shopify.

Karena skrip berjalan setiap kali total keranjang dihitung ulang, skrip yang didasarkan pada waktu atau pembuatan angka acak mungkin memberikan hasil yang tidak dapat diprediksi atau membingungkan jika pelanggan sering mengubah keranjangnya. Namun, Anda dapat menjadwalkan skrip untuk berjalan selama event berlangsung menggunakan aplikasi Launchpad.

Batas karakter skrip

Anda dapat membuat skrip hingga maksimum 40.960 karakter.

Pesanan langganan

Jika skrip item pesanan dan pengiriman Anda membuat diskon untuk produk langganan, diskon tersebut akan berlaku untuk pembayaran berikut:

  • pembayaran pertama dari bayar per pengiriman saja, tanpa berlaku untuk pesanan terjadwal
  • seluruh jumlah pesanan langganan prabayar

Pelajari selengkapnya tentang langganan dan skrip.

Checkout dipercepat

Saat Anda menggunakan Skrip Shopify dengan checkout dipercepat, diskon pengiriman diterapkan setelah pelanggan memilih metode pembayaran dipercepat. Karena itu, perubahan harga pesanan tidak ditampilkan di perangkat atau browser pelanggan. Pelanggan dapat melihat harga asli di checkout dipercepat mereka, tetapi akan dikenai harga diskon yang benar.

Shopify Point of Sale (POS)

Skrip Shopify tidak berfungsi dengan Shopify Point of Sale (POS).

Mengganti nama gerbang pembayaran

Anda tidak dapat mengganti nama gerbang pembayaran yang menampilkan gambar atau logo sebagai nama gerbang. Gerbang pembayaran dengan gambar logo di sebelah namanya dapat diganti namanya.

Pengiriman terpisah di checkout

Skrip pengiriman tidak kompatibel dengan pengiriman terpisah di Shopify Checkout. Jika Anda menggunakan skrip pengiriman dan mengaktifkan pengiriman terpisah, pengiriman terpisah tidak akan ditampilkan kepada pelanggan di checkout.