מודול בקשת ההסכמה להשתתפות בסקר מאפשר ללקוחות לבחור אם להשתתף בתוכנית 'Google ביקורות צרכנים', וגם מעביר ל-Google את המידע הנדרש על העסקאות. כדי להשתתף בתוכנית, חובה להטמיע את המודול הזה בכל הדפים של אישורי ההזמנות. אם נתקלתם בבעיות בהטמעה של מודול בקשת ההסכמה להשתתפות בסקר, אפשר לנסות את הפתרונות שמפורטים כאן.
המאמר הזה עוסק בנושאים האלה:
אם משתמש מסכים, Google שולחת לו סקר אחרי מועד המסירה המשוער של ההזמנה שלו. מידע נוסף זמין במאמר בנושא הסקר של 'Google ביקורות צרכנים'.
מודול בקשת ההסכמה להשתתפות בסקר פועל במחשב ובנייד. חשוב להוסיף את קטע הקוד לבקשת הסכמה גם לאתר לנייד וגם לאתר שמותאם למחשבים.
הוראות הטמעה
כדי להטמיע את מודול בקשת ההסכמה להשתתפות בסקר בדף אישור ההזמנה, צריך:
צריך להטמיע את קוד המודול בדף אישור ההזמנה שבתהליך התשלום. כל דפי האישור צריכים להיות בקידוד HTTPS ולא HTTP.
המודול הזה מפעיל את טופס בקשת ההסכמה להשתתפות בסקר של 'Google ביקורות צרכנים', ולכן פרטי ההזמנה שמתועדים בו צריכים להיות כמה שיותר מדויקים.
אם חברה חיצונית מטפלת בשבילכם בתהליך התשלום, אותה חברה צריכה להפנות את המשתמש בחזרה לדף האישור בדומיין שלכם.
חשוב לוודא שמודול בקשת ההסכמה לא מוסתר בתוכן אחר בדף אישור ההזמנה.
עדכון ה-DOCTYPE
יש לוודא שה-DOCTYPE של דף האישור הוא HTML5:
<!DOCTYPE html>
ה-doctype צריך להיות הפריט הראשון בקוד ה-HTML של הדף. השימוש ב-HTML5 DOCTYPE מבטיח שהדפדפנים יעבדו את הדפים במצב רגיל ולא ב'מצב תאימות' (quirks). מצב תאימות (quirks mode) הוא שיטה שפועלת בדפדפנים מסוימים כדי לשמור על תאימות לאחור עם דפי אינטרנט שמיועדים לדפדפנים ישנים יותר, במקום להשתמש רק בתקני W3C ו-IETF במצב רגיל.
הוספה של קוד בקשת ההסכמה
כדי לאפשר ללקוחות לבחור אם למלא סקר על חוויית הקנייה באתר שלכם, צריך להוסיף את מודול בקשת ההסכמה לדף אישור ההזמנה.
כדי להוסיף את מודול בקשת ההסכמה לדף אישור ההזמנה:
- מדביקים את קטע קוד ה-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>. כשממקמים את קוד המודול של הסקר יחד עם קוד התג, הסדר לא משנה. קוד המודול יכול להופיע לפני קוד התג או אחריו.
- מחליפים את המשתנים בערכים דינמיים שמתאימים לאתר הספציפי שלכם. הטבלה הבאה מתארת את ההגדרות האפשריות:
| משתנה | חובה? | תיאור |
|---|---|---|
|
MERCHANT_ID (מספר חשבון Merchant) |
חובה | מספר חשבון Merchant Center שלכם. אפשר למצוא אותו בחשבון Merchant Center. |
|
ORDER_ID (מזהה הזמנה) |
חובה | מזהה ייחודי להזמנה. |
|
CUSTOMER_EMAIL (כתובת האימייל של הלקוח) |
חובה | כתובת האימייל של הלקוח בפורמט name@domain.com. |
|
COUNTRY_CODE (קוד מדינה) |
חובה | קוד מדינה בן 2 אותיות שמזהה את המדינה שאליה תישלח ההזמנה של הלקוח. הקוד צריך להיות בפורמט ISO 3166-1 alpha-2. אין למלא את הערך "ZZ" בשדה הזה. לדוגמה, הקוד של ישראל הוא "IL". |
|
ESTIMATED_DELIVERY_DATE (מועד מסירה משוער) |
חובה | התאריך המשוער של מסירת ההזמנה: החלק YYYY מייצג את השנה, החלק MM מייצג את החודש והחלק DD מייצג את היום. לדוגמה, "2016-09-13". |
|
GTIN1, GTIN2 (מספר פריט מסחרי גלובלי) |
אופציונלי | ערכי 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: '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 | מלאית |
| ml | הולנדית |
| 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 →
אם מודול בקשת ההסכמה לא מוצג בדף או שמתקבלות שגיאות כשטוענים את הדף, אפשר לנסות את הפתרונות שמפורטים כאן.