Data terstruktur kotak penelusuran sitelink (WebSite)

Kotak penelusuran sitelink adalah cara cepat bagi orang-orang untuk menelusuri situs atau aplikasi Anda di halaman hasil penelusuran. Kotak penelusuran menerapkan saran real-time dan fitur lainnya.

Google Penelusuran dapat otomatis menampilkan kotak penelusuran yang dicakupkan ke situs Anda saat situs muncul sebagai hasil penelusuran. Anda tidak perlu melakukan apa pun untuk mewujudkannya. Kotak penelusuran ini didukung oleh Google Penelusuran. Namun, Anda dapat secara eksplisit memberikan informasi dengan menambahkan data terstruktur WebSite, yang dapat membantu Google memahami situs Anda dengan lebih baik.

Jika Google Penelusuran sudah menampilkan kotak penelusuran sitelink untuk situs, Anda dapat mengontrol aspek tertentu dari kotak penelusuran sitelink dengan menambahkan data terstruktur WebSite.

Cara menerapkan kotak penelusuran sitelink

Berikut adalah langkah-langkah untuk membuat situs Anda memenuhi syarat untuk ditampilkan dengan kotak penelusuran di hasil Google Penelusuran:

  1. Instal mesin telusur yang berfungsi di situs atau aplikasi Android Anda.

    Kueri penelusuran sitelink akan mengarahkan pengguna ke halaman hasil penelusuran untuk situs atau aplikasi Anda, jadi Anda memerlukan mesin telusur yang berfungsi untuk mendukung fitur ini.

    • Situs: Siapkan mesin telusur di situs Anda. Fitur ini meneruskan kueri pengguna ke target Anda menggunakan sintaksis yang ditentukan dalam data terstruktur Anda. Mesin telusur Anda harus mendukung kueri yang berenkode UTF-8.
    • Aplikasi: Lihat Ringkasan Penelusuran di Situs Android Developer untuk mempelajari cara menerapkan mesin telusur di aplikasi Anda. Aplikasi Android Anda harus mendukung intent ACTION_VIEW dari hasil Penelusuran, dengan URI data terkait yang ditentukan dalam properti potentialAction.target markup Anda.
  2. Terapkan elemen data terstruktur WebSite di halaman beranda untuk situs Anda. Aplikasi harus memiliki situs terkait agar dapat mengaktifkan fitur ini, meskipun situs tersebut hanya terdiri dari satu halaman. Beberapa panduan tambahan:
    • Tambahkan markup ini hanya ke halaman beranda, bukan ke halaman lain.
    • Jika Anda sudah menerapkan data terstruktur WebSite untuk fitur nama situs, pastikan Anda menyusun properti nama situs secara bertingkat di node yang sama. Dengan kata lain, jangan buat blok data terstruktur WebSite tambahan di halaman beranda jika memungkinkan.
    • Selalu tentukan satu SearchAction untuk situs, dan satu lagi (opsional) jika mendukung penelusuran aplikasi. Anda harus memiliki SearchAction untuk situs meskipun jika target penelusuran pilihan Anda adalah aplikasi. Hal ini memastikan bahwa, jika pengguna tidak melakukan penelusuran dari ponsel Android atau tidak menginstal aplikasi Android Anda, hasil penelusuran akan mengarahkan pengguna ke situs Anda.
    • Berdasarkan format yang Anda gunakan, pelajari tempat untuk menyisipkan data terstruktur di halaman.
  3. Ikuti panduan.
  4. Validasikan kode Anda menggunakan Pengujian Hasil Kaya.
  5. Lakukan verifikasi terhadap implementasi mesin telusur Anda dengan menyalin URL WebSite.potentialAction.target dari data terstruktur, mengganti {search_term_string} dengan kueri uji coba, dan mengakses URL tersebut di browser web. Misalnya, jika situs Anda adalah example.com, dan Anda ingin menguji kueri "kittens", akses URL https://www.example.com/search/?q=kittens.
  6. Tetapkan URL kanonis pilihan untuk halaman beranda domain Anda menggunakan elemen link rel="canonical" di semua varian halaman beranda tersebut. Cara ini membantu Google Penelusuran memilih URL yang tepat untuk markup Anda. Server Anda harus mendukung encoding karakter UTF-8.
  7. Untuk aplikasi, aktifkan filter intent yang tepat untuk mendukung URL yang Anda tentukan pada target aplikasi markup Anda. Untuk contoh cara membuat filter intent untuk URL Google Penelusuran, lihat Firebase App Indexing untuk Android.
  8. Deploy beberapa halaman yang menyertakan data terstruktur Anda dan gunakan Alat Inspeksi URL untuk menguji cara Google melihat halaman tersebut. Pastikan halaman Anda dapat diakses oleh Google dan tidak diblokir oleh file robots.txt, tag noindex, atau persyaratan login. Jika halaman tidak bermasalah, Anda dapat meminta Google meng-crawl ulang URL Anda.
  9. Agar Google tetap mengetahui adanya perubahan pada masa mendatang, sebaiknya Anda mengirimkan peta situs. Anda dapat mengotomatiskan proses ini dengan Search Console Sitemap API.

Contoh

Berikut ini contoh hasil penelusuran untuk "Pinterest" di Google yang menampilkan kotak penelusuran sitelink untuk situs Pinterest:

Kotak penelusuran sitelink sedang digunakan

Berikut ini beberapa contoh markup yang akan menerapkan kotak penelusuran sitelink yang menggunakan mesin telusur khusus situs:

JSON-LD

Berikut adalah contoh dalam JSON-LD:


<html>
  <head>
    <title>The title of the page</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "WebSite",
      "url": "https://www.example.com/",
      "potentialAction": {
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://query.example.com/search?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdata

Berikut adalah contoh dalam Microdata:


<div itemscope itemtype="https://schema.org/WebSite">
  <meta itemprop="url" content="https://www.example.com/"/>
  <form itemprop="potentialAction" itemscope itemtype="https://schema.org/SearchAction">
    <meta itemprop="target" content="https://query.example.com/search?q={search_term_string}"/>
    <input itemprop="query-input" type="text" name="search_term_string" required/>
    <input type="submit"/>
  </form>
</div>

Berikut adalah contoh situs dan aplikasi dalam JSON-LD:

<html>
  <head>
    <title>The title of the page</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "WebSite",
      "url": "https://www.example.com/",
      "potentialAction": [{
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://query.example.com/search?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      },{
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "android-app://com.example/https/query.example.com/search/?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Panduan

Anda harus mengikuti panduan ini agar situs Anda memenuhi syarat untuk dimunculkan sebagai hasil kaya.

Google Penelusuran dapat memilih untuk menambahkan kotak penelusuran sitelink ke situs Anda meskipun situs tersebut tidak memuat data terstruktur yang dijelaskan di sini. Namun, Anda dapat mencegah perilaku ini dengan menambahkan tag meta berikut ke halaman beranda Anda:

<meta name="google" content="nositelinkssearchbox">

Definisi jenis data terstruktur

Agar konten Anda memenuhi syarat untuk ditampilkan dengan kotak penelusuran sitelink, sertakan properti yang diperlukan.

Jenis WebSite yang dimodifikasi

Google Penelusuran menggunakan jenis data terstruktur WebSite yang dimodifikasi, baik untuk kotak penelusuran situs maupun aplikasi. Definisi lengkap WebSite tersedia di schema.org, meskipun Google Penelusuran sedikit menyimpang dari standar. Properti yang didukung Google adalah sebagai berikut:

Properti wajib
potentialAction

Array yang terdiri dari satu atau dua objek SearchAction

Objek ini menjelaskan URI yang dikirimi kueri, dan sintaks permintaan yang dikirim. Anda harus menerapkan pengendali intent atau halaman yang dapat menerima permintaan, dan menjalankan penelusuran yang sesuai pada string yang dikirim. Jika pengguna tidak menggunakan aplikasi Android (atau menggunakan aplikasi Android, tetapi belum menentukan target intent Android), kotak penelusuran akan mengirimkan kueri versi situs ke lokasi yang ditentukan; jika pengguna menggunakan perangkat Android dan telah menentukan URI intent Android, kotak penelusuran akan mengirimkan intent tersebut.

Anda harus membuat SearchAction situs untuk mendukung kasus penelusuran desktop. Jika kode situs juga mendukung penelusuran aplikasi, Anda dapat menentukan objek SearchAction untuk aplikasi Anda. Setiap objek SearchAction harus berisi properti bertingkat berikut:

Contoh situs

Contoh berikut mengirimkan permintaan GET ke https://query.example.com/search?q=user%20search%20string.

"potentialAction": [{
  "@type": "SearchAction",
  "target": {
    "@type": "EntryPoint",
    "urlTemplate": "https://query.example.com/search?q={search_term_string}"
  },
  "query-input": "required name=search_term_string"
}]

Contoh aplikasi

Contoh berikut mengirimkan intent Android ke android-app://com.example/https/query.example.com/search/?q=user_search_string. 

"potentialAction": [{
  "@type": "SearchAction",
  "target": {
    "@type": "EntryPoint",
    "urlTemplate": "android-app://com.example/https/query.example.com/search/?q={search_term_string}"
  },
  "query-input": "required name=search_term_string"
}]
potentialAction.query-input

Text

Gunakan string literal required name = search-term, atau placeholder apa pun yang Anda gunakan dalam target. Pastikan kedua nilai placeholder cocok. Misalnya, kedua nilai placeholder pada properti target dan query-input menggunakan string search-term:

"potentialAction": [{
  "@type": "SearchAction",
  "target": {
    "@type": "EntryPoint",
    "urlTemplate": "https://query.example.com/search?q={search-term}"
  },
  "query-input": "required name=search-term"
}]
potentialAction.target

EntryPoint

Objek EntryPoint dengan properti urlTemplate.

urlTemplate harus berupa string dalam format ini: search_handler_uri{search_term_string}

Contoh:

https://query.example.com/search?q={search_term_string}
search_handler_uri Untuk situs, URL pengendali yang akan menerima dan menangani kueri penelusuran; untuk aplikasi, URI pengendali intent untuk mesin telusur Anda yang akan menangani kueri.
search_term_string

String placeholder yang diganti dengan kueri penelusuran pengguna ketika pengguna mengklik tombol "Telusuri" di kotak penelusuran. Pastikan bahwa string placeholder apa pun yang Anda gunakan di sini juga cocok dengan nilai elemen name untuk properti query-input.
url

URL

Menentukan URL situs yang sedang ditelusuri. Tetapkan ke halaman beranda kanonis situs Anda. Contoh: https://www.example.org

Monitor rich results with Search Console

Search Console is a tool that helps you monitor how your pages perform in Google Search. You don't have to sign up for Search Console to be included in Google Search results, but it can help you understand and improve how Google sees your site. We recommend checking Search Console in the following cases:

  1. After deploying structured data for the first time
  2. After releasing new templates or updating your code
  3. Analyzing traffic periodically

After deploying structured data for the first time

After Google has indexed your pages, look for issues using the relevant Rich result status report. Ideally, there will be an increase of valid items, and no increase in invalid items. If you find issues in your structured data:

  1. Fix the invalid items.
  2. Inspect a live URL to check if the issue persists.
  3. Request validation using the status report.

After releasing new templates or updating your code

When you make significant changes to your website, monitor for increases in structured data invalid items.
  • If you see an increase in invalid items, perhaps you rolled out a new template that doesn't work, or your site interacts with the existing template in a new and bad way.
  • If you see a decrease in valid items (not matched by an increase in invalid items), perhaps you are no longer embedding structured data in your pages. Use the URL Inspection tool to learn what is causing the issue.

Analyzing traffic periodically

Analyze your Google Search traffic using the Performance Report. The data will show you how often your page appears as a rich result in Search, how often users click on it and what is the average position you appear on search results. You can also automatically pull these results with the Search Console API.

Troubleshooting

If you're having trouble implementing or debugging structured data, here are some resources that may help you.

  • If you're using a content management system (CMS) or someone else is taking care of your site, ask them to help you. Make sure to forward any Search Console message that details the issue to them.
  • Google does not guarantee that features that consume structured data will show up in search results. For a list of common reasons why Google may not show your content in a rich result, see the General Structured Data Guidelines.
  • You might have an error in your structured data. Check the list of structured data errors and the Unparsable structured data report.
  • If you received a structured data manual action against your page, the structured data on the page will be ignored (although the page can still appear in Google Search results). To fix structured data issues, use the Manual Actions report.
  • Review the guidelines again to identify if your content isn't compliant with the guidelines. The problem can be caused by either spammy content or spammy markup usage. However, the issue may not be a syntax issue, and so the Rich Results Test won't be able to identify these issues.
  • Troubleshoot missing rich results / drop in total rich results.
  • Allow time for re-crawling and re-indexing. Remember that it may take several days after publishing a page for Google to find and crawl it. For general questions about crawling and indexing, check the Google Search crawling and indexing FAQ.
  • Post a question in the Google Search Central forum.