يتيح معرض نماذج منتدى "إدارة العلامات من Google" لمؤسستك إنشاء وإدارة نماذج العلامات والمتغيّرات التي تتكامل مع أداة "إدارة العلامات من Google" بشكلٍ أصلي. يمكن لمؤسستك إنشاء نموذج، ونشر مستودع النماذج على GitHub، ثم إرسال النموذج إلى معرض نماذج المنتدى لإتاحته للمستخدمين في جميع أنحاء العالم. تتضمن المزايا التي تحصل عليها مؤسستك ما يلي:
- سيتمكّن عملاؤك من إضافة النماذج واستخدامها بسهولة.
- سيظهر لمستخدمي أداة "إدارة العلامات من Google" العلامة التجارية لمؤسستك.
- سيتمكّن عملاؤك من نشر علاماتك في غضون دقائق، وليس أشهر.
- يمكنك نشر تعديلات على نماذجك وإتاحة هذه التحديثات تلقائيًا لعملائك.
تتضمّن عملية إرسال نموذج جديد إلى "معرض نماذج المنتدى" الخطوات الأساسية التالية:
إنشاء نموذج
للبدء، يمكنك إنشاء نموذجك في أداة "إدارة العلامات من Google" باعتباره نموذجًا مخصّصًا. تأكد من اختبار النموذج بالكامل، وأن محتوى النموذج يتبع دليل النمط، وأن لديك خطة أو عملية جاهزة لكيفية صيانة النموذج وتحديثه في حال ظهور الحاجة لذلك في المستقبل.
بنود الخدمة
يجب أن توافق كل عملية إرسال نموذج جديد على بنود الخدمة في معرض نماذج منتدى "إدارة العلامات من Google". لتأكيد الموافقة على بنود الخدمة للنموذج:
- اطّلِع على بنود خدمة معرض نماذج منتدى "إدارة العلامات من Google".
- في "محرِّر النماذج"، افتح النموذج لتعديله وضَع علامة في المربّع ضمن علامة التبويب المعلومات بعنوان "الموافقة على بنود خدمة معرض نماذج المنتدى".
تصدير النموذج
بعد اكتمال النموذج، يمكنك تصدير ملف النموذج إلى جهازك المحلي وإعادة تسمية الملف template.tpl
.
تجهيز ملفات مشروعك
الخطوة التالية هي تحضير مستودعك للنشر على GitHub. يجب أن يحتوي كل مستودع على الملفات التالية:
- ملف نموذج تم تصديره باسم
template.tpl
. يجب تعديل هذا الملف لإضافة إدخالcategories
. - ملف
metadata.yaml
. - ملف
LICENSE
يجب كتابة اسم الملف بأحرف كبيرة بالكامل ويجب أن يكون محتوى ملف الترخيص فقط Apache 2.0. - أضِف ملف
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 | التسويق عبر البريد الإلكتروني |
التجربة | تجارب A/B وتحسين المحتوى |
HEAT_MAP | خرائط التمثيل اللوني |
LEAD_GENERATION | إنشاء قوائم العملاء المحتملِين |
التسويق | Marketing |
التخصيص | التخصيص |
تجديد النشاط التسويقي | تجديد النشاط التسويقي |
أسعار مخفَّضة | المبيعات وإدارة علاقات العملاء |
SESSION_RECORDING | تسجيلات الجلسة |
SOCIAL | التواصل الاجتماعي |
الاستطلاع | الاستطلاعات |
TAG_MANAGEMENT | أنظمة إدارة العلامات |
الأداة المساعدة | أدوات "إدارة العلامات من Google" |
metadata.yaml
يحتوي ملف metadata.yaml
على معلومات عن النموذج، بما في ذلك روابط تؤدي إلى الصفحة الرئيسية لمؤسستك ومستندات النموذج ومعلومات الإصدار. يُشار إلى كل إصدار برقم تغيير، يُعرف أيضًا برقم SHA، وهو رقم التغيير المرتبط بـ Git معدل. إنّ الحقل changeNotes
هو حقل اختياري، ولكن ننصح به لإعلام المستخدمين بالتغييرات التي يتضمّنها الإصدار.
لإعداد ملف metadata.yaml
:
- إضافة إدخال
homepage
وينبغي أن يكون هذا عنوان URL يوجّه إلى الصفحة الرئيسية لمؤسستك. - إضافة إدخال للحقل "
documentation
". ينبغي أن يكون هذا عنوان URL يشير إلى وثائق القالب. - في GitHub، ابحث عن الالتزام الذي يتضمن التغييرات التي تريد فرضها على إصدارك الأولي من النموذج وانسخ رقم SHA. وهناك طريقة سهلة للحصول على رقم SHA في GitHub وهي الانتقال إلى عرض الالتزام والنقر على رمز الحافظة (). سيؤدي ذلك إلى نسخ رقم SHA بالكامل إلى الحافظة. الصق هذا الرقم كقيمة لإدخال
sha
كعنصر فرعي لعقدةversions
، كما هو موضّح أدناه. - أضِف إدخال
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 باستخدام حساب لديه إمكانية الوصول إلى مستودع النماذج التي تريد إضافتها إلى المعرض.
- انتقِل إلى "معرض نماذج المنتدى" على tagmanager.google.com/gallery.
- انقر على more_vert واختر إرسال النموذج.
- أدخِل عنوان URL للمستودع في الحقل المتوفّر وانقر على إرسال.
تعديل النموذج
بعد نشر النموذج، قد ترغب في تقديم تحديثات للنموذج من حين لآخر. سيتم إرسال إشعار إلى مستخدمي النموذج في حال حدوث تحديث للنموذج، وسيتاح لهم خيار تحديث النموذج إلى أحدث إصدار.
يُستخدَم الملف metadata.yaml
لتحديد نسخة النموذج التي سيتم استخدامها في المعرض. لنشر نُسخ جديدة، عليك إضافة رقم التغيير (رقم SHA) إلى قسم versions
في ملف metadata.yaml
.
- حدّد موقع الالتزام الذي يتضمن التغييرات التي تريد تطبيقها، وانسخ رقم SHA. وهناك طريقة سهلة للقيام بذلك في GitHub وهي الانتقال إلى عرض الالتزام والنقر على رمز الحافظة (). وسيؤدي هذا إلى نسخ رقم SHA بالكامل إلى الحافظة.
- إضافة إدخال
sha
جديد إلى أعلى قائمةversions
فيmetadata.yaml
(اطّلِع على المثال الوارد أدناه.) - أضِف
changeNotes
لتقديم وصف مختصر للتغييرات التي يتضمّنها هذا الإصدار الجديد. يمكنك إنشاء تعليقات متعددة الأسطر إذا أردت ذلك. (اطّلِع على المثال الوارد أدناه.) - التزم بالتغيير إلى
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.