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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

1. إنشاء النموذج
2. إعداد ملفات المشر��ع
3. تحميل ملفاتك إلى GitHub
4. إرسال النموذج

إنشاء النموذج

للبدء، أنشئ النموذج في أداة "إدارة العلامات من Google" كنموذج مخصّص. تأكَّد من أنّه تم اختبار النموذج بدقة وأنّ محتوى النموذج يتّبع دليل الأسلوب وأنّ لديك خطة أو عملية محددة حول كيفية صيانة النموذج وتحديثه في حال الحاجة إلى ذلك في المستقبل.

بنود الخدمة

يجب أن يوافق كل نموذج جديد يتم إرساله على بنود خدمة "معرض النماذج" في منتدى Google Tag Manager. لتأكيد موافقتك على بنود الخدمة الخاصة بالنموذج:

1. اقرأ بنود خدمة "معرض نماذج المنتدى" الخاص بأداة "إدارة العلامات من Google".
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...
}

جدول قيم الفئات المسموح بها:

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 الخاص بالنموذج حتى تتمكّن من مراجعة أي مشاكل تحدث وحلّها.

إرسال النموذج

بعد استضافة مستودع النماذج على GitHub، يمكنك المتابعة لإرسال النموذج إلى "معرض النماذج" في "المنتدى". لإرسال النموذج، اتّبِع الخطوات التالية:

1. تأكَّد من تسجيل الدخول إلى GitHub باستخدام حساب يمكنه الوصول إلى مستودع النماذج الذي تريد إضافته إلى "المعرض".
2. انتقِل إلى "معرض نماذج المنتدى" على tagmanager.google.com/gallery.
3. انقر على more_vert واختَر إرسال النموذج.
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 من مستودعه. سيرصد نظام مراقبة معرض الصور هذا التغيير ويزيل النموذج تلقائيًا.