Panduan gaya template

Panduan gaya ini telah disiapkan untuk membantu Anda mengambil keputusan terkait cara menyiapkan template untuk Galeri Template Komunitas. Panduan gaya ini didasarkan pada prinsip penulisan Desain Material Google. Prinsip ini adalah sebagai berikut:

  • Ringkas
  • Tulis secara simpel dan langsung
  • Sapa pengguna dengan jelas
  • Sampaikan detail yang penting
  • Tulis untuk semua tingkat kemampuan baca
  • Bersikaplah sebagaimana manusia: tulis untuk manusia, bukan robot

Ikuti panduan ini untuk membantu memastikan semua template memiliki tampilan dan nuansa yang konsisten, serta untuk membantu pengguna memahami cara menggunakan template Anda.

Info

Panduan ini berlaku untuk item yang ada di tab Info Editor Template.

Nama

Nama template ditampilkan kepada pengguna Tag Manager di seluruh antarmuka pengguna Tag Manager dan Galeri Template Komunitas. Template ini muncul di bagian atas halaman detail template, dan muncul saat template dicantumkan.

  • Gunakan nama perusahaan/organisasi Anda dan nama fungsi template: Nama Organisasi Nama Template.
  • Gunakan Kapitalisasi Judul.
  • Gunakan istilah yang menjelaskan fungsi.
  • Hindari penggunaan istilah "Resmi" dalam nama template, kecuali jika Anda telah diberi otorisasi untuk melakukannya oleh organisasi yang relevan.

Contoh: Tag Pengukuran Konversi MyCompany, Variabel ID Kampanye MyCompany

Deskripsi

Deskripsi template adalah deskripsi template yang muncul di halaman detail sebagai ringkasan singkat fungsi template.

  • Gunakan kalimat yang jelas dan ringkas untuk mendeskripsikan fungsi template.
  • Nyatakan dengan jelas bagaimana template Anda bisa bermanfaat bagi pengguna. Misalnya: "Template Pembuat Audiens Example.com dapat membantu Anda membuat daftar audiens baru dari pengunjung situs".
  • Hindari jargon.
  • Sertakan link untuk informasi, dokumentasi, dan dukungan tambahan.

Ikon

Ikon template Anda ditampilkan sebagai thumbnail jika tercantum di Tag Manager dan di Galeri Template Komunitas.

  • Gunakan PNG, JPEG, atau GIF untuk format gambar.
  • Gambar harus berbentuk persegi, minimal berukuran 48 x 48 piksel, dan tidak lebih besar dari 96 x 96 piksel.
  • Ukuran file harus di bawah 50 kilobyte.
  • Hindari penggunaan logo perusahaan resmi, kecuali jika Anda telah diberi otorisasi untuk melakukannya oleh organisasi yang relevan.
  • Kolom
  • Gunakan tab Kolom Editor Template untuk menambahkan elemen formulir seperti input teks, kotak centang, dsb.

Kolom

Panduan gaya ini berlaku untuk tab Kolom Editor Template.

Nama parameter

Ini adalah nama kolom seperti yang muncul di Editor Template, tetapi tidak seperti yang ditampilkan kepada pengguna. Nama harus mendeskripsikan jenis data yang digunakan. Format nama parameter sebagai lowerCamelCase. Contoh: userName, customerID, shoppingCartValue.

Label kolom

Label kolom mencakup kolom nama tampilan, teks kotak centang, dan item terkait.

  • Gunakan kapitalisasi kalimat.
  • Lebih singkat lebih baik.
  • Berikan gambaran yang jelas.
  • Gunakan kata yang umum.

Teks bantuan

Teks bantuan adalah konten informasi, yang ditampilkan sebagai tooltip, untuk membantu pengguna memasukkan nilai yang valid ke kolom template. Berikan contoh input, jika memungkinkan, dan jelaskan cara penggunaan kolom template atau efek dari pemberian nilai tertentu.

  • Gunakan kapitalisasi kalimat.
  • Ringkas, tetapi tidak kaku. Anda dapat menggunakan singkatan dan menggunakan format orang kedua (Anda) dalam tulisan.
  • Jenis kolom yang didukung
  • Format HTML dasar diizinkan. Contoh: <strong>, <em>.

Jenis kolom yang didukung

Jenis
 Deskripsi
Input teks Input teks. Nilai parameter template jenis ini adalah string yang dapat merujuk ke variabel. Widget input teks yang dirender di antarmuka pengguna Tag Manager dapat berupa kolom teks satu baris atau input multibaris.
Menu drop-down Menu drop-down yang hanya mengizinkan satu item dipilih sebagai nilai parameter template. Susun item dalam urutan abjad kecuali ada alasan mendasar untuk tidak melakukannya.
Kotak centang Input kotak centang. Nilai parameter template jenis ini adalah boolean: true (benar) untuk dicentang, false (salah) untuk tidak dicentang.
Tombol radio Input radio. Parameter template jenis ini menyajikan daftar pilihan di antarmuka pengguna Tag Manager dan pengguna hanya diizinkan untuk memilih salah satu pilihan sebagai nilai parameter template.
Tabel sederhana Input tabel yang sederhana. Setiap sel dalam tabel dapat diedit secara langsung, dan setiap sel hanya dapat berupa salah satu dari dua jenis berikut: input teks atau menu drop-down. Nilai parameter template jenis ini adalah array objek: setiap objek mengenkode baris, setiap kunci dalam objek harus berupa salah satu nama kolom, dan setiap nilai dalam objek merupakan nilai dari sel yang sesuai.