Integration guide

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

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

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

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

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

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

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

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

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

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

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

ويجب عدم حجب وحدة الاشتراك في استطلاع "آراء العملاء عبر 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: 'اللغة'

};

</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 -->‎

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

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

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

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

بحث
محو البحث
إغلاق البحث
تطبيقات Google
القائمة الرئيسية
مركز مساعدة البحث
true
true
true
true
71525
false
false