Инструкция по размещению значка

Как разместить модуль опроса

Через модуль опроса покупатели могут поучаствовать в программе "Google Отзывы клиентов" и поделиться своим мнением о вашем магазине. Помимо этого, модуль отправляет Google всю необходимую информацию о транзакциях. Чтобы присоединиться к программе "Google Отзывы клиентов", разместите модуль опроса на всех страницах подтверждения заказа на вашем веб-сайте. Если пользователь согласится принять участие в опросе, то, когда он получит свой заказ, ему отправят анкету.

В этом разделе подробно рассматриваются следующие темы:

Подробнее о модуле опроса и об анкете, которую получают пользователи, написано здесь.

Чтобы модуль опроса отображался и на компьютерах, и на мобильных устройствах, не забудьте добавить его код как в основную, так и в мобильную версию сайта.

Как разместить модуль опроса

Чтобы встроить код модуля на страницу подтверждения заказа, выполните следующие действия:

  1. Уточните используемую версию DOCTYPE.
  2. Добавьте код модуля.

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

Чтобы модуль работал максимально эффективно, в него необходимо включить как можно более точную информацию о заказе.

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

Проследите за тем, чтобы окно модуля на вашем сайте не было перекрыто другим контентом. В противном случае модуль может быть не виден.

Уточните используемую версию DOCTYPE

Вы сможете разместить модуль опроса, только если страницы подтверждения заказа поддерживают DOCTYPE для HTML5. Открывающий тег этого элемента выглядит так:

<!DOCTYPE html>

Эта строка должна быть первой в HTML-коде сайта. Если вы используете DOCTYPE для HTML5, браузер отображает страницы в стандартном режиме, строго соблюдающем требования W3C и IETF, а не в режиме совместимости. Последний нужен для показа страниц, созданных для устаревших версий браузеров.

Примечание. Перед элементом DOCTYPE не должно быть пробела или комментариев.

Добавьте код модуля

Если вы разместите модуль опроса на странице подтверждения заказа, покупатели смогут оставлять отзывы о вашем магазине.

Вот как добавить код модуля:

  1. Вставьте в HTML-код страницы подтверждения заказа следующий фрагмент:
    
    <!-- НАЧАЛО кода модуля опроса -->
    <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":"MERCHANT_ID",
              "order_id": "ORDER_ID",
              "email": "CUSTOMER_EMAIL",
              "delivery_country": "COUNTRY_CODE",
              "estimated_delivery_date": "YYYY-MM-DD",
    
              // НЕОБЯЗАТЕЛЬНО
              "opt_in_style": "OPT_IN_STYLE"
            }); 
         });
      }
    </script>
    <!-- КОНЕЦ кода модуля опроса -->
    

    Приведенный фрагмент нужно вставить перед закрывающим тегом </BODY>. Относительно кода значка его можно размещать в любом порядке.

  2. Замените текст, выделенный красным цветом, на нужные динамические значения. Подробная информация о каждом из параметров представлена в таблице ниже:

     

    Параметр Обязательно? Описание

    MERCHANT_ID

    (Идентификатор продавца)

    Да Ваш идентификатор Merchant Center. Его можно посмотреть в Google Merchant Center.

    ORDER_ID

    (Идентификатор заказа)

    Да Уникальный идентификатор заказа.

    CUSTOMER_EMAIL

    (Адрес электронной почты клиента)

    Да Адрес электронной почты клиента в формате name@domain.com.

    COUNTRY_CODE

    (Код страны)

    Да Двухбуквенный код страны заказчика в формате ISO 3166-1 alpha-2. Пример: US. Значение ZZ указывать нельзя. 

    ESTIMATED_DELIVERY_DATE

    (Предполагаемая дата доставки)

    Да Предполагаемая дата доставки, где YYYY обозначает год, MM – месяц, а DD – день. Пример: 2016–09–13.

    OPT_IN_STYLE

    (Расположение модуля)

    Нет Этот параметр определяет расположение модуля на странице. Доступные варианты:
    • "CENTER_DIALOG": в центре экрана.
    • "BOTTOM_RIGHT_DIALOG": в правом нижнем углу.
    • "BOTTOM_LEFT_DIALOG": в левом нижнем углу.
    • "TOP_RIGHT_DIALOG": в правом верхнем углу.
    • "TOP_LEFT_DIALOG": в левом верхнем углу.
    • "BOTTOM_TRAY": в нижней части экрана.

    Значение по умолчанию: "CENTER_DIALOG".

     

  3. Чтобы установить язык модуля опроса, добавьте в код следующий фрагмент:
    
    <!-- НАЧАЛО кода языка опроса -->
    <script>
      window.___gcfg = {
        lang: 'LANGUAGE'
      };
    </script>
    <!-- КОНЕЦ кода языка опроса -->
    

    Этот фрагмент нужно вставить в код страницы перед закрывающим тегом </BODY>. Относительно фрагмента HTML-кода модуля опроса его можно размещать в любом порядке.

    В качестве значения параметра lang вместо слова LANGUAGE вставьте во фрагмент код нужного языка:

    • af
    • ar_AE
    • cs
    • da
    • de
    • en_AU
    • en_GB
    • en_US
    • es
    • es_419
    • fil
    • fr
    • ga
    • id
    • it
    • iw
    • ja
    • ko
    • ms
    • nl
    • no
    • pl
    • pt_BR
    • pt_PT
    • ru
    • sv
    • th
    • tr
    • uk
    • vi
    • zh_CN
    • zh_TW

    Если вы не укажете значение параметра lang, то модуль опроса будет отображаться на языке браузера пользователя.

Пример кода модуля опроса

Обычно значения параметров на странице подтверждения заказа заменяются на серверный код. В примере ниже показано, как добавить код модуля с помощью скрипта PHP:


<!-- НАЧАЛО кода модуля опроса -->
<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 ?>",
          "opt_in_style": "BOTTOM_LEFT_DIALOG"
        }); 
     });
  }
</script>
<!-- КОНЕЦ кода модуля опроса -->

<!-- НАЧАЛО кода языка опроса -->
<script>
  window.___gcfg = {
    lang: 'en_US'
  };
</script>
<!-- КОНЕЦ кода языка опроса -->

Если вы не видите модуль опроса на ваших страницах или при их загрузке получаете сообщения об ошибках, перейдите к разделу Устранение неполадок.

Устранение неполадок

Ниже указаны основные сообщения об ошибках, которые могут возникнуть при размещении модуля опроса программы "Google Отзывы клиентов".

Модуль опроса не отображается

Если вы не видите модуль опроса на странице, причина может быть в одной из следующих ошибок:

Ошибка Как исправить
В исходном HTML-коде нет фрагмента кода модуля Проверьте исходный HTML-код. В нем должен быть только один фрагмент кода модуля. Если есть лишние, удалите их.
Модуль выходит за пределы экрана или перекрыт другими элементами Возможно, окно модуля оказалось за пределами видимой области. Чтобы его увидеть, прокрутите страницу по горизонтали и вертикали.

Ошибки JavaScript

В таблице ниже перечислены основные возможные проблемы, связанные с JavaScript:

Ошибка Как исправить
Отсутствует нужный параметр В коде модуля опроса нужно указать следующие обязательные параметры:

 

  • merchant_id (идентификатор Merchant Center);
  • order_id (идентификатор заказа);
  • email (адрес электронной почты клиента);
  • delivery_country (код страны);
  • estimated_delivery_date (предполагаемая дата доставки).
HTML-код веб-сайта не использует DOCTYPE для HTML5 Убедитесь в том, что все страницы подтверждения заказа используют DOCTYPE для HTML5. В HTML-коде на этот элемент указывает следующий открывающий тег:
<!DOCTYPE html>
Недопустимое значение параметра estimated_delivery_date (предполагаемая дата доставки) Укажите дату в формате ГГГГ–ММ–ДД, где ГГГГ – год, ММ – месяц и ДД – день. Значение параметра нужно взять в кавычки. Пример: "2016–09–13".
Недопустимое значение параметра opt_in_style (расположение модуля) В качестве значения необязательного параметра opt_in_style (расположение модуля) можно указать только один из следующих допустимых вариантов:
  • "CENTER_DIALOG";
  • "BOTTOM_RIGHT_DIALOG";
  • "BOTTOM_LEFT_DIALOG";
  • "TOP_RIGHT_DIALOG";
  • "TOP_LEFT_DIALOG";
  • "BOTTOM_TRAY".
Версия браузера устарела Ваш браузер должен поддерживать HTML5. Обновите его до последней версии.

 

Чтобы покупателям было удобнее пользоваться формами на странице оплаты, советуем включить функцию автозаполнения. О том, как это сделать, читайте здесь.
Была ли эта статья полезна?
Как можно улучшить эту статью?