اختياري: دمج رمز الشارة

إنّ رمز شارة "آراء العملاء عبر Google" هو الأوّل من بين مقتطفَي رمز يتم تطبيقهما لدمج "آراء العملاء عبر Google". وهذه الشارة اختيارية. إذا كنت تواجه مشاكل في دمج رمز الشارة، حاوِل تحديد وتصليح الأعطال.

يتناول هذا القسم المواضيع التالية:

• تعليمات الدمج
• مثال على رمز الشارة

تعليمات حول دمج الشارة

لدمج شارة "آراء العملاء عبر Google" في إحدى الصفحات، يجب تنفيذ ما يلي:

1. تعديل DOCTYPE
2. إضافة شارة "آراء العملاء عبر Google"

يرد وصف هذه المهام في الأقسام التي تتبعها.

عند تطبيق رمز الشارة على صفحاتك، تظهر الصورة التالية (ستختلف قيم التقييم):

في معظم الحالات، يجب أن تكون قد حصلت على 100 مراجعة على الأقلّ في بلد محدّد خلال العام السابق ليظهر تقييم المتجرالخاص بك على شارتك.

يجب التأكّد من عدم ظهور محتوى يحجب الشارة على صفحاتك.

تعديل DOCTYPE

تأكّد من أنّ صفحات الويب التي يتمّ تنفيذ الشارة فيها تستخدم HTML5 DOCTYPE:

<DOCTYPE html!>

يجب أن يكون doctype هذا أول عنصر سطر في رمز HTML على صفحتك. ويضمن استخدام HTML5 DOCTYPE أن تعرض متصفحّات الويب صفحاتك بالوضع القياسي بدلاً من وضع المراوغة. يشير وضع Quirks إلى الأسلوب المستخدَم في بعض متصفحات الويب لضمان التوافق مع الأنظمة القديمة بدلاً من الالتزام الصارم بمعايير W3C وIETF في الوضع العادي.

ملاحظة: لا تضِف أي تعليقات أو مسافات بيضاء قبل DOCTYPE.

إضافة شارة "آراء العملاء عبر Google"

أضِف شارة "آراء العملاء عبر Google" إلى صفحات موقعك الإلكتروني في المواضع حيث تريد إظهارها لكي تُعلم العملاء بأنّك تستخدم منتج "آراء العملاء عبر Google".

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

لإضافة شارة "آراء العملاء عبر Google" إلى موقعك الإلكتروني، يُرجى اتّباع الخطوات التالية:

1. ألصق مقتطف الرمز التالي في صفحتك على الويب:

   
   <!-- BEGIN GCR Badge Code -->
   <script src="https://apis.google.com/js/platform.js?onload=renderBadge"
     async defer>
   </script>
   
   <script>
     window.renderBadge = function() {
       var ratingBadgeContainer = document.createElement("div");
         document.body.appendChild(ratingBadgeContainer);
         window.gapi.load('ratingbadge', function() {
           window.gapi.ratingbadge.render(
             ratingBadgeContainer, {
               // REQUIRED
               "merchant_id": MERCHANT_ID,
               // OPTIONAL
               "position": "POSITION"
             });           
        });
     }
   </script>
   <!-- END GCR Badge Code -->
   

   ضَع الرمز قبل علامة الإغلاق </BODY> مباشرةً على الصفحة. وعند وضعها مع رمز المشاركة في الاستطلاع، لن يكون للترتيب أي اعتبار.

2. استبدِل المتغيرات بقيم ديناميكية خاصة بموقعك الإلكتروني. يوضّح الجدول التالي الإعدادات المتوفّرة:

   المتغيّر	هل هو مطلوب؟	الوصف
   MERCHANT_ID	مطلوب	معرّف مركز التجّار: يمكنك معرفة هذه القيمة من Google Merchant Center.
   POSITION	اختياري	يعرض الشارة في أحد المواقع التالية: ‫BOTTOM_RIGHT: يؤدي إلى ظهور الشارة في أسفل يسار الصفحة. ‫BOTTOM_LEFT: يؤدي إلى ظهور الشارة في أسفل يمين الصفحة. ‫INLINE: يعرض الشارة في مكان ظهور الرمز. عند استخدام هذا الخيار، تأكّد من أنّ العناصر الأخرى في الصفحة لا تحظر الشارة أو تحجبها. لتنفيذ طريقة أسهل، اطّلع على إضافة شارة "آراء العملاء من Google" المضمّنة. الوضع التلقائي للشارة هو BOTTOM_RIGHT.

3. يمكنك تحديد اللغة الظاهرة على الشارة من خلال لصق مقتطف الرمز التالي في صفحة الويب: إذا لم تحدّد قيمة للمَعلمة lang، تستخدم الشارة إعدادات المتصفح الخاصة بالمستخدم لاختيار اللغة تلقائيًا.

   
   <!-- BEGIN GCR Language Code -->
   <script>
     window.___gcfg = {
       lang: 'LANGUAGE'
     };
   </script>
   <!-- END GCR Language Code -->
   

   ضَع الرمز قبل علامة الإغلاق </BODY> مباشرةً على الصفحة. وعند وضعها مع رمز الشارة، لن يكون للترتيب أي اعتبار.

   حدِّد قيمة المعلَمة lang عن طريق استبدال LANGUAGE بأحد الرموز المتوافقة التالية من عمود "رموز اللغة":

الرمز	اللغة
af	الأفريقانية
ar	العربية
cs	التشيكية
da	الدانمركية
de	الألمانية
en	الإنجليزية
en-AU	الإنجليزية (أستراليا)
en-GB	الإنجليزية (المملكة المتحدة)
en-US	الإنجليزية (الولايات المتحدة)
es	الإسبانية
ES_419	الإسبانية (أمريكا اللاتينية)
fil	الفلبينية
fr	الفرنسية
ga	الأيرلندية
id	الإندونيسية
it	الإيطالية
ja	اليابانية
ms	الملايوية
nl	الهولندية
no	النرويجية
pl	البولندية
pt-BR	البرتغالية (البرازيل)
pt-PT	البرتغالية
ru	الروسية
sv	السويدية
tr	التركية
zh-CN	الصينية (المبسطة)
zh-TW	الصينية (التقليدية)

4. كرّر الخطوات من 1 إلى 3 لجميع الصفحات في موقعك الإلكتروني التي تريد ظهور الشارة فيها.
5. لإكمال عملية دمج "آراء العملاء عبر Google"، عليك إضافة وحدة المشاركة في الاستطلاع إلى صفحة تأكيد الطلب. وتُعدّ وحدة المشاركة في الاستطلاع مطلوبة.

لإضافة شارة "آراء العملاء عبر Google" بشكل مضمّن:

1. الصق السطر التالي قبل علامة نص الإغلاق في صفحة HTML الخاصة بموقعك الإلكتروني لتحميل لغة JavaScript الخاصة بالشارة:

   
   <script src="https://apis.google.com/js/platform.js" async defer></script>
   

2. الصق هذا السطر في صفحة HTML في الموضع الذي تريد إظهار الشارة فيه على الصفحة:

   
   <g:ratingbadge merchant_id=MERCHANT_ID></g:ratingbadge>​
   
   

   استبدِل MERCHANT_ID بمعرِّف Merchant Center.

3. حدّد اللغة التي تستخدمها الشارة كما هو موضّح هنا.

4. أضف وحدة المشاركة في الاستطلاع إلى صفحة تأكيد الطلب. وتُعدّ وحدة المشاركة في الاستطلاع مطلوبة.

مثال على رمز الشارة

يعرض المثال التالي الرمز الذي يجب إدخاله لوضع الشارة في أسفل يسار الصفحة لمعرّف التاجر 42:

<!-- BEGIN GCR Badge Code -->
<script src="https://apis.google.com/js/platform.js?onload=renderBadge"
  async defer>
</script>

<script>
  window.renderBadge = function() {
    var ratingBadgeContainer = document.createElement("div");
    document.body.appendChild(ratingBadgeContainer);
    window.gapi.load('ratingbadge', function() {
      window.gapi.ratingbadge.render(
        ratingBadgeContainer, {
          "merchant_id": 42,
          "position": "BOTTOM_LEFT"
        });
    });
  }
</script>
<!-- END GCR Badge Code -->

<!-- BEGIN GCR Language Code -->
<script>
  window.___gcfg = {
    lang: 'en_US'
  };
</script>
<!-- END GCR Language Code -->

إذا لم تظهر الشارة على صفحتك، أو إذا حدثت أخطاء عند تحميل الصفحة، حاوِل تحديد المشاكل وحلّها.