Topluluk Şablon Galerisi'ne şablon gönderme

Google Etiket Yöneticisi Topluluk Şablon Galerisi, kuruluşunuzun Google Etiket Yöneticisi ile doğal olarak entegre olan etiket ve değişken şablonları oluşturup yönetmesine olanak tanır. Kuruluşunuz bir şablon oluşturabilir, şablon deposunu GitHub'da yayınlayabilir ve ardından şablonunuzu dünya genelindeki kullanıcıların kullanımına sunmak için Topluluk Şablonu Galerisi'ne gönderebilir. Kuruluşunuza sağladığı avantajlar arasında şunlar yer alır:

• Müşterileriniz şablonlarınızı kolayca ekleyip kullanabilir.
• Etiket Yöneticisi kullanıcıları, kuruluşunuzun markasıyla karşılaşır.
• Müşterileriniz, etiketlerinizi aylarca değil dakikalar içinde dağıtabilir.
• Şablonlarınızda güncellemeler yayınlayabilir ve bu güncellemeleri müşterilerinizin otomatik olarak kullanabilmesini sağlayabilirsiniz.

Topluluk Şablon Galerisi'ne yeni şablon gönderme işleminin başlıca adımları şunlardır:

1. Şablonunuzu oluşturma
2. Proje dosyalarınızı hazırlama
3. Dosyalarınızı GitHub'a yükleme
4. Şablonunuzu gönderme

Şablonunuzu oluşturma

Başlamak için şablonunuzu Google Etiket Yöneticisi'nde özel şablon olarak oluşturun. Şablonunuzun ayrıntılı bir şekilde test edildiğinden, içeriğinin stil kılavuzuna uygun olduğundan ve gelecekte ihtiyaç duymanız halinde şablonunuzu nasıl koruyacağınız ve güncelleyeceğinize dair bir planınız veya süreciniz olduğundan emin olun.

Hizmet Şartları

Gönderilen her yeni şablon, Google Etiket Yöneticisi Topluluk Şablon Galerisi'nin Hizmet Şartları'na uygun olmalıdır. Şablonunuz için Hizmet Şartları'nı kabul ettiğinizi onaylamak üzere:

1. Google Etiket Yöneticisi Topluluk Şablon Galerisi Hizmet Şartları'nı okuyun.
2. Şablon Düzenleyici'de, şablonunuzu düzenlemek için açın ve Bilgi sekmesinin altındaki "Topluluk Şablon Galerisi Hizmet Şartları'nı Kabul Et" etiketli kutuyu işaretleyin.

Şablonunuzu dışa aktarma

Şablonunuz tamamlandıktan sonra şablon dosyasını yerel makinenize dışa aktarın ve dosyayı template.tpl olarak yeniden adlandırın.

Proje dosyalarınızı hazırlama

Bir sonraki adım, deponuzu GitHub'da yayınlanmaya hazırlamaktır. Her depo aşağıdaki dosyaları içermelidir:

1. template.tpl adlı dışa aktarılan bir şablon dosyası. Bu dosyaya categories girişi eklenecek şekilde güncelleme yapılmalıdır.
2. metadata.yaml dosyası.
3. LICENSE dosyası. Dosya adı BÜYÜK HARFLERLE yazılmalı ve lisans dosyasının içeriği yalnızca Apache 2.0 olmalıdır.
4. README.md dosyası ekleyin (isteğe bağlıdır ancak önerilir).

Not: GitHub'daki örnek şablon deposunu model olarak kullanın. İçerikte hata olmadığından emin olmak için örnek şablondaki LICENSE dosyasını projenize kopyalayın ve örnek sürümde "Copyright [yyyy] [name of copyright owner]" yazan telif hakkı satırını güncellediğinizden emin olun. yyyy yerine telif hakkının alındığı yılı, [name of copyright owner] yerine de telif hakkı sahibinin adını yazın.

template.tpl'e kategori ekleme

template.tpl dosyanızı INFO bölümüne bir categories girişi ekleyerek güncelleyin ve aşağıdaki tablodan seçilen en az bir alakalı kategori değeri sağlayın. Birden fazla kategori uygunsa en alakalıdan en az alakalıya göre sıralanmış en fazla üç kategori değeri sağlayabilirsiniz.

Not: categories girişinin değerleri dizi olarak biçimlendirilmelidir.

Örnek:

___INFO___

{
  "displayName": "Example Template",
  "categories": ["AFFILIATE_MARKETING", "ADVERTISING"],
  // additional template properties, etc...
}

Desteklenen kategori değerleri tablosu:

Kategori	Açıklama
REKLAMCILIK	Reklam
AFFILIATE_MARKETING	Satış ortaklığı pazarlaması
ANALİZ	Analiz
İLİŞKİLENDİRME	İlişkilendirme
SOHBET	Sohbet
DÖNÜŞÜM SAYISI	Dönüşüm ölçümü
DATA_WAREHOUSING	Veri Ambarı
EMAIL_MARKETING	E-posta ile Pazarlama
DENEYSEL	A/B denemeleri ve içerik optimizasyonu
HEAT_MAP	Isı haritaları
LEAD_GENERATION	Olası satış yaratma
PAZARLAMA	Pazarlama
KİŞİSELLEŞTİRME	Kişiselleştirme
YENİDEN PAZARLAMA	Yeniden Pazarlama
İNDİRİM	Satış ve CRM
SESSION_RECORDING	Oturum kayıtları
SOSYAL	Sosyal
ANKET	Anketler
TAG_MANAGEMENT	Etiket yönetimi sistemleri
KULLANIM	Google Etiket Yöneticisi yardımcı programları

metadata.yaml

metadata.yaml dosyası, kuruluşunuzun ana sayfasının bağlantıları, şablon dokümanları ve sürüm bilgileri de dahil olmak üzere şablonunuzla ilgili bilgileri içerir. Her sürüm, SHA numarası olarak da bilinen bir değişiklik numarasıyla gösterilir. Bu numara, Git commit'iyle ilişkili değişiklik numarasıdır. changeNotes alanı isteğe bağlıdır ancak kullanıcılarınızı sürüme dahil edilen değişiklikler hakkında bilgilendirmek için önerilir.

metadata.yaml dosyanızı ayarlamak için:

1. Giriş ekleyin homepage. Bu, kuruluşunuzun ana sayfasına yönlendiren bir URL olmalıdır.
2. documentation için bir giriş ekleyin. Bu, şablonunuzun belgelerini gösteren bir URL olmalıdır.
3. GitHub'da, şablonunuzun ilk sürümü için göndermek istediğiniz değişiklikleri içeren commit'i bulun ve SHA numarasını kopyalayın. GitHub'da SHA numarasını almanın kolay bir yolu, taahhüt görünümüne gidip panoya kopyala simgesini () tıklamaktır. Bu işlem, SHA numarasının tamamını panonuza kopyalar. Bu sayıyı, aşağıda gösterildiği gibi versions düğümünün alt öğesi olarak sha girişinizin değeri olarak yapıştırın.
4. Bu yeni sürümdeki değişiklikleri kısaca açıklamak için versions düğümüne bir changeNotes girişi ekleyin.

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

Önemli: sha ve changeNotes, yukarıdaki kod örneğinde gösterildiği gibi hizalanmalıdır.

Not: sha değeri, yayınlamak istediğiniz belirli template.tpl dosyasını referans almalıdır. Her yeni sürümde bu değeri doğru şekilde güncellemeyi unutmayın.

GitHub'a yükleme

Sonraki adım, dosyalarınızı GitHub'a yüklemektir. Yukarıdaki şekilde belirtildiği gibi uygun dosya ve yapıya sahip bir GitHub deposu oluşturun.

Şablon depolarında, Git deposunun kök düzeyinde * template.tpl, metadata.yaml ve LICENSE dosyaları bulunmalıdır. Her Git deposunda yalnızca bir template.tpl dosyası bulunmalıdır. Tüm kaynaklar, GitHub deponuzdaki ana dalda olmalıdır. Bu yapıyla eşleşmeyen tüm şablon depoları Galeri'den kaldırılır.

Topluluk Şablon Galerisi'ndeki her giriş, şablonun GitHub kod deposunun Sorunlar bölümüne bağlantı verir. Böylece kullanıcılar, bir hata bulduklarında size haber verebilir. Ortaya çıkan sorunları inceleyip giderebilmek için şablonunuzun GitHub deposunda sorunların devre dışı bırakılmadığından emin olun.

Şablonunuzu gönderme

Şablon deponuz GitHub'da barındırıldıktan sonra şablonunuzu Topluluk Şablon Galerisi'ne gönderebilirsiniz. Şablonunuzu göndermek için aşağıdaki adımları uygulayın:

1. Galeri'ye eklemek istediğiniz şablon deposuna erişimi olan bir hesapla GitHub'da oturum açtığınızdan emin olun.
2. tagmanager.google.com/gallery adresindeki Topluluk Şablon Galerisi'ne gidin.
3. simgesini tıklayın ve Şablon Gönder'i seçin.
4. Sağlanan alana depo URL'sini girin ve Gönder'i tıklayın.

Şablonunuzu güncelleme

Bir şablonu yayınladıktan sonra zaman zaman şablonunuzda güncellemeler yapmak isteyebilirsiniz. Şablonunuzda güncelleme olursa şablon kullanıcılarınıza bildirim gönderilir ve şablonu en son sürüme güncelleme seçeneği sunulur.

metadata.yaml dosyası, şablonunuzun galeride hangi sürümünün kullanılacağını belirlemek için kullanılır. Yeni sürümler yayınlamak için metadata.yaml dosyanızın versions bölümüne değişiklik numarasını (SHA numarası) eklemeniz gerekir.

1. Yayınlamak istediğiniz değişiklikleri içeren commit'i bulun ve SHA numarasını kopyalayın. Bunu yapmanın kolay bir yolu, GitHub'da bir taahhüt görünümüne gidip panosu simgesini () tıklamaktır. Bu işlem, SHA numarasının tamamını panonuza kopyalar.
2. metadata.yaml'de versions listenizin en üstüne yeni bir sha girişi ekleyin. (Aşağıdaki örneğe bakın.)
3. Bu yeni sürümdeki değişiklikleri kısaca açıklamak için changeNotes ekleyin. İsterseniz çok satırlı yorumlar oluşturabilirsiniz. (Aşağıdaki örneğe bakın.)
4. Değişikliği metadata.yaml'ye gönderin. Güncellemeniz genellikle 2-3 gün içinde galeride görünür.

Bu örnekte, SHA numarası ve değişiklik notları dahil olmak üzere yeni sürüm bilgilerinin nasıl ekleneceği gösterilmektedir:

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  # Latest version
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874c
    changeNotes: |2
      Fix bug with the whatsamajig.
      Improve menu options.
      Update API calls.
  # Older versions
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874b
    changeNotes: Adds eject button.
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

Önemli: Şablonun yayınlanan her sürümü, versions bölümüne ters zamansal sırayla (en yeniden en eskiye) eklenmelidir.

Not: Her artımlı taahhüt, sürüm değişikliği olarak Topluluk Şablonları Galerisi'ne eklenmemelidir. Örneğin, 1, 2 ve 3 numaralı taahhütlerde artımlı değişiklikler yaparsanız ve nihai sürüm 4 numaralı taahhütse 4 numaralı taahhüt için 1, 2 ve 3 numaralı taahhütlerdeki tüm değişiklikleri içeren tek bir girişiniz olmalıdır.

Deponuzu taşıma

Sahipleri veya depo adlarını değiştirmek istiyorsanız GitHub depo aktarma sürecini kullanabilirsiniz. Yeni konum algılanır ve kullanıcılar şablonu bir sonraki güncellemelerinde otomatik olarak yeni depoya yönlendirilir.

Şablonunuzu kaldırma

Bir şablonu galeriden kaldırmak için LICENSE veya metadata.yaml dosyasını deposundan silin. Galeri izleme sistemi bu değişikliği algılar ve şablonu otomatik olarak kaldırır.