Mengirim template ke Galeri Template Komunitas

Galeri Template Komunitas Google Tag Manager memungkinkan organisasi Anda untuk membuat serta mengelola template tag dan variabel yang terintegrasi secara native dengan Google Tag Manager. Organisasi Anda dapat membuat template, memublikasikan repositori template ke GitHub, lalu mengirim template Anda ke Galeri Template Komunitas agar tersedia bagi pengguna di seluruh dunia. Manfaatnya bagi organisasi Anda antara lain:

• Klien Anda dapat menambahkan dan menggunakan template Anda dengan mudah.
• Pengguna Tag Manager akan terekspos merek organisasi Anda.
• Klien Anda dapat men-deploy tag Anda dalam hitungan menit, bukan bulan.
• Anda dapat memublikasikan update ke template dan membuat update tersebut secara otomatis tersedia untuk klien Anda.

Proses pengiriman template baru ke Galeri Template Komunitas melibatkan langkah-langkah utama berikut:

1. Membuat template
2. Menyiapkan file project
3. Mengupload file ke GitHub
4. Mengirim template

Membuat template

Untuk memulai, buat template Anda di Google Tag Manager sebagai template kustom. Pastikan template Anda telah diuji secara menyeluruh, dan konten template Anda mengikuti Panduan Gaya, serta Anda sudah memiliki rencana atau proses terkait cara mempertahankan dan memperbarui template jika diperlukan di masa mendatang.

Persyaratan Layanan

Setiap pengiriman template baru harus sesuai dengan Persyaratan Layanan Galeri Template Komunitas Google Tag Manager. Untuk mengonfirmasi persetujuan terhadap Persyaratan Layanan untuk template Anda:

1. Baca Persyaratan Layanan Galeri Template Komunitas Google Tag Manager.
2. Di Editor Template, buka template Anda untuk diedit, lalu centang kotak di bagian tab Info yang berlabel "Setuju dengan Persyaratan Layanan Galeri Template Komunitas".

Mengekspor template

Setelah template selesai, ekspor file template ke komputer lokal Anda dan ganti nama file template.tpl.

Menyiapkan file project

Langkah berikutnya adalah menyiapkan repositori untuk dipublikasikan di GitHub. Setiap repositori harus berisi file berikut:

1. File template yang diekspor dengan nama template.tpl. File ini harus diupdate untuk menambahkan entri categories.
2. File metadata.yaml.
3. File LICENSE. Nama file harus dalam HURUF BESAR SEMUA dan konten file lisensi hanya boleh Apache 2.0.
4. Tambahkan file README.md (opsional, tetapi direkomendasikan).

Catatan: Gunakan contoh repositori template di GitHub sebagai model. Salin file LICENSE dari contoh template ke project Anda untuk benar-benar memastikan bahwa tidak ada error dalam konten, dan pastikan untuk memperbarui baris Hak Cipta yang menyatakan "Copyright [yyyy] [name of copyright owner]" dalam contoh versi. Ganti yyyy dengan tahun hak cipta dan [name of copyright owner] dengan nama pemilik hak cipta.

Menambahkan kategori ke template.tpl

Perbarui file template.tpl Anda dengan entri categories di bagian INFO, dan berikan setidaknya satu nilai kategori relevan yang dipilih dari tabel berikut. Jika ada lebih dari satu kategori yang sesuai, Anda dapat memberikan hingga tiga nilai kategori, diurutkan dari yang paling relevan ke yang paling tidak relevan.

Catatan: Nilai untuk entri categories harus diformat sebagai array.

Contoh:

___INFO___

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

Tabel nilai kategori yang didukung:

Kategori	Deskripsi
ADVERTISING	Iklan
AFFILIATE_MARKETING	Marketing afiliasi
ANALYTICS	Analisis
ATTRIBUTION	Atribusi
CHAT	Chat
YANG DIOPT.	Pengukuran konversi
DATA_WAREHOUSING	Data Warehousing
EMAIL_MARKETING	Pemasaran Melalui Email
EXPERIMENTATION	Eksperimen A/B dan pengoptimalan konten
HEAT_MAP	Heat map
LEAD_GENERATION	Perolehan prospek
MARKETING	Pemasaran
PERSONALIZATION	Personalisasi
REMARKETING	Pemasaran Ulang
SALES	Penjualan dan CRM
SESSION_RECORDING	Rekaman sesi
SOCIAL	Sosial
SURVEY	Survei
TAG_MANAGEMENT	Sistem pengelolaan tag
UTILITY	Utilitas Google Tag Manager

metadata.yaml

File metadata.yaml berisi informasi tentang template Anda, termasuk link ke halaman beranda organisasi Anda, dokumentasi template, dan informasi versi. Setiap versi ditunjukkan dengan nomor perubahan, yang juga dikenal sebagai nomor SHA, yang merupakan nomor perubahan yang terkait dengan Git commit. Kolom changeNotes bersifat opsional, tetapi direkomendasikan, untuk memberi tahu pengguna Anda tentang perubahan yang disertakan dalam versi.

Untuk menyiapkan file metadata.yaml:

1. Tambahkan entri homepage. Entri ini harus berupa URL yang mengarah ke halaman beranda organisasi Anda.
2. Tambahkan entri untuk documentation. Entri ini harus berupa URL yang mengarah ke dokumentasi untuk template Anda.
3. Di GitHub, temukan commit yang menyertakan perubahan yang ingin Anda dorong untuk versi awal template Anda dan salin nomor SHA. Cara mudah untuk mendapatkan nomor SHA di GitHub adalah dengan membuka tampilan commit, lalu mengklik ikon papan klip (). Tindakan ini akan menyalin seluruh nomor SHA ke papan klip. Tempelkan nomor tersebut sebagai nilai untuk entri sha Anda sebagai turunan node versions, seperti yang ditunjukkan di bawah.
4. Tambahkan entri changeNotes ke node versions, untuk mendeskripsikan secara singkat perubahan yang terdapat dalam versi baru ini.

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

Penting: sha dan changeNotes harus selaras seperti yang ditunjukkan dalam contoh kode di atas.

Catatan: Nilai sha harus merujuk ke file template.tpl spesifik yang ingin Anda publikasikan. Jangan lupa untuk memperbarui nilai ini dengan benar dalam setiap versi baru.

Mengupload ke GitHub

Langkah berikutnya adalah mengupload file Anda ke GitHub. Buat repo GitHub dengan file dan struktur yang sesuai seperti yang diuraikan di atas.

Repositori template harus memiliki file * template.tpl, metadata.yaml, dan LICENSE yang ditemukan di level root repositori Git. Setiap repositori Git hanya boleh memiliki satu file template.tpl. Semua resource harus berada di cabang utama dalam repositori GitHub Anda. Semua repositori template yang tidak cocok dengan struktur ini akan dihapus dari Galeri.

Setiap entri di Galeri Template Komunitas akan ditautkan ke bagian Masalah di repositori GitHub template, sehingga pengguna dapat memberi tahu Anda jika mereka menemukan bug. Pastikan bahwa masalah belum dinonaktifkan untuk repositori GitHub template, sehingga Anda dapat meninjau dan mengatasi masalah apa pun yang muncul.

Mengirim template

Setelah repositori template Anda dihosting di GitHub, Anda dapat melanjutkan pengiriman template ke Galeri Template Komunitas. Untuk mengirim template, ikuti langkah-langkah berikut:

1. Pastikan Anda login ke GitHub dengan akun yang memiliki akses ke repositori template yang ingin ditambahkan ke Galeri.
2. Buka Galeri Template Komunitas di tagmanager.google.com/gallery.
3. Klik , lalu pilih Kirim Template.
4. Masukkan URL Repositori di kolom yang disediakan, lalu klik Kirim.

Mengupdate template

Setelah memublikasikan template, Anda dapat menyediakan update untuk template dari waktu ke waktu. Pengguna template akan diberi tahu jika ada update untuk template dan akan memiliki opsi untuk mengupdate template tersebut ke versi terbaru.

File metadata.yaml digunakan untuk menentukan versi template yang akan digunakan di galeri. Untuk memublikasikan versi baru, Anda harus menambahkan nomor perubahan (nomor SHA) ke bagian versions dalam file metadata.yaml Anda.

1. Temukan commit yang menyertakan perubahan yang ingin Anda dorong, dan salin nomor SHA. Cara mudah untuk melakukannya adalah di GitHub, buka tampilan commit, lalu klik ikon papan klip (). Tindakan ini akan menyalin seluruh nomor SHA ke papan klip.
2. Tambahkan entri sha baru ke bagian atas daftar versions di metadata.yaml. (Lihat contoh di bawah.)
3. Tambahkan changeNotes untuk menjelaskan secara singkat perubahan yang terdapat dalam versi baru ini. Anda dapat membuat komentar dengan banyak baris jika diinginkan. (Lihat contoh di bawah.)
4. Lakukan perubahan pada metadata.yaml dan perubahan tersebut akan muncul di galeri, biasanya dalam waktu 2 hingga 3 hari.

Contoh ini menunjukkan cara menambahkan informasi versi baru termasuk nomor SHA dan catatan perubahan:

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.

Penting: Setiap versi template yang dipublikasikan harus disertakan di bagian versions yang disusun dalam urutan kronologis terbalik, (terbaru ke terlama).

Catatan: Tidak semua commit inkremental perlu disertakan sebagai perubahan versi di Galeri Template Komunitas. Misalnya, jika Anda melakukan perubahan tambahan di commit 1, 2, dan 3, dan versi final adalah commit 4, Anda hanya perlu memiliki satu entri untuk commit 4 yang menyertakan semua perubahan dari commit 1, 2, dan 3.