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

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

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

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

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

إنشاء نموذجك

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

بنود الخدمة

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

  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...
}

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

الفئة الوصف
عرض الإعلانات الإعلانات
AFFILIATE_MARKETING شبكة الإعلانات
إحصاءات YouTube الإحصاءات
الإحالة تحديد المصدر
محادثة دردشة
الإحالات الناجحة قياس الإحالات الناجحة
DATA_WAREHOUSING تخزين البيانات
EMAIL_MARKETING التسويق عبر البريد الإلكتروني
التجربة تجارب أ/ب وتحسين المحتوى
HEAT_MAP خرائط التمثيل اللوني
LEAD_GENERATION إنشاء قوائم العملاء المحتملِين
التسويق التسويق
التخصيص التخصيص
تجديد النشاط التسويقي تجديد النشاط التسويقي
أسعار مخفَّضة المبيعات وإدارة علاقات العملاء
SESSION_RECORDING تسجيلات الجلسة
اجتماعي اجتماعية
SURVEY استطلاعات رأي
TAG_MANAGEMENT أنظمة إدارة العلامات
الأداة المساعدة أدوات "إدارة العلامات من Google"

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، يمكنك متابعة إرسال النموذج إلى "معرض نماذج المنتدى". لإرسال النموذج، اتبع الخطوات التالية:

  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.