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

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

ملاحظة: يمكنك استخدام نموذج نموذج المستودع في GitHub كنموذج. انسخ ملف LICENSE من نموذج النموذج إلى مشروعك للتأكد من عدم وجود أخطاء في المحتوى، وتأكّد من تحديث سطر حقوق الطبع والنشر بحيث يتضمن "الاقتباسCopyright [yyyy] [name of copyright owner]". استبدِل yyyy بسنة حقوق الطبع والنشر و[name of copyright owner] باسم مالك حقوق الطبع والنشر.

إضافة فئات إلى template.tpl

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

ملاحظة: يجب تنسيق قيم إدخال categories كمصفوفة.

مثال:

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

ملاحظة مهمة: يجب أن تتم محاذاة sha وchangeNotes كما هو موضّح في المثال أعلاه.

ملاحظة: يجب أن تشير قيمة sha إلى ملف للنموذج.tpl المحدد الذي تريد نشره. ولا تنسَ تعديل هذه القيمة بشكل صحيح في كل إصدار جديد.

تحميل إلى 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.

معلومة مُهمّة: يجب تضمين كل نسخة منشورة من النموذج في قسم versions المُرتَّب بتسلسل زمني عكسي (الأحدث والأقدم).

ملاحظة: لا يجب تضمين كل تزايد متزايد في التغييرات كمجموعة تغييرات في معرض نماذج المنتدى. على سبيل المثال، إذا أجريت تغييرات متزايدة في الالتزامات 1 و2 و3، وكانت النسخة الأخيرة هي 4، يجب أن يكون لديك إدخال واحد فقط للإتمام 4 يتضمن جميع التغييرات من الالتزامات 1 و2 و3.