Topluluk Şablon Galerisi'ne şablon gönderme

Google Etiket Yöneticisi Topluluk Şablon Galerisi, kuruluşunuzun Google Etiket Yöneticisi ile yerel olarak entegre olan etiket ve değişken şablonları oluşturmasına ve 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şunuzun elde edeceği avantajlar şunlardı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 aylar 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 bir şablon gönderme sürecinin 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 kapsamlı bir şekilde test edildiğinden, şablonunuzdaki içeriğin Stil Kılavuzu'na uygun olduğundan ve gelecekte şablonunuzu korumanız ve güncellemeniz gerekirse nasıl yapacağınıza dair bir planınız veya sürecinizin olduğundan emin olun.

Hizmet Şartları

Her yeni şablon gönderiminde Google Etiket Yöneticisi Topluluk Şablon Galerisi'nin Hizmet Şartları kabul edilmelidir. Şablonunuzun Hizmet Şartları'nı kabul ettiğinizi onaylamak için:

  1. Google Etiket Yöneticisi Topluluk Şablon Galerisi Hizmet Şartları'nı okuyun.
  2. Şablon Düzenleyici'de şablonunuzu düzenlemek üzere açın ve Bilgi sekmesindeki "Topluluk Şablon Galerisi Hizmet Şartları'nı kabul ediyorum" etiketli kutuyu işaretleyin.

Şablonunuzu dışa aktarma

Şablonunuz tamamlandıktan sonra şablon dosyasını yerel makinenize 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ınlamaya hazırlamaktır. Her depoda aşağıdaki dosyalar bulunmalıdır:

  1. template.tpl adlı bir dışa aktarılmış şablon dosyası. categories girişi eklemek için bu dosyanın güncellenmesi gerekir.
  2. metadata.yaml dosyası.
  3. LICENSE dosyası. Dosya adı tamamen 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).

template.tpl listesine kategori ekleme

template.tpl dosyanızı INFO bölümüne categories girişiyle 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 doğru sıralanmış şekilde en fazla üç kategori değeri sağlayabilirsiniz.

Örnek:

___INFO___

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

Desteklenen kategori değerlerinin tablosu:

Kategori Açıklama
REKLAMCILIK Reklam
AFFILIATE_MARKETING Satış ortaklığı pazarlaması
ANALİZ Analytics
İLİŞKİLENDİRME İlişkilendirme
SOHBET Sohbet
DÖNÜŞÜM SAYISI Dönüşüm ölçümü
DATA_WAREHOUSING Veri ambarlama
EMAIL_MARKETING E-posta ile Pazarlama
DENEME A/B denemeleri ve içerik optimizasyonu
HEAT_MAP Isı haritaları
LEAD_GENERATION Olası satış yaratma
PAZARLAMA Pazarlama
PERSONALIZATION 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
FAYDA Google Etiket Yöneticisi yardımcı programları

metadata.yaml

metadata.yaml dosyası, kuruluşunuzun ana sayfasına, şablon belgelerine ve sürüm bilgilerine giden bağlantılar da dahil olmak üzere şablonunuzla ilgili bilgileri içerir. Her sürüm, Git commit'iyle ilişkili değişiklik numarası olan SHA numarası olarak da bilinen bir değişiklik numarasıyla gösterilir. changeNotes alanı isteğe bağlıdır ancak kullanıcılarınızı sürümdeki değişiklikler hakkında bilgilendirmek için kullanılması ö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, şablonunuzla ilgili belgelere yönlendiren 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, commit görünümüne gidip pano simgesini (pano simgesi) tıklamaktır. Bu işlem, SHA numarasının tamamını panonuza kopyalar. Bu sayıyı, aşağıdaki örnekte 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ümde yer alan değişiklikleri kısaca açıklamak için changeNotes düğümüne bir versions girişi ekleyin.
homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

GitHub'a yükleme

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

Şablon depolarında, Git deposunun kök düzeyinde bulunan * template.tpl, metadata.yaml ve LICENSE dosyaları olmalıdır. Her Git deposunda yalnızca bir template.tpl dosyası olmalıdır. Tüm kaynaklar, GitHub deponuzdaki ana dalda olmalıdır. Bu yapıya uymayan tüm şablon depoları Galeriden kaldırılır.

Kullanıcıların hata bulmaları durumunda sizi bilgilendirebilmeleri için Topluluk Şablon Galerisi'ndeki her giriş, şablonun GitHub deposunun Sorunlar bölümüne bağlanır.

Ş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. GitHub'da, Galeri'ye eklemek istediğiniz şablon deposuna erişimi olan bir hesapla oturum açtığınızdan emin olun.
  2. tagmanager.google.com/gallery adresinden Topluluk Şablon Galerisi'ne gidin.
  3. simgesini tıklayın ve Şablon Gönder'i seçin.
  4. Depo URL'sini ilgili alana girip Gönder'i tıklayın.

Şablonunuzu güncelleme

Bir şablon yayınladıktan sonra zaman zaman şablonunuzda güncellemeler yapmak isteyebilirsiniz. Şablonda güncelleme olduğunda ş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ı, galeride şablonunuzun hangi sürümünün kullanılacağını belirlemek için kullanılır. Yeni sürümleri yayınlamak için değişiklik numarasını (SHA numarası) metadata.yaml dosyanızın versions bölümüne eklemeniz gerekir.

  1. Push etmek istediğiniz değişiklikleri içeren commit'i bulun ve SHA numarasını kopyalayın. Bunu GitHub'da yapmanın kolay bir yolu, commit görünümüne gidip pano simgesini (pano simgesi) tıklamaktır. Bu işlem, SHA numarasının tamamını panonuza kopyalar.
  2. metadata.yaml'deki 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'ya gönderdiğinizde güncellemeniz genellikle 2-3 gün içinde galeride görünür.

Bu örnekte, SHA numarası ve değişiklik notları da 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.

Deponuzu taşıma

Sahipleri veya depo adlarını değiştirmek istiyorsanız GitHub depo aktarım 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

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