إرسال نموذج إلى معرض نماذج المنتدى

يتيح "معرض نماذج المنتدى" في Google Tag Manager لمؤسستك إنشاء نماذج العلامات والمتغيّرات وإدارتها، والتي تتكامل بشكلٍ أصلي مع Google Tag Manager. يمكن لمؤسستك إنشاء نموذج ونشر مستودع النماذج على GitHub، ثم إرسال النموذج إلى "معرض نماذج المنتدى" لإتاحته للمستخدمين في جميع أنحاء العالم. تشمل المزايا التي تعود على مؤسستك ما يلي:

  • سيتمكّن عملاؤك من إضافة نماذجك واستخدامها بسهولة.
  • سيطّلع مستخدمو Tag Manager على العلامة التجارية لمؤسستك.
  • سيتمكّن عملاؤك من نشر علاماتك في غضون دقائق بدلاً من أشهر.
  • يمكنك نشر تعديلات على نماذجك وإتاحتها تلقائيًا لعملائك.

تتضمّن عملية إرسال نموذج جديد إلى "معرض نماذج المنتدى" الخطوات الرئيسية التالية:

  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 التسويق بالعمولة
إحصاءات YouTube إحصاءات Google
الإحالة تحديد المصدر
محادثة محادثة
الإحالات الناجحة قياس الإحالات الناجحة
DATA_WAREHOUSING تخزين البيانات
EMAIL_MARKETING التسويق عبر البريد الإلكتروني
التجارب تجارب A/B وتحسين المحتوى
HEAT_MAP خرائط التمثيل اللوني
LEAD_GENERATION إنشاء قوائم العملاء المحتملِين
التسويق التسويق
PERSONALIZATION التخصيص
تجديد النشاط التسويقي تجديد النشاط التسويقي
المبيعات المبيعات وإدارة علاقات العملاء
SESSION_RECORDING تسجيلات الجلسات
SOCIAL اجتماعي
SURVEY استطلاعات رأي
TAG_MANAGEMENT أنظمة إدارة العلامات
أداة مساعدة أدوات Google Tag Manager المساعدة

metadata.yaml

يحتوي ملف metadata.yaml على معلومات عن نموذجك، بما في ذلك روابط إلى الصفحة الرئيسية لمؤسستك ومستندات النموذج ومعلومات الإصدار. يُشار إلى كل إصدار برقم تغيير، يُعرف أيضًا برقم SHA، وهو رقم التغيير المرتبط بعملية الإرسال في Git. حقل changeNotes اختياري، ولكن يُنصح باستخدامه لإعلام المستخدمين بالتغييرات المضمّنة في الإصدار.

لإعداد ملف metadata.yaml:

  1. أضِف إدخال homepage. يجب أن يكون عنوان URL يؤدي إلى الصفحة الرئيسية لمؤسستك.
  2. أضِف إدخالاً لـ documentation. يجب أن يكون عنوان URL يؤدي إلى مستندات نموذجك.
  3. في GitHub، ابحث عن عملية الإرسال التي تتضمّن التغييرات التي تريد نشرها للإصدار الأولي من نموذجك وانسخ رقم SHA. إحدى الطرق السهلة للحصول على رقم SHA في GitHub هي الانتقال إلى عرض عملية إرسال والنقر على رمز الحافظة (رمز الحافظة). سيؤدي ذلك إلى نسخ رقم 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، يمكنك المتابعة لإرسال نموذجك إلى "معرض نماذج المنتدى". لإرسال نموذجك، اتّبِع الخطوات التالية:

  1. تأكَّد من تسجيل الدخول إلى GitHub باستخدام حساب يمكنه الوصول إلى مستودع النماذج الذي تريد إضافته إلى المعرض.
  2. انتقِل إلى "معرض نماذج المنتدى" على tagmanager.google.com/gallery.
  3. انقر على ثم على إرسال النموذج.
  4. أدخِل عنوان URL للمستودع في الحقل المخصّص لذلك، ثم انقر على إرسال.

تعديل النموذج

بعد نشر نموذج، قد ترغب في تقديم تعديلات عليه من حين لآخر. سيتم إعلام مستخدمي نموذجك في حال توفّر تعديل للنموذج، وسيكون لديهم خيار تعديل النموذج إلى أحدث إصدار.

يُستخدم ملف metadata.yaml لتحديد إصدار نموذجك الذي سيتم استخدامه في المعرض. لنشر إصدارات جديدة، عليك إضافة رقم التغيير (رقم SHA) إلى قسم versions في ملف metadata.yaml.

  1. حدِّد عملية الإرسال التي تتضمّن التغييرات التي تريد نشرها، وانسخ رقم SHA. إحدى الطرق السهلة للقيام بذلك في GitHub هي الانتقال إلى عرض عملية إرسال والنقر على رمز الحافظة (رمز الحافظة). سيؤدي ذلك إلى نسخ رقم SHA بالكامل إلى الحافظة.
  2. أضِف إدخال sha جديدًا إلى أعلى قائمة versions في metadata.yaml. (اطّلِع على المثال أدناه).
  3. أضِف changeNotes لوصف التغييرات المضمّنة في هذا الإصدار الجديد بإيجاز. يمكنك إنشاء تعليقات متعددة الأسطر، إذا أردت. (اطّلِع على المثال أدناه).
  4. أرسِل التغيير إلى metadata.yaml وسيظهر التعديل في المعرض عادةً في غضون يومَين إلى 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.

نقل المستودع

إذا أردت تغيير المالكين أو أسماء المستودعات، يمكنك استخدام عملية نقل مستودع GitHub. سيتم رصد الموقع الجغرافي الجديد وسيتم تلقائيًا إعادة توجيه المستخدمين إلى المستودع الجديد في المرة القادمة التي يحدّثون فيها النموذج.

إزالة النموذج

لإزالة نموذج من المعرض، عليك حذف ملف LICENSE أو ملف metadata.yaml من مستودعه. سيرصد نظام مراقبة المعرض هذا التغيير ويزيل النموذج تلقائيًا.