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

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

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

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

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

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

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

شرایط خدمات

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

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

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

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

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

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

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

دسته بندی را به template.tpl اضافه کنید

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

مثال:

___INFO___

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

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

دسته بندی توضیحات
تبلیغات تبلیغات
AFFILIATE_MARKETING بازاریابی وابسته
تجزیه و تحلیل تجزیه و تحلیل
انتساب انتساب
چت چت کنید
تبدیل ها اندازه گیری تبدیل
DATA_WAREHOUSING ذخیره سازی داده ها
EMAIL_MARKETING بازاریابی ایمیلی
آزمایش آزمایش های A/B و بهینه سازی محتوا
HEAT_MAP نقشه های حرارتی
LEAD_GENERATION تولید سرب
بازاریابی بازاریابی
شخصی سازی شخصی سازی
بازاریابی مجدد بازاریابی مجدد
فروش فروش و CRM
SESSION_RECORDING ضبط های جلسه
اجتماعی اجتماعی
نظرسنجی نظرسنجی ها
TAG_MAGEMENT سیستم های مدیریت برچسب
سودمند ابزارهای Google Tag Manager

metadata.yaml

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

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

  1. یک homepage ورودی اضافه کنید. این باید یک URL باشد که به صفحه اصلی سازمان شما اشاره می کند.
  2. یک ورودی برای documentation اضافه کنید. این باید یک URL باشد که به اسناد الگوی شما اشاره می کند.
  3. در GitHub، commit را پیدا کنید که شامل تغییراتی است که می‌خواهید برای نسخه اولیه قالب خود اعمال کنید و شماره SHA را کپی کنید. یک راه آسان برای دریافت شماره SHA در GitHub این است که به نمای commit بروید و روی نماد کلیپ بورد کلیک کنید ( clipboard icon ). با این کار کل شماره SHA در کلیپ بورد شما کپی می شود. همانطور که در زیر نشان داده شده است، آن عدد را به عنوان مقدار ورودی sha خود به عنوان فرزند گره versions قرار دهید.
  4. برای توضیح مختصر تغییرات موجود در این نسخه جدید، یک ورودی changeNotes را به گره versions اضافه کنید. 
homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

در GitHub آپلود کنید

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

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

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

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

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

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

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

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

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

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

این مثال نحوه اضافه کردن اطلاعات نسخه جدید از جمله شماره 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.