Şablon stil kılavuzu
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu stil kılavuzu, Topluluk Şablon Galerisi için şablonları nasıl hazırlayacağınıza karar vermenize yardımcı olmak amacıyla hazırlanmıştır. Bu stil kılavuzu, Google Materyal Tasarım yazım ilkelerine dayanır. Basitçe belirtmek gerekirse bunlar:
- Kısa ve öz istemler oluşturun
- Basit ve doğrudan yazın
- Kullanıcılara açıkça hitap edin
- Önemli ayrıntıları paylaşın
- Tüm okuma seviyelerine uygun içerikler yazma
- İnsan gibi yazın: Robotlar için değil, insanlar için yazın
Tüm şablonların tutarlı bir görünüme ve tarza sahip olmasını sağlamak ve kullanıcıların şablonunuzu nasıl kullanacağını anlamalarına yardımcı olmak için bu yönergelere uyun.
Bilgi
Bu yönergeler, Şablon Düzenleyici'nin Bilgi sekmesinde bulunan öğeler için geçerlidir.
Ad
Şablon adı, Etiket Yöneticisi kullanıcı arayüzünde ve Topluluk Şablon Galerisi'nde Etiket Yöneticisi kullanıcılarına sunulur. Bu durum, şablonun ayrıntılar sayfasının üst kısmında ve şablonlar listelendiğinde gösterilir.
- Şirket/kuruluş adınızı ve şablonun işlevsel adını kullanın: Kuruluş Adı Şablon Adı.
- Başlık düzeni kullanın.
- İşlevi açıklayan terimler kullanın.
- İlgili kuruluş tarafından yetki verilmedikçe şablon adlarında "Resmi" terimini kullanmaktan kaçının.
Örnekler: Şirketim Dönüşüm Ölçümü Etiketi, Şirketim Kampanya Kimliği Değişkeni
Açıklama
Şablon açıklaması, şablonun işlevinin kısa bir özeti olarak ayrıntılar sayfalarında görünen şablon açıklamasıdır.
- Şablonun işlevini açıklamak için kısa ve net cümleler kullanın.
- Şablonunuzun kullanıcıya nasıl avantaj sağladığını açıkça belirtin. Örneğin: "Example.com Kitle Oluşturucu şablonu, web sitesi ziyaretçilerinden yeni kitle listeleri oluşturmanıza yardımcı olabilir."
- Jargon kullanmaktan kaçının.
- Ek bilgi, dokümanlar ve destek bağlantıları ekleyin.
Simge
Şablon simgeniz, Etiket Yöneticisi'nde ve Topluluk Şablon Galerisi'nde küçük resim olarak gösterilir.
- Resim biçimi için PNG, JPEG veya GIF kullanın.
- Resim kare biçiminde, en az 48x48 piksel ve en fazla 96x96 piksel boyutunda olmalıdır.
- Dosya boyutu 50 kilobayttan az olmalıdır.
- İlgili kuruluş tarafından yetki verilmedikçe resmi şirket logolarını kullanmaktan kaçının.
- Alanlar
- Metin girişi, onay kutuları gibi form öğeleri eklemek için Şablon Düzenleyici'nin Alanlar sekmesini kullanın.
Alanlar
Bu stil yönergeleri, Şablon Düzenleyici'nin Alanlar sekmesi için geçerlidir.
Parametre adı
Bu, alanın Şablon Düzenleyici'de göründüğü şekliyle adıdır ancak kullanıcıya göründüğü şekliyle değildir. Adlar, kullanılan veri türünü açıklayıcı olmalıdır. Parametre adlarını lowerCamelCase olarak biçimlendirin. Örnekler: userName, customerID, shoppingCartValue.
Alan etiketleri
Alan etiketleri; görünen ad alanları, onay kutusu metni ve ilgili öğeleri içerir.
- Normal cümle düzeni kullanın.
- Ne kadar kısa olursa o kadar iyidir.
- Açıklayıcı olun.
- Yaygın kelimeler kullanın.
Yardım metni
Yardım metni, kullanıcının şablon alanına geçerli bir değer girmesine yardımcı olmak için ipucu olarak gösterilen bilgilendirici içeriktir. Mümkünse örnek giriş sağlayın ve şablon alanının nasıl kullanıldığını veya belirli değerlerin sağlanmasının etkisini açıklayın.
- Normal cümle düzeni kullanın.
- Kısa ve öz ama samimi olun. Kısaltmalar kullanmak ve ikinci şahıs (siz) şeklinde yazmak sorun yaratmaz.
- Desteklenen alan türleri
- Temel HTML biçimlendirmesine izin verilir. Örnekler:
<strong>, <em>.
Desteklenen alan türleri
Tür |
Açıklama |
| Metin girişi |
Metin girişi. Bu tür bir şablon parametresinin değeri, değişkenlere atıfta bulunabilecek bir dize olur. Etiket Yöneticisi kullanıcı arayüzünde oluşturulan metin girişi widget'ı tek satırlık bir metin alanı veya çok satırlık bir giriş olabilir. |
| Açılır menü |
Şablon parametresinin değeri olarak yalnızca tek bir öğenin seçilebileceği açılır menü. Aksini yapmanıza neden olacak bir durum yoksa öğeleri alfabetik olarak listeleyin. |
| Onay kutusu |
Onay kutusu girişi. Bu tür bir şablon parametresinin değeri boole olacaktır: işaretli için true, işaretsiz için false. |
| Radyo düğmesi |
Radyo girişi. Bu tür bir şablon parametresi, Etiket Yöneticisi kullanıcı arayüzünde seçeneklerin bir listesini sunar ve kullanıcının şablon parametresinin değeri olarak seçeneklerden yalnızca birini seçmesine izin verilir. |
| Basit tablo |
Basit bir tablo girişi. Tablodaki her hücre yerinde düzenlenebilir ve her hücre yalnızca iki türden biri olabilir: metin girişi veya açılır menü. Bu tür bir şablon parametresinin değeri bir nesne dizisidir: Her nesne bir satırı kodlar, nesnedeki her anahtar sütun adlarından biri olmalıdır ve nesnedeki her değer, ilgili hücrenin değeridir. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[[["\u003cp\u003eThis style guide helps you create templates for the Community Template Gallery, ensuring consistency and user-friendliness by adhering to Google Material Design writing principles.\u003c/p\u003e\n"],["\u003cp\u003eWhen naming your template, use your organization's name, a descriptive functional name in Title Case, and avoid using "Official" unless authorized.\u003c/p\u003e\n"],["\u003cp\u003eTemplate descriptions should clearly explain the template's function, benefits, and any supporting resources using concise language and avoiding jargon.\u003c/p\u003e\n"],["\u003cp\u003eTemplate icons must be square images (PNG, JPEG, or GIF) between 48px and 96px in size, under 50 kilobytes, and avoid using official logos without authorization.\u003c/p\u003e\n"],["\u003cp\u003eFor template fields, use descriptive parameter names in lowerCamelCase, concise and clear field labels in sentence case, and helpful tooltips written in a human-friendly tone.\u003c/p\u003e\n"]]],["Template guidelines for the Community Template Gallery include creating descriptive names using \"Organization Name Template Name\" in Title Case, clear descriptions detailing template functionality and user benefits, and square icons (48-96px, under 50KB). In the Fields tab, parameter names should be `lowerCamelCase`, field labels in sentence case, and concise, human-readable help text. Supported field types are text input, drop-down menu, checkbox, radio button, and simple table, with specific formatting rules.\n"],null,["# Template style guide\n\nThis style guide has been prepared to help you make decisions on how to prepare templates for the [Community Template Gallery](https://support.google.com/tagmanager/answer/9454109). This style guide is based on the [Google Material Design writing principles](https://material.io/design/communication/writing.html#principles). Simply put, these are:\n\n- Be concise\n- Write simply and directly\n- Address users clearly\n- Communicate essential details\n- Write for all reading levels\n- Be human: write for humans, not robots\n\nFollow these guidelines to help ensure that all templates have a consistent look and feel, and to help users understand how to use your template.\n\nInfo\n----\n\nThese guidelines apply to items found in the Template Editor's **Info** tab.\n\n### Name\n\nThe template name is presented to Tag Manager users throughout the Tag Manager user interface and Community Template Gallery. It appears at the top of a template's detail page, and appears when templates are listed.\n\n- Use your company/organization name and the functional name of the template: *Organization Name* *Template Name*.\n- Use Title Case.\n- Use terms that are descriptive of the functionality.\n- Avoid use of the term \"Official\" in template names, unless you are authorized to do so by the relevant organization.\n\n**Examples:** *MyCompany Conversion Measurement Tag, MyCompany Campaign ID Variable*\n\n### Description\n\nThe template description is a description of the template that appears on detail pages as a brief summary of the template functionality.\n\n- Use clear and concise sentences to describe what the template does.\n- Clearly state how your template benefits the user. For example: \"The Example.com Audience Builder template can help you build new audience lists from website visitors.\"\n- Avoid jargon.\n- Include links for additional information, documentation, and support.\n\n### Icon\n\nYour template icon is represented as a thumbnail when listed in Tag Manager and on the Community Template Gallery.\n\n- Use PNG, JPEG, or GIF for the image format.\n- Image should be square, at least 48px by 48px, and no larger than 96px by 96px.\n- File size must be less than 50 kilobytes.\n- Avoid use of official company logos, unless you are authorized to do so by the relevant organization.\n- Fields\n- Use the Template Editor's Fields tab to add form elements such as text input, checkboxes, etc.\n\nFields\n------\n\nThese style guidelines apply to the Template Editor's **Fields** tab.\n\n### Parameter name\n\nThis is the name of the field as it appears in the Template Editor, but not as it appears to the user. Names should be descriptive of the type of data used. Format parameter names as `lowerCamelCase`. **Examples:** *userName, customerID, shoppingCartValue*.\n\n### Field labels\n\nField labels include display name fields, checkbox text, and related items.\n\n- Use sentence case.\n- Shorter is better.\n- Be descriptive.\n- Use common words.\n\nHelp text\n---------\n\nHelp text is informational content, shown as a tooltip, to help the user enter a valid value into the template field. Provide example input, if possible, and describe how the template field is used or the effect of providing certain values.\n\n- Use sentence case.\n- Be concise, but be human. It's okay to use contractions and write in the 2nd person (you).\n- Supported field types\n- Basic HTML formatting is permitted. Examples: *`\u003cstrong\u003e`, `\u003cem\u003e`*.\n\nSupported field types\n---------------------\n\n| Type | Description |\n|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Text input** | Text input. The value of a template parameter of this type will be a string that may refer to variables. The text input widget rendered in the Tag Manager user interface could be either a single-line text field or a multi-line input. |\n| **Drop-down menu** | Drop-down menu in which only a single item could be selected as the value of the template parameter. List items in alphabetical order unless there is a good reason to do otherwise. |\n| **Checkbox** | Checkbox input. The value of a template parameter of this type will be boolean: true for checked, false for unchecked. |\n| **Radio button** | Radio input. A template parameter of this type presents a list of choices in the Tag Manager user interface and the user is only allowed to pick one of the choices as the value of the template parameter. |\n| **Simple table** | A simple table input. Each cell in the table can be edited in place, and each cell can only be of two types: a text input or a drop-down menu. The value of a template parameter of this type is an array of objects: each object encodes a row, each key in the object must be one of the column names, and each value in the object is the value of the corresponding cell. |"]]
