Integration guide

دمج وحدة المشاركة في الاستطلاع

التالي: اختياري: تعديل خيار المشاركة في الاستطلاع لجمع مراجعات حول المنتجات

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

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

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

يعمل خيار المشاركة في الاستطلاع على أجهزة سطح المكتب والأجهزة الجوّالة. تأكد من إضافة مقتطف رمز المشاركة إلى الموقع المخصص لكل من سطح المكتب والأجهزة الجوّالة.

تعليمات الدمج

لتضمين وحدة الاشتراك في الاستطلاع داخل صفحة تأكيد الطلب، يتعيّن عليك:

  1. تحديث DOCTYPE
  2. إضافة رمز المشاركة

يجب وضع رمز وحدة الاشتراك في الاستطلاع على صفحة تأكيد الطلب ضمن إجراءات الدفع. ويجب أن تستخدم جميع صفحات التأكيد بروتوكول HTTPS (وليس HTTP).

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

إذا كانت عملية الدفع تتم عبر جهة خارجية تعالج الدفعات، يجب إعادة التوجيه إلى صفحة التأكيد على نطاقك مرة أخرى.

ويجب عدم حجب وحدة الاشتراك في استطلاع "آراء العملاء عبر Google" بأي محتوى آخر على صفحة تأكيد الطلب.

تحديث DOCTYPE

تأكد من أن صفحة التأكيد تستخدم HTML5 DOCTYPE:

<!DOCTYPE html>

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

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

إضافة رمز الاشتراك

حتى يتسنى للعملاء اختيار إرسال آرائهم حول تجربة الشراء منك، يمكنك إضافة وحدة الاشتراك إلى صفحة تأكيد الطلب.

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

1. الصق مقتطف HTML التالي في صفحة تأكيد الطلب:
 

<!-- BEGIN GCR Opt-in Module Code -->

<script src="https://apis.google.com/js/platform.js?onload=renderOptIn"

 async defer>

</script>

 

<script>

 window.renderOptIn = function() {‎

   window.gapi.load('surveyoptin', function() {‎

     window.gapi.surveyoptin.render(‎

       ‎{‎

// REQUIRED

         "merchant_id": "MERCHANT_ID",‎

         "order_id": "ORDER_ID",‎

         ‎"email": "CUSTOMER_EMAIL",‎

         ‎"delivery_country": "COUNTRY_CODE",‎

         ‎"estimated_delivery_date": "YYYY-MM-DD",‎

 

         // OPTIONAL

         ‎"products":[{"gtin":"GTIN1"}, {"gtin":"GTIN2">}],‎

         "opt_in_style": "OPT_IN_STYLE"

       });

    ‎});‎

 ‎}‎

</script>

‎<!-- END GCR Opt-in Module Code -->‎

 

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

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

 

المتغيّر

هل هو مطلوب؟

الوصف

MERCHANT_ID

(معرّف التاجر)

مطلوب

معرّف Merchant Center. ويمكنك معرفة هذه القيمة من Google Merchant Center.

ORDER_ID

(معرّف الطلب)

مطلوب

معرّف فريد للطلب.

CUSTOMER_EMAIL

(البريد الإلكتروني الخاص بالعميل)

مطلوب

عنوان البريد الإلكتروني الخاص بالعميل بتنسيق name@domain.com.

COUNTRY_CODE

(رمز البلد)

مطلوب

يحدّد رمز البلد المكوّن من حرفين المكان الذي سيتم تسليم طلب العميل فيه. ويجب أن تكون هذه القيمة بتنسيق ISO 3166-1 alpha-2. لا تستخدم القيمة "ZZ" لهذا الحقل. على سبيل المثال، "US".

ESTIMATED_DELIVERY_DATE

(تاريخ التسليم المتوقّع)

مطلوب

تاريخ التسليم المحدّد للطلب، حيث يشير YYYY إلى العام وMM إلى الشهر وDD إلى اليوم. على سبيل المثال "2016-09-13".

GTIN1 وGTIN2

(رقم GTIN)

اختياري

قيم رقم GTIN الرقمية.

OPT_IN_STYLE

(نمط المشاركة في الاستطلاع)

اختياري

لتحديد طريقة عرض مربع الحوار في وحدة الاشتراك. القيم المتاحة:

"CENTER_DIALOG": يتم العرض في شكل مربع حوار وفي الوسط.

 

"BOTTOM_RIGHT_DIALOG": يتم العرض في شكل مربع حوار في أسفل اليسار.

 

"BOTTOM_LEFT_DIALOG": يتم العرض في شكل مربع حوار في أسفل اليمين.

 

"TOP_RIGHT_DIALOG": يتم العرض في شكل مربع حوار في أعلى اليسار.

 

"TOP_LEFT_DIALOG": يتم العرض في شكل مربع حوار في أعلى اليمين.

 

"BOTTOM_TRAY": يتم العرض في الأسفل.

 

القيمة التلقائية "CENTER_DIALOG".

 

اختَر اللغة التي يجب استخدامها في وحدة المشاركة في الاستطلاع عبر لصق مقتطف الرمز التالي في صفحة الويب:

‎<!-- BEGIN GCR Language Code -->‎

<script>

 window.___gcfg = {‎

   lang: 'LANGUAGE'‎

 };

</script>

‎<!-- END GCR Language Code -->‎

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

حدِّد قيمة المعلَمة lang عبر استبدال LANGUAGE بإحدى اللغات المتوافقة التالية:

  • af
  • ar
  • bg
  • ca
  • cs
  • da
  • de
  • el
  • ar
  • en-AU
  • en-GB
  • en-US
  • es
  • ES_419
  • fa
  • fi
  • fil
  • fr
  • ga
  • hi
  • hr
  • hu
  • id
  • it
  • iw
  • ja
  • ko
  • lt
  • lv
  • ms
  • nl
  • no
  • pl
  • pt-br
  • pt-PT
  • ro
  • ru
  • sk
  • sl
  • sr
  • sv
  • te
  • th
  • tr
  • uk
  • vi
  • zh-CN
  • zh-TW

في حال عدم تحديد قيمة للمعلمة lang، ستستخدم وحدة الاستطلاع إعداد اللغة المستخدَم في إعدادات المتصفح لدى المستخدم.

نموذج لرمز المشاركة في الاستطلاع

يتم عادة استبدال القيم المتغيرة على صفحة تأكيد الطلب بالرمز من طرف الخادم. يعرض المثال التالي كيفية تطبيق رمز وحدة المشاركة باستخدام PHP:

‎<!-- BEGIN GCR Opt-in Module Code -->‎

<script src="https://apis.google.com/js/platform.js?onload=renderOptIn"

 async defer>

</script>

 

<script>

 window.renderOptIn = function() {‎

   window.gapi.load('surveyoptin', function() {‎

     window.gapi.surveyoptin.render(‎

       ‎{‎

         ‎"merchant_id": 42,‎

         ‎"order_id": "<?php echo $order_id ?>",‎

         ‎"email": "<?php echo $email_address ?>",‎

         ‎"delivery_country": "<?php echo $user_country ?>",‎

         ‎"estimated_delivery_date": "<?php echo $delivery_date ?>",‎

   ‎"products": [{"gtin":"<?php echo $gtin_1 ?>"}, {"gtin":"<?php echo $gtin_2 ?>"}],‎

         "opt_in_style": "BOTTOM_LEFT_DIALOG"

       ‎});‎

    ‎});‎

 ‎}‎

</script>

‎<!-- END GCR Opt-in Module Code -->‎

 

‎<!-- BEGIN GCR Language Code -->‎

<script>

 window.___gcfg = {‎

   lang: 'en_US'‎

 ‎};‎

</script>

‎<!-- END GCR Language Code -->‎

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

هل كان ذلك مفيدًا؟
كيف يمكننا تحسينها؟

هل تحتاج إلى مزيد من المساعدة؟

تسجيل الدخول للحصول على خيارات دعم إضافية لحل مشكلتك بسرعة