Integration guide

Як інтегрувати модуль опитування

Наступний крок. Змініть модуль опитування, щоб збирати відгуки про товари (необов'язково)

Модуль опитування дає клієнтам змогу брати участь у програмі Google Відгуки клієнтів, а також надсилає в Google усю потрібну інформацію про трансакції. Щоб приєднатися до програми Google Відгуки клієнтів, розмістіть цей модуль на всіх своїх сторінках підтвердження замовлень. Якщо вам не вдається інтегрувати модуль, скористайтеся цими порадами.

У цьому розділі розглядаються перелічені нижче теми.

Якщо користувач погоджується взяти участь в опитуванні, ми надішлемо йому анкету після приблизної дати доставки замовлення. Щоб дізнатися більше, перегляньте статтю про опитування Google Відгуки клієнтів.

Модуль опитування працює на комп'ютерах і мобільних пристроях. Обов'язково додайте відповідний фрагмент коду в обидві версії веб-сайту.

Вказівки з інтеграції

Щоб інтегрувати модуль опитування на сторінку підтвердження замовлень, потрібно:

  1. Оновити визначення DOCTYPE
  2. Додайте код згоди на опитування

Код модуля надання згоди на опитування потрібно розмістити на сторінках підтвердження замовлень у процедурі оформлення покупки. Усі ці сторінки мають використовувати протокол HTTPS, а не HTTP.

Оскільки цей модуль ініціює згоду на опитування Google Відгуки клієнтів, уся включена в нього інформація про замовлення має бути якомога точнішою.

Якщо вашу процедуру оформлення замовлень використовує сторонній продавець, він має переспрямовувати покупця на сторінку підтвердження у вашому домені.

Модуль опитування Google Відгуки клієнтів, розміщений на сторінці підтвердження замовлень, не можна перекривати будь-яким іншим вмістом.

Як оновити визначення DOCTYPE

Ваша сторінка підтвердження замовлень має використовувати визначення DOCTYPE формату HTML5:

<!DOCTYPE html>

Це визначення типу документа має бути першим фрагментом у коді HTML на сторінці. Використання фрагмента DOCTYPE формату HTML5 дає веб-переглядачам змогу відображати ваші сторінки в стандартному режимі, а не в режимі сумісності. Режим сумісності – це технологія, яка застосовується в деяких веб-переглядачах для збереження зворотної сумісності з веб-сторінками, створеними для веб-переглядачів старіших версій, а не чіткого дотримання стандартів 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

(Електронна адреса клієнта)

Так

Електронна адреса покупця у форматі ім'я@домен.com.

COUNTRY_CODE

(Код країни)

Так

Дволітерний код країни, який визначає, куди буде доставлено замовлення клієнта. Він має бути у форматі ISO 3166-1 alpha-2. Не застосовуйте заповнювач "ZZ" у цьому полі. Наприклад, "US".

ESTIMATED_DELIVERY_DATE

(Приблизна дата доставки)

Так

Приблизна дата доставки замовлення, де РРРР означає рік, ММ – місяць, а ДД – день. Приклад: "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".

 

Визначте мову для модуля згоди на опитування, додавши на свою сторінку наведений нижче фрагмент коду.

<!-- 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
  • uk
  • en-AU
  • en-GB
  • uk-UA
  • 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 -->

Якщо ви не бачите модуля опитування на своїй сторінці або під час її завантаження виникли помилки, перегляньте розділ Вирішення проблем.

Чи корисна ця інформація?
Як можна її покращити?

Потрібна додаткова допомога?

Увійдіть в обліковий запис, щоб отримати додаткову допомогу та швидко вирішити проблему