Integration guide

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

Далі: як включити в модуль згоди на опитування можливість збирати відгуки про товари (необов'язково)

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

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

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

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

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

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

  1. Оновіть версію DOCTYPE.
  2. Додайте код модуля.

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

Цей модуль ініціює запрошення до опитування від сервісу 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": "ІДЕНТИФІКАТОР_ПРОДАВЦЯ",

"order_id": "ІДЕНТИФІКАТОР_ЗАМОВЛЕННЯ",

"email": "ЕЛЕКТРОННА_АДРЕСА_КЛІЄНТА",

"delivery_country": "КОД_КРАЇНИ",

"estimated_delivery_date": "РРРР-ММ-ДД",

// OPTIONAL

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

"opt_in_style": "СТИЛЬ_МОДУЛЯ_ЗГОДИ"

});

});

}

</script>

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

Цей код потрібно вставити перед кінцевим тегом </BODY>. Необов'язковий код значка можна розмістити як перед кодом модуля згоди на опитування, так і після нього.

2. Замініть значення змінних динамічними значеннями зі свого сайту. У таблиці нижче наведено доступні налаштування.

Змінна

Обов'язкова?

Опис

ІДЕНТИФІКАТОР_ПРОДАВЦЯ

(Ідентифікатор продавця)

Так

Ваш ідентифікатор у Merchant Center. Це значення можна побачити в обліковому записі Google Merchant Center.

ІДЕНТИФІКАТОР_ЗАМОВЛЕННЯ

(Ідентифікатор замовлення)

Так

Унікальний ідентифікатор замовлення.

ЕЛЕКТРОННА_АДРЕСА_КЛІЄНТА

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

Так

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

КОД_КРАЇНИ

(Код країни)

Так

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

РРРР-ММ-ДД

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

Так

Приблизна дата доставки замовлення, де РРРР означає рік, ММ – місяць, а ДД – день. Приклад: "2016-09-13".

GTIN1, GTIN2

(Глобальний номер товару)

Ні

Числові значення GTIN.

СТИЛЬ_МОДУЛЯ_ЗГОДИ

(Стиль модуля згоди)

Ні

Визначає стиль для діалогового вікна модуля згоди. Можливі значення:

"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, замінивши слово МОВА на код однієї з підтримуваних мов:

  • 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 -->

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

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

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

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

Пошук
Очистити вікно пошуку
Закрити вікно пошуку
Додатки Google
Головне меню
Пошук у довідковому центрі
true
71525
false