Integration guide

Необов’язково: інтеграція коду значка

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

У цьому розділі розглядаються такі теми:

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

Щоб інтегрувати значок GCR у сторінку:

  1. Оновіть тег DOCTYPE.
  2. Додайте значок GCR.

Ці завдання описано в розділах нижче.

Коли ви застосовуєте код значка на своїх сторінках, відображається наведене нижче зображення (значення рейтингу може бути іншим):

Щоб на значку відображався рейтинг продавця, зазвичай потрібно принаймні 100 відгуків у певній країні за останній рік.

Не закривайте значок іншим вмістом сторінок.

Як оновити тег DOCTYPE

Переконайтеся, що на веб-сторінках зі значком використовується тег DOCTYPE за специфікацією HTML 5:

<!DOCTYPE html>

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

ПРИМІТКА. Не додавайте коментарі або пробіли перед тегом DOCTYPE.

Як додати значок GCR

Додайте значок GCR на будь-які сторінки веб-сайту, де він потрібен, щоб відвідувачі бачили, що ви користуєтеся службою Google Відгуки клієнтів.

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

Щоб додати на сайт значок GCR:

  1. Вставте у веб-сторінку наведений нижче фрагмент коду:

    <!-- BEGIN GCR Badge Code -->
    <script src="https://apis.google.com/js/platform.js?onload=renderBadge"
      async defer>
    </script>

    <script>
      window.renderBadge = function() {
        var ratingBadgeContainer = document.createElement("div");
          document.body.appendChild(ratingBadgeContainer);
          window.gapi.load('ratingbadge', function() {
            window.gapi.ratingbadge.render(
              ratingBadgeContainer, {
                // REQUIRED
                "merchant_id":
    MERCHANT_ID,
                // OPTIONAL
                "position": "
    POSITION"
              });           
         });
      }
    </script>
    <!-- END GCR Badge Code -->

    Вставте код перед кінцевим тегом </BODY>. Якщо разом із кодом значка ви розміщуєте код модуля опитування, порядок не має значення.

  2. Замініть значення змінних динамічними значеннями зі свого сайту. У таблиці нижче наведено доступні налаштування.
     
    Змінна Обов’язково? Опис
    ІДЕНТИФІКАТОР_ПРОДАВЦЯ Так Ваш ідентифікатор у Merchant Center. Його можна отримати в Google Merchant Center.
    POSITION Необов’язково Визначає відображення значка в одному з таких місць:
    • "BOTTOM_RIGHT": значок буде розміщено довільно в правій нижній частині сторінки.
    • "BOTTOM_LEFT": значок буде розміщено довільно в лівій нижній частині сторінки.
    • "INLINE": значок з’явиться в місці розташування коду. Якщо використовується цей варіант, переконайтеся, що інші елементи сторінки не блокують і не закривають значок. Простіший спосіб описано в розділі про додавання вбудованого значка GCR.

    За умовчанням значок розміщується в правій нижній частині екрана ("BOTTOM_RIGHT").

     

  3. Укажіть мову для значка, вставивши у веб-сторінку наведений нижче фрагмент коду:
     
    
    <!-- BEGIN GCR Language Code -->
    <script>
      window.___gcfg = {
        lang: 'LANGUAGE'
      };
    </script>
    <!-- END GCR Language Code -->
    

    Вставте код перед кінцевим тегом </BODY>. У разі розміщення з кодом значка порядок не має значення.

    Укажіть значення параметра lang, замінивши слово LANGUAGE однією з таких підтримуваних мов:

    • af
    • ar
    • cs
    • da
    • de
    • uk
    • en-AU
    • en-GB
    • uk-UA
    • es
    • es-419
    • fil
    • fr
    • ga
    • id
    • it
    • ja
    • ms
    • nl
    • no
    • pl
    • pt-BR
    • pt-PT
    • ru
    • sv
    • tr
    • zh-CN
    • zh-TW

    Якщо не вказати значення для параметра lang, мову для значка буде вибрано автоматично згідно з налаштуваннями веб-переглядача користувача.

  4. Повторіть кроки 1–3 для всіх сторінок свого веб-сайту, на які потрібно додати значок.
  5. Щоб завершити інтеграцію з GCR, додайте на сторінку підтвердження замовлення модуль запиту згоди на опитування. Він є обов’язковим.

Щоб додати вбудований значок GCR:

  1. Вставте наведений нижче рядок перед кінцевим тегом body на сторінці HTML, щоб завантажити код JavaScript для значка:

    
    <script src="https://apis.google.com/js/platform.js" async defer></script>
    
  2. Вставте цей рядок у код HTML у тому місці сторінки, де потрібно розмістити значок:
    
    <g:ratingbadge merchant_id=MERCHANT_ID></g:ratingbadge>
    

    Замініть значення MERCHANT_ID власним ідентифікатором у Merchant Center.

  3. Укажіть мову для значка.

  4. Додайте на сторінку підтвердження замовлення модуль запиту згоди на опитування. Він є обов’язковим.

Приклад коду значка

Нижче наведено приклад коду для розміщення значка в лівій нижній частині сторінки, у якому використано ідентифікатор продавця 42:


<!-- BEGIN GCR Badge Code -->
<script src="https://apis.google.com/js/platform.js?onload=renderBadge"
  async defer>
</script>

<script>
  window.renderBadge = function() {
    var ratingBadgeContainer = document.createElement("div");
    document.body.appendChild(ratingBadgeContainer);
    window.gapi.load('ratingbadge', function() {
      window.gapi.ratingbadge.render(
        ratingBadgeContainer, {
          "merchant_id": 42,
          "position": "BOTTOM_LEFT"
        });
    });
  }
</script>
<!-- END GCR Badge Code -->

<!-- BEGIN GCR Language Code -->
<script>
  window.___gcfg = {
    lang: 'en_US'
  };
</script>
<!-- END GCR Language Code -->

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

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

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

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