Panduan integrasi

Opsional: Mengintegrasikan kode badge

Ikon khusus untuk Header Artikel Merchant Center Klasik.

Kode badge Google Customer Review (GCR) merupakan kode pertama dari 2 cuplikan kode yang Anda terapkan untuk integrasi Google Customer Review. Badge bersifat opsional. Jika mengalami masalah saat mengintegrasikan kode badge, coba pemecahan masalah.

Bagian ini menjelaskan topik-topik berikut:

Petunjuk integrasi
Contoh kode badge

Petunjuk integrasi

Untuk mengintegrasikan badge GCR pada halaman, Anda harus:

Mengupdate DOCTYPE
Menambahkan badge GCR

Tugas ini akan dijelaskan dalam bagian berikut.

Ketika menerapkan kode badge pada halaman Anda, gambar berikut akan ditampilkan (nilai rating akan bervariasi):

Pada umumnya, Anda harus memiliki setidaknya 100 ulasan di negara tertentu selama setahun terakhir, agar rating toko Anda dapat muncul di badge.

Jangan menggabungkan badge dengan konten lain di halaman Anda.

Mengupdate DOCTYPE

Pastikan bahwa halaman web tempat Anda menerapkan badge menggunakan HTML5 DOCTYPE:

<!DOCTYPE html>

Doctype ini harus merupakan item baris pertama pada kode HTML di halaman Anda. Menggunakan HTML5 DOCTYPE akan memastikan bahwa browser bisa me-render halaman Anda menggunakan mode standar, bukan menggunakan quirks mode. Quirks mode adalah teknik yang digunakan oleh beberapa browser web untuk mempertahankan kompatibilitas halaman web yang dirancang untuk browser lama, bukan untuk mematuhi standar W3C dan IETF secara ketat dalam mode standar.

Catatan: Jangan masukkan komentar atau spasi kosong sebelum DOCTYPE.

Menambahkan badge GCR

Untuk menunjukkan kepada pelanggan bahwa Anda menggunakan Google Customer Review, tambahkan badge GCR di setiap halaman situs yang Anda inginkan.

Jika Anda ingin agar badge ditampilkan secara inline, gunakan metode yang dijelaskan di bawah ini. Jika tidak, gunakan metode berikut untuk menempatkan badge GCR di kanan bawah atau kiri bawah halaman.

Untuk menambahkan badge GCR ke situs Anda:

Tempel cuplikan kode berikut ke halaman web Anda:

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

Tempatkan kode sebelum tag </BODY> penutup pada halaman. Jika ditempatkan berdampingan dengan kode keikutsertaan survei, urutannya tidak jadi masalah.

Ganti variabel dengan nilai dinamis khusus situs Anda. Tabel berikut ini menjelaskan setelan yang tersedia:

Variabel Wajib? Deskripsi

MERCHANT_ID Wajib ID Merchant Center Anda. Nilai ini bisa Anda dapatkan dari Google Merchant Center.

Variabel	Wajib?	Deskripsi
`MERCHANT_ID`	Wajib	ID Merchant Center Anda. Nilai ini bisa Anda dapatkan dari Google Merchant Center.
`POSITION`	Opsional	Merender badge di salah satu lokasi berikut: "BOTTOM_RIGHT": Membuat badge mengambang di bagian kanan bawah halaman. "BOTTOM_LEFT": Membuat badge mengambang di bagian kiri bawah halaman. "INLINE": Merender badge di tempat kode ditampilkan. Ketika menggunakan opsi ini, pastikan bahwa elemen lain pada halaman tidak menghalangi atau menutupi badge. Untuk metode yang lebih sederhana, silakan lihat menambahkan badge GCR secara inline. Posisi default badge adalah "BOTTOM_RIGHT".

POSITION

Opsional

Merender badge di salah satu lokasi berikut:

"BOTTOM_RIGHT": Membuat badge mengambang di bagian kanan bawah halaman.
"BOTTOM_LEFT": Membuat badge mengambang di bagian kiri bawah halaman.
"INLINE": Merender badge di tempat kode ditampilkan. Ketika menggunakan opsi ini, pastikan bahwa elemen lain pada halaman tidak menghalangi atau menutupi badge. Untuk metode yang lebih sederhana, silakan lihat menambahkan badge GCR secara inline.

Posisi default badge adalah "BOTTOM_RIGHT".

Secara opsional, tentukan bahasa yang akan digunakan badge dengan menempelkan cuplikan kode berikut ke halaman Anda: Jika Anda tidak menentukan nilai untuk parameter lang, badge akan menggunakan setelan browser pengguna untuk memilih bahasa secara otomatis.
```

<script>
  window.___gcfg = {
    lang: 'LANGUAGE'
  };
</script>

```
Tempatkan kode sebelum tag </BODY> penutup pada halaman. Jika ditempatkan berdampingan dengan kode badge, urutannya tidak jadi masalah.

Tetapkan nilai parameter lang dengan mengganti LANGUAGE dengan salah satu kode yang didukung berikut dari kolom Kode Bahasa:

Kode	Nama bahasa
af	Afrika
ar	Arab
cs	Ceko
da	Denmark
de	Jerman
en	Inggris
en-AU	Inggris-Australia
en-GB	Inggris (Inggris Raya)
en-US	Inggris (Amerika Serikat)
es	Spanyol
es-419	Spanyol (Amerika Latin)
fil	Filipina
fr	Prancis
ga	Irlandia
id	Indonesia
it	Italia
ja	Jepang
ms	Melayu
nl	Belanda
no	Norwegia
pl	Polandia
pt-BR	Portugis (Brasil)
pt-PT	Portugis
ru	Rusia
sv	Swedia
tr	Turkiye
zh-CN	China (Aksara Sederhana)
zh-TW	China (Aksara Tradisional)

Ulangi langkah 1 sampai 3 untuk semua halaman di situs tempat Anda ingin menampilkan badge.
Untuk menyelesaikan integrasi GCR, Anda harus menambahkan modul keikutsertaan survei ke halaman konfirmasi pesanan. Modul keikutsertaan survei wajib ada.

Untuk menambahkan badge GCR secara inline:

Tempel baris berikut sebelum tag body penutup di halaman HTML Anda, untuk memuat JavaScript pada badge:
```
<script src="https://apis.google.com/js/platform.js" async defer></script>
```
Tempel baris ini ke HTML di lokasi halaman tempat badge ingin ditampilkan:
```
<g:ratingbadge merchant_id=MERCHANT_ID></g:ratingbadge>
```
Ganti MERCHANT_ID dengan ID Merchant Center Anda sendiri.
Tentukan bahasa yang akan digunakan badge, seperti yang dijelaskan di sini.
Tambahkan modul keikutsertaan survei ke halaman konfirmasi pesanan Anda. Modul keikutsertaan survei wajib ada.

Contoh kode badge

Berikut ini adalah contoh kode untuk menempatkan badge di bagian kiri bawah halaman untuk ID merchant 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 -->

Jika badge tidak muncul di halaman Anda atau terjadi error ketika Anda memuat halaman, coba ikuti langkah-langkah pemecahan masalah ini.

Apakah ini membantu?

Bagaimana cara meningkatkannya?