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

ويسمح معرض نماذج منتدى "إدارة العلامات من 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...
}

جدول قيم الفئات المتوافقة:

الفئة الوصف
الإعلان الإعلانات
التسويق للعلامة التجارية شبكة الإعلانات
إحصاءات YouTube إحصاءات
الإحالة الإحالة
محادثة Chat
المحسنة قياس الإحالات الناجحة
تخزين البيانات تخزين البيانات
التسويق عبر البريد الإلكتروني التسويق عبر البريد الإلكتروني
الاختبار تجارب أ/ب وتحسين المحتوى
HEAT_MAP خرائط التمثيل اللوني
جذب العملاء المحتملين جذب العملاء المحتملين
جارٍ التسويق Marketing
التخصيص التخصيص
تجديد النشاط التسويقي تجديد النشاط التسويقي
أسعار مخفَّضة المبيعات وإدارة علاقات العملاء
جلسة_التسجيل تسجيلات الجلسات
الشبكات الاجتماعية اجتماعية
استطلاع استطلاعات رأي
الإدارة أنظمة إدارة العلامات
برامج الخدمات برامج إدارة العلامات من Google

data.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. انقر على واختر إرسال نموذج.
  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.