Referensi

Terakhir diperbarui: 3 Juli 2026

Bayangkan Anda menjalankan toko pakaian online. Untuk setiap produk, Anda ingin mencatat dari merek mana produk itu berasal. Jika ada puluhan produk dari merek yang sama, "DailyWear", Anda akan mengetik ulang nama merek, logo, dan teks perkenalan yang sama untuk setiap produk. Ketika teks perkenalan merek berubah, Anda harus memperbaiki puluhan produk itu satu per satu.

Referensi menghilangkan pengulangan ini. Informasi merek dibuat secara terpisah hanya sekali, dan setiap produk cukup menghubungkan ke merek tersebut. Tidak mengetik ulang informasi yang sama setiap kali, melainkan menghubungkan ke informasi yang berada di satu tempat, itulah referensi. Jika Anda memperbaiki teks perkenalan merek sekali saja, perubahan itu langsung tercermin pada semua produk yang terhubung ke merek tersebut.

Halaman ini membahas apa itu referensi yang menghubungkan satu Content ke Content lain, apa yang terjadi ketika Anda menghubungkannya, dan bagaimana antar-Content saling tersambung.

Perbedaan antara menunjuk dan menyalin

Mencatat informasi merek pada setiap produk dapat dipikirkan dengan dua cara.

Yang pertama adalah menyalin. Setiap kali Anda membuat produk, Anda menulis langsung nama merek "DailyWear" dan teks perkenalan merek ke dalam produk itu. Pada 100 produk akan masuk 100 salinan teks yang sama. Jika perkenalan merek berubah, Anda harus mencari dan memperbaiki 100 salinan itu semua, dan jika satu pun terlewat, setiap produk akan menampilkan perkenalan yang berbeda.

Yang lain adalah menunjuk. Anda membuat merek "DailyWear" secara terpisah sebagai satu Content, dan setiap produk cukup menunjuk ke Content merek itu. Informasi hanya berada di satu tempat, yaitu merek. Jika Anda memperbaiki teks perkenalan di satu tempat itu, semua produk yang menunjuk ke merek tersebut akan mengikuti perkenalan baru yang sama.

Referensi adalah "menunjuk" ini. Field yang menampung sambungan ini disebut Content Reference di studio konten. Jika Anda menempatkan satu Field Content Reference pada Content Type produk, di kotak itu Anda memilih dan menghubungkan Content merek. Sebagai perumpamaan, alih-alih menyalin informasi merek dengan tangan ke setiap produk, Anda menggambar satu panah yang menyatakan "merek produk ini adalah DailyWear yang ada di sana".

Ketika produk dan merek dihubungkan, bentuknya menjadi seperti berikut. Beberapa produk terhubung ke satu merek yang sama.

Produk "Stainless Tumbler 500ml" ──hubungkan──▶
Produk "Mini Tumbler Panas Dingin 350ml" ──hubungkan──▶   Merek "DailyWear"
Produk "Botol Air Lipat Portabel 600ml" ──hubungkan──▶

Merek "DailyWear" dibuat hanya sekali, dan baik tumbler maupun botol air semuanya terhubung ke satu tempat ini. Jika Anda memperbaiki teks perkenalan merek sekali di Content DailyWear, ketiga produk di atas semuanya akan mengikuti perkenalan baru.

Sambungan dapat dibuat bukan hanya antar-Content, tetapi juga dari Content ke Media (berkas seperti gambar atau video yang diunggah). Menempelkan foto utama pada produk adalah salah satu contohnya. Halaman ini membahas kasus menyambungkan antar-Content. Cara menempelkan Media dibahas di Media.

Jika Anda menghubungkan merek ke produk, saat mengambil informasi produk Anda dapat sekaligus mengambil informasi merek yang terhubung. Ketika menampilkan produk tumbler di layar, nama dan teks perkenalan merek "DailyWear" yang terhubung ke produk itu pun ikut datang sekaligus. Meskipun Anda tidak menyalin informasi merek ke sisi produk, sambungan itu diikuti untuk membaca nilainya dari satu tempat, yaitu merek.

Karena itu informasi merek cukup ditempatkan selalu di satu tempat saja, yaitu Content merek. Setiap kali produk dibaca, informasi merek pada saat itu ikut datang mengikuti sambungan. Jika Anda memperbaiki merek, perubahan itu akan ikut datang saat produk dibaca berikutnya.

Format rinci tentang sejauh mana Content yang terhubung diambil bersama, dan dengan permintaan seperti apa mengambilnya, dibahas di Referensi API. Di studio konten Anda cukup menghubungkannya saja.

Menentukan jenis yang dapat dihubungkan

Pada Field Content Reference Anda dapat memasang batasan "kotak ini hanya dapat dihubungkan dengan Content tertentu". Untuk kotak merek pada produk, akan menjadi masalah jika Content sembarangan masuk. Sebab ulasan atau pengumuman tidak boleh terhubung secara keliru ke tempat merek.

Karena itu Anda dapat menentukan agar kotak ini hanya dapat dihubungkan dengan Content yang dibuat dari Content Type "Merek". Dengan begini, yang dapat dipilih di kotak merek terbatas pada daftar merek, dan jenis Content lain tidak terhubung. Content Type yang dapat dihubungkan juga dapat diizinkan beberapa sekaligus. Misalnya, pada satu kotak Anda dapat mengizinkan baik "Merek" maupun "mitra", sehingga salah satu dari keduanya dapat dihubungkan.

Batasan ini ditentukan di pengaturan rinci Field Content Reference. Pada tab Validasi nyalakan Hanya terima Content Type tertentu, lalu pilih "Merek" sebagai Content Type yang akan diizinkan.

Layar pengaturan rinci kotak merek produk (Content Reference Field). Tampilan ketika menyalakan Hanya terima Content Type tertentu pada validasi dan memilih "Merek"

Batasan ini diperiksa saat menyimpan atau memublikasikan. Jika Anda menghubungkan Content yang bukan dari Content Type yang diizinkan, penyimpanan akan terhalang, dan jika Content yang telah dihubungkan dihapus di tengah jalan sehingga tidak lagi dapat ditemukan, hal itu juga akan tersangkut pada pemeriksaan. Ini adalah mekanisme yang mencegah sambungan keliru menumpuk.

Menghubungkan beberapa dalam satu kotak

Sering kali cukup menghubungkan satu merek saja pada satu produk. Namun ada juga saat Anda ingin menghubungkan beberapa dalam satu kotak. Misalnya, pada kotak "produk yang cocok dilihat bersama produk ini" Anda ingin menyambungkan beberapa produk terkait sekaligus.

Dalam hal ini, Anda mengatur Field Content Reference menjadi Gunakan sebagai tipe daftar. Dengan begitu Anda dapat menghubungkan beberapa Content dalam satu kotak. Misalnya, pada kotak "produk yang cocok dilihat bersama" Anda menghubungkan tumbler, botol air, dan termos sekaligus. Saat digunakan sebagai tipe daftar pun, batasan jenis yang dapat dihubungkan tetap dapat dipasang dengan cara yang sama.

Agar produk dapat menghubungkan merek, tambahkan Field berjenis Content Reference pada Content Type "produk". Cara menambahkan Field dibahas di Pemodelan Content. Pada layar pemilihan jenis Field, pilih Content Reference, lalu tentukan "jenis yang dapat dihubungkan" yang tadi dilihat sebagai "Merek".

Karena harus ada target yang dihubungkan agar dapat disambungkan, siapkan terlebih dahulu sisi mereknya.

  1. Buat Content Type "Merek". Masukkan Field seperti nama merek dan teks perkenalan.
  2. Buat satu Content merek "DailyWear" dengan Content Type "Merek".
  3. Tambahkan Field Content Reference pada Content Type "produk", lalu tentukan jenis yang dapat dihubungkan sebagai "Merek".
  4. Buka produk "Stainless Tumbler 500ml" lalu tekan Edit.
  5. Tekan Tambahkan Content Yang Ada pada kotak merek. Jendela Pilih Content akan terbuka.
  6. Pilih "DailyWear" dari daftar lalu hubungkan.

Pada jendela Pilih Content hanya muncul "Merek" yang telah ditentukan sebagai jenis yang dapat dihubungkan. Batasan yang dipasang sebelumnya diterapkan apa adanya di sini.

Jendela pemilihan Content yang terbuka setelah menekan tambah Content yang sudah ada pada kotak merek di layar penyuntingan produk. Tampilan ketika "DailyWear" terlihat pada daftar yang disaring dengan "Merek"

Sekarang produk tumbler telah terhubung ke merek "DailyWear". Jika pada produk lain Anda juga memilih "DailyWear" di kotak yang sama, beberapa produk akan terhubung bersama ke satu merek.

Jika Content yang dihubungkan hilang, akan tersangkut pada pemeriksaan. Jika Anda menghapus Content merek yang dihubungkan oleh produk, kotak merek produk menjadi berstatus menghubungkan Content yang tidak lagi dapat ditemukan. Dalam keadaan ini, saat menyimpan atau memublikasikan produk akan terhalang pemeriksaan. Anda dapat menghubungkan merek lain lagi, atau jika kotak itu bukan wajib, mengosongkannya lalu mencoba lagi.

Menghubungkan bukan berarti kedua Content menyatu menjadi satu. Produk dan merek tetap tinggal terpisah masing-masing sebagai Content. Meskipun Anda menghapus produk, Content merek tetap ada, dan meskipun Anda memperbaiki merek, Content produk itu sendiri tetap apa adanya. Yang berubah hanyalah nilai yang ikut dibaca mengikuti sambungan.

Hal yang dilakukan berikutnya

  • Pemodelan Content: membahas cara menambahkan Field Content Reference pada Content Type "produk".
  • Media: membahas cara menempelkan Media seperti foto utama pada produk.
  • Status dan publikasi: membahas tahap memublikasikan Content yang dihubungkan untuk dibuka ke publik secara eksternal.
  • Referensi API: rujukan saat menangani langsung di program format permintaan untuk mengambil bersama Content yang terhubung dan struktur item Refer yang menampung sambungan.