یک الگو را به گالری الگوی انجمن ارسال کنید

گالری الگوهای انجمن گوگل تگ منیجر به سازمان شما اجازه می‌دهد تا الگوهای برچسب و متغیر را که به صورت بومی با گوگل تگ منیجر ادغام می‌شوند، ایجاد و مدیریت کند. سازمان شما می‌تواند یک الگو بسازد، مخزن الگوها را در گیت‌هاب منتشر کند و سپس الگوی خود را به گالری الگوهای انجمن ارسال کند تا در دسترس کاربران در سراسر جهان قرار گیرد. مزایای این کار برای سازمان شما عبارتند از:

• مشتریان شما می‌توانند به راحتی قالب‌های شما را اضافه و استفاده کنند.
• کاربران تگ منیجر با برند سازمان شما آشنا خواهند شد.
• مشتریان شما می‌توانند تگ‌های شما را ظرف چند دقیقه، نه چند ماه، مستقر کنند.
• شما می‌توانید به‌روزرسانی‌هایی را برای قالب‌های خود منتشر کنید و این به‌روزرسانی‌ها را به‌طور خودکار در دسترس مشتریان خود قرار دهید.

فرآیند ارسال یک الگوی جدید به گالری الگوهای انجمن شامل این مراحل اصلی است:

1. قالب خود را بسازید
2. فایل‌های پروژه خود را آماده کنید
3. فایل‌های خود را در گیت‌هاب آپلود کنید
4. قالب خود را ارسال کنید

قالب خود را بسازید

برای شروع، قالب خود را در Google Tag Manager به عنوان یک قالب سفارشی بسازید. مطمئن شوید که قالب شما کاملاً آزمایش شده است، محتوای قالب شما از راهنمای سبک پیروی می‌کند و برنامه یا فرآیندی برای نحوه نگهداری و به‌روزرسانی قالب خود در صورت نیاز در آینده دارید.

شرایط خدمات

هر قالب جدیدی که ارسال می‌شود باید با شرایط خدمات گالری قالب انجمن گوگل تگ منیجر موافقت کند. برای تأیید موافقت با شرایط خدمات قالب خود:

1. شرایط خدمات گالری قالب انجمن گوگل تگ منیجر را مطالعه کنید.
2. در ویرایشگر قالب، قالب خود را برای ویرایش باز کنید و در زیر برگه اطلاعات ، کادر «موافق با شرایط خدمات گالری قالب انجمن» را علامت بزنید.

قالب خود را صادر کنید

پس از تکمیل قالب، فایل قالب را به دستگاه محلی خود صادر کنید و نام فایل را به template.tpl تغییر دهید.

فایل‌های پروژه خود را آماده کنید

مرحله بعدی آماده‌سازی مخزن شما برای انتشار در گیت‌هاب است. هر مخزن باید شامل فایل‌های زیر باشد:

1. یک فایل الگوی اکسپورت شده با نام template.tpl . این فایل باید برای افزودن ورودی categories به‌روزرسانی شود.
2. یک فایل metadata.yaml .
3. یک فایل LICENSE . نام فایل باید کاملاً با حروف بزرگ نوشته شود و محتوای فایل لایسنس باید فقط Apache 2.0 باشد.
4. یک فایل README.md اضافه کنید (اختیاری، اما توصیه می‌شود).

نکته: از مخزن الگوی نمونه در گیت‌هاب به عنوان مدل استفاده کنید. فایل LICENSE را از الگوی نمونه به پروژه خود کپی کنید تا کاملاً مطمئن شوید که هیچ خطایی در محتوا وجود ندارد و حتماً خط مربوط به حق چاپ را که در نسخه نمونه نوشته شده است، یعنی " Copyright [yyyy] [name of copyright owner] " به‌روزرسانی کنید. yyyy با سال حق چاپ و [name of copyright owner] را با نام صاحب حق چاپ جایگزین کنید.

افزودن دسته‌ها به template.tpl

فایل template.tpl خود را با اضافه کردن یک ورودی categories به بخش INFO به‌روزرسانی کنید و حداقل یک مقدار دسته‌بندی مرتبط را که از جدول زیر انتخاب شده است، ارائه دهید. اگر بیش از یک دسته‌بندی مناسب است، می‌توانید تا سه مقدار دسته‌بندی را ارائه دهید که از مرتبط‌ترین تا کم‌ربط‌ترین مرتب شده‌اند.

توجه: مقادیر مربوط به ورودی categories باید به صورت آرایه قالب‌بندی شوند.

مثال:

___INFO___

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

جدول مقادیر دسته‌بندی پشتیبانی‌شده:

دسته بندی	توضیحات
تبلیغات	تبلیغات
بازاریابی وابسته	بازاریابی وابسته
تجزیه و تحلیل	تجزیه و تحلیل
انتساب	انتساب
چت	چت
تبدیل‌ها	اندازه‌گیری تبدیل
انبار داده	انبار داده
بازاریابی ایمیلی	بازاریابی ایمیلی
آزمایش	آزمایش‌های A/B و بهینه‌سازی محتوا
نقشه حرارتی	نقشه‌های حرارتی
تولید سرب	تولید سرنخ (لید)
بازاریابی	بازاریابی
شخصی سازی	شخصی سازی
بازاریابی مجدد	بازاریابی مجدد
فروش	فروش و CRM
ضبط جلسه	ضبط جلسات
اجتماعی	اجتماعی
نظرسنجی	نظرسنجی‌ها
مدیریت برچسب	سیستم‌های مدیریت برچسب
سودمندی	ابزارهای گوگل تگ منیجر

فراداده.yaml

فایل metadata.yaml حاوی اطلاعاتی در مورد الگوی شما، از جمله پیوندهایی به صفحه اصلی سازمان شما، مستندات الگو و اطلاعات نسخه است. هر نسخه با یک شماره تغییر، که به عنوان شماره SHA نیز شناخته می‌شود، مشخص می‌شود که شماره تغییر مرتبط با کامیت Git است. فیلد changeNotes اختیاری است، اما توصیه می‌شود تا کاربران خود را از تغییرات موجود در نسخه مطلع کنید.

برای تنظیم فایل metadata.yaml خود:

1. یک homepage برای ورودی اضافه کنید. این باید یک URL باشد که به صفحه اصلی سازمان شما اشاره می‌کند.
2. یک ورودی برای documentation اضافه کنید. این باید یک URL باشد که به مستندات قالب شما اشاره می‌کند.
3. در گیت‌هاب، کامیتی را که شامل تغییراتی است که می‌خواهید برای نسخه اولیه قالب خود اعمال کنید، پیدا کنید و شماره SHA را کپی کنید. یک راه آسان برای دریافت شماره SHA در گیت‌هاب، رفتن به نمای کامیت و کلیک بر روی آیکون کلیپ‌بورد ( ). این کار کل شماره SHA را در کلیپ‌بورد شما کپی می‌کند. آن شماره را به عنوان مقدار ورودی sha خود به عنوان فرزند گره versions ، همانطور که در زیر نشان داده شده است، جای‌گذاری کنید.
4. یک ورودی changeNotes به گره versions اضافه کنید تا تغییرات موجود در این نسخه جدید را به طور خلاصه شرح دهد.

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

مهم: sha و changeNotes باید مطابق مثال کد بالا تراز شوند.

نکته: مقدار sha باید به فایل template.tpl خاصی که می‌خواهید منتشر کنید، ارجاع دهد. فراموش نکنید که این مقدار را با هر نسخه جدید به درستی به‌روزرسانی کنید!

آپلود در گیت‌هاب

مرحله بعدی آپلود فایل‌هایتان در گیت‌هاب است. یک مخزن گیت‌هاب با فایل‌ها و ساختار مناسب همانطور که در بالا ذکر شد، ایجاد کنید.

مخازن قالب باید فایل‌های * template.tpl ، metadata.yaml و LICENSE را که در سطح ریشه مخزن Git یافت می‌شوند، داشته باشند. هر مخزن Git فقط باید یک فایل template.tpl داشته باشد. همه منابع باید در شاخه اصلی مخزن GitHub شما باشند. هر مخزن قالبی که با این ساختار مطابقت نداشته باشد، از گالری حذف خواهد شد.

هر ورودی در گالری قالب انجمن به بخش مشکلات (Issues) در مخزن گیت‌هاب قالب پیوند خواهد داشت تا کاربران بتوانند در صورت یافتن اشکال (باگ) به شما اطلاع دهند.

مهم: مطمئن شوید که بخش مشکلات (Issues) برای مخزن گیت‌هاب قالب شما غیرفعال نشده باشد و اعلان‌های ایمیلی فعال باشند تا بتوانید از هرگونه مشکلی که در طول بررسی قالب پیش می‌آید، مطلع شوید.

قالب خود را ارسال کنید

پس از اینکه مخزن قالب شما در گیت‌هاب میزبانی شد، می‌توانید قالب خود را به گالری قالب‌های انجمن ارسال کنید. برای ارسال قالب خود، این مراحل را دنبال کنید:

1. مطمئن شوید که با حسابی که به مخزن قالبی که می‌خواهید به گالری اضافه کنید دسترسی دارد، وارد گیت‌هاب شده‌اید.
2. به گالری الگوهای انجمن در tagmanager.google.com/gallery بروید.
3. روی کلیک کنید و ارسال الگو را انتخاب کنید.
4. آدرس مخزن (Repository URL) را در فیلد مربوطه وارد کرده و روی ارسال (Submit) کلیک کنید.

قالب خود را به‌روزرسانی کنید

پس از انتشار یک قالب، ممکن است بخواهید هر از گاهی به‌روزرسانی‌هایی برای قالب خود ارائه دهید. در صورت وجود به‌روزرسانی برای قالب، به کاربران قالب شما اطلاع داده می‌شود و می‌توانند قالب را به آخرین نسخه به‌روزرسانی کنند .

فایل metadata.yaml برای تعیین نسخه‌ای از قالب شما که باید در گالری استفاده شود، استفاده می‌شود. برای انتشار نسخه‌های جدید، باید شماره تغییر (شماره SHA) را به بخش versions فایل metadata.yaml خود اضافه کنید.

1. کامیتی که شامل تغییراتی است که می‌خواهید اعمال کنید را پیدا کنید و شماره SHA را کپی کنید. یک راه آسان برای انجام این کار در GitHub این است که به نمای کامیت بروید و روی آیکون کلیپ‌بورد () کلیک کنید. ). این کار کل شماره SHA را در کلیپ‌بورد شما کپی می‌کند.
2. یک ورودی sha جدید به بالای لیست versions خود در metadata.yaml اضافه کنید. (به مثال زیر مراجعه کنید.)
3. برای توضیح مختصر تغییرات موجود در این نسخه جدید، changeNotes اضافه کنید. در صورت تمایل می‌توانید کامنت‌های چندخطی ایجاد کنید. (به مثال زیر مراجعه کنید.)
4. تغییر را در metadata.yaml ثبت کنید و به‌روزرسانی شما معمولاً ظرف ۲ تا ۳ روز در گالری ظاهر می‌شود.

این مثال نحوه اضافه کردن اطلاعات نسخه جدید شامل شماره SHA و یادداشت‌های تغییر را نشان می‌دهد:

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.

مهم: هر نسخه منتشر شده از الگو باید در بخش versions که به ترتیب زمانی معکوس (از جدیدترین به قدیمی‌ترین) مرتب شده‌اند، گنجانده شود.

نکته: لازم نیست هر کامیت افزایشی به عنوان تغییر نسخه در گالری قالب‌های انجمن گنجانده شود. برای مثال، اگر تغییرات افزایشی را در کامیت‌های ۱، ۲ و ۳ ایجاد کنید و نسخه نهایی کامیت ۴ باشد، باید فقط یک ورودی برای کامیت ۴ داشته باشید که شامل تمام تغییرات از کامیت‌های ۱، ۲ و ۳ باشد.

مخزن خود را جابجا کنید

اگر می‌خواهید مالکان یا نام مخزن را تغییر دهید، می‌توانید از فرآیند انتقال مخزن GitHub استفاده کنید. مکان جدید شناسایی می‌شود و کاربران دفعه بعد که الگو را به‌روزرسانی می‌کنند، به‌طور خودکار به مخزن جدید هدایت می‌شوند.

قالب خود را حذف کنید

برای حذف یک الگو از گالری، فایل LICENSE یا فایل metadata.yaml را از مخزن آن حذف کنید. سیستم نظارت بر گالری این تغییر را تشخیص داده و به طور خودکار الگو را حذف می‌کند.