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

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

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

الفئة	الوصف
عرض الإعلانات	الإعلانات
AFFILIATE_MARKETING	شبكات الإعلانات
إحصاءات YouTube	الإحصاءات
الإحالة	تحديد المصدر
محادثة	دردشة
المحسنة	قياس الإحالات الناجحة
DATA_WAREHOUSING	تخزين البيانات
EMAIL_MARKETING	التسويق عبر البريد الإلكتروني
التجربة	تجارب A/B وتحسين المحتوى
HEAT_MAP	خرائط التمثيل اللوني
LEAD_GENERATION	إنشاء قوائم العملاء المحتملِين
التسويق	Marketing
التخصيص	التخصيص
تجديد النشاط التسويقي	تجديد النشاط التسويقي
أسعار مخفَّضة	المبيعات وإدارة علاقات العملاء
SESSION_RECORDING	تسجيلات الجلسة
SOCIAL	التواصل الاجتماعي
الاستطلاع	الاستطلاعات
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.

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

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

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

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

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