تتيح وحدة المشاركة في الاستطلاع للعملاء اختيار المشاركة في برنامج "آراء العملاء عبر Google" (GCR) كما ترسل المعلومات اللازمة عن المعاملات إلى Google. ويجب استخدام هذه الوحدة في جميع صفحات تأكيد الطلبات للمشاركة في البرنامج. إذا كنت تواجه مشاكل في دمج وحدة المشاركة في الاستطلاع، حاوِل تحديد وتصليح الأعطال.
يتناول هذا القسم المواضيع التالية:
إذا اختار أحد المستخدمين المشاركة في الاستطلاع، سترسله Google إليه بعد تاريخ التسليم المقدّر للمنتج الذي طلبه. لمزيد من المعلومات، يمكنك الاطلاع على استطلاع "آراء العملاء عبر Google".
يعمل خيار المشاركة في الاستطلاع على أجهزة سطح المكتب والأجهزة الجوّالة. تأكد من إضافة مقتطف رمز المشاركة إلى الموقع المخصص لكل من سطح المكتب والأجهزة الجوّالة.
تعليمات الدمج
لتضمين وحدة المشاركة في الاستطلاع داخل صفحة تأكيد الطلب، عليك تنفيذ ما يلي:
يجب وضع رمز وحدة المشاركة في الاستطلاع على صفحة تأكيد الطلب ضمن مسارات الدفع. ويجب أن تستخدم جميع صفحات التأكيد بروتوكول HTTPS (وليس HTTP).
يجب أن تكون تفاصيل الطلب الواردة في هذه الوحدة دقيقة قدر الإمكان، وذلك لأنّ هذه الوحدة تؤدي إلى ظهور رسالة تتيح للمستخدمين المشاركة في استطلاع GCR إن أرادوا.
إذا كانت عملية الدفع تتمّ عبر جهة خارجية تعالج الدفعات، يجب أن تعيد التوجيه إلى صفحة التأكيد على نطاقك مرة أخرى.
يجب عدم حجب وحدة المشاركة في استطلاع "آراء العملاء عبر Google" بأي محتوى آخر على صفحة تأكيد الطلب.
تعديل DOCTYPE
تأكَّد من أن صفحة التأكيد تستخدم HTML5 DOCTYPE:
<!DOCTYPE html>
يجب أن يكون doctype هذا أول عنصر سطر في رمز HTML على صفحتك. وباستخدام HTML5 DOCTYPE، تضمن أن تعرض متصفحّات الويب صفحاتك بالوضع القياسي بدلاً من وضع Quirks. يشير وضع Quirks إلى الأسلوب المستخدَم في بعض متصفحات الويب لضمان التوافق مع صفحات الويب المصمّمة للمتصفحات القديمة بدلاً من الالتزام الصارم بمعايير W3C وIETF في الوضع العادي.
إضافة رمز المشاركة
لمنح العملاء خيار إرسال آرائهم حول تجربة الشراء منك، يمكنك إضافة وحدة المشاركة إلى صفحة تأكيد الطلب.
لإضافة وحدة المشاركة في الاستطلاع إلى صفحة تأكيد الطلب:
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". |
يمكنك اختيار اللغة التي يجب استخدامها في وحدة المشاركة في الاستطلاع عبر لصق مقتطف الرمز التالي في صفحة الويب. إذا لم تحدّد قيمة للمَعلمة lang، تستخدم الشارة إعدادات المتصفح الخاصة بالمستخدم لاختيار اللغة تلقائيًا.
<!-- BEGIN GCR Language Code -->
<script>
window.___gcfg = {
lang: 'اللغة'
};
</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 |
الصينية (التقليدية) |
نموذج لرمز المشاركة في الاستطلاع
يتم عادة استبدال القيم المتغيرة على صفحة تأكيد الطلب بالرمز من طرف الخادم. يعرض المثال التالي كيفية تطبيق رمز وحدة المشاركة باستخدام 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 -->
إذا لم تظهر وحدة المشاركة في الاستطلاع على صفحتك، أو إذا ظهرت أخطاء عند تحميل الصفحة، حاوِل تحديد المشاكل وحلّها.