Dati strutturati per elenco di corsi (Course)

Illustrazione di come un elenco dei corsi può essere visualizzato nella Ricerca Google. Mostra 3 corsi diversi dello stesso sito web in un formato elenco che gli utenti possono esplorare e selezionare un corso specifico

Con i dati strutturati per elenchi di corsi, puoi fornire maggiori informazioni sui tuoi corsi in modo che i potenziali studenti li trovino tramite la Ricerca Google. Puoi fornire dettagli tra cui il nome del corso, il nome di chi lo offre e una breve descrizione.

Disponibilità della funzionalità

Il risultato avanzato dell'elenco di corsi è disponibile in inglese in tutte le regioni in cui è disponibile la Ricerca Google.

How to add structured data

Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.

Here's an overview of how to build, test, and release structured data.

  1. Add the required properties. Based on the format you're using, learn where to insert structured data on the page.
  2. Follow the guidelines.
  3. Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).
  4. Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is accessible to Google and not blocked by a robots.txt file, the noindex tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs.
  5. To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.

Esempi

Pagina singola con i dettagli del corso

Ecco un esempio di pagina dei dettagli di un singolo corso. Questa pagina deve essere abbinata a una pagina di riepilogo contenente il markup ItemList.

<html>
  <head>
    <title>Introduction to Computer Science and Programming</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Course",
      "name": "Introduction to Computer Science and Programming",
      "description": "Introductory CS course laying out the basics.",
      "provider": {
        "@type": "Organization",
        "name": "University of Technology - Eureka",
        "sameAs": "https://www.example.com"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Un'unica pagina elenco

Ecco un esempio di un'unica pagina elenco. Questa configurazione di pagina include sia il markup dell'elenco che i dettagli di ogni corso sulla stessa pagina.

<html>
  <head>
    <title>Computer Science Courses</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "item": {
            "@type": "Course",
            "url":"https://www.example.com/courses#intro-to-cs",
            "name": "Introduction to Computer Science and Programming",
            "description": "This is an introductory CS course laying out the basics.",
            "provider": {
              "@type": "Organization",
              "name": "University of Technology - Example",
              "sameAs": "https://www.example.com"
           }
          }
        },
        {
          "@type": "ListItem",
          "position": 2,
          "item": {
            "@type": "Course",
            "url":"https://www.example.com/courses#intermediate-cs",
            "name": "Intermediate Computer Science and Programming",
            "description": "This is a CS course that builds on the basics learned in the Introduction course.",
            "provider": {
              "@type": "Organization",
              "name": "University of Technology - Example",
              "sameAs": "https://www.example.com"
           }
         }
        },
        {
          "@type": "ListItem",
          "position": 3,
          "item": {
            "@type": "Course",
            "url":"https://www.example.com/courses#advanced-cs",
            "name": "Advanced Computer Science and Programming",
            "description": "This CS course covers advanced programming principles.",
            "provider": {
              "@type": "Organization",
              "name": "University of Technology - Eureka",
              "sameAs": "https://www.example.com"
           }
          }
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Linee guida

Devi seguire queste linee guida per l'idoneità all'inclusione in un elenco di corsi.

Linee guida relative ai contenuti

  • Utilizza il markup Course solo per contenuti formativi che si adattano alla seguente definizione di corso: una serie o unità di apprendimento che contiene seminari, lezioni o moduli su una particolare materia e/o argomento.
  • Un corso deve avere come risultato esplicito l'apprendimento un conoscenze e/o competenze su una particolare materia e/o argomento ed essere tenuto da uno o più insegnanti con un certo numero di studenti.
  • Un evento pubblico generale, ad esempio una "Giornata dell'astronomia", o un singolo video di 2 minuti del tipo "Come fare un panino" non è considerato un corso.

Linee guida tecniche

Devi eseguire il markup di almeno 3 corsi; questi ultimi possono essere inseriti in pagine dei dettagli distinte o in un'unica pagina elenco.

Devi aggiungere il markup Carosello a una pagina di riepilogo o a un'unica pagina elenco.

Ogni corso deve avere proprietà name e provider valide. Ad esempio, le seguenti pratiche di denominazione non sono valide:

  • Frasi promozionali: "La migliore scuola al mondo".
  • Prezzi nei titoli del corso: "Impara a suonare l'ukulele a soli 30 $!".
  • Uso di un elemento diverso dal tema del corso per il titolo, ad esempio: "Guadagna velocemente con questo corso!".
  • Sconti oppure opportunità di acquisto, ad esempio: "I leader di vari settori condividono i loro segreti - 25% di sconto!".

Definizioni dei tipi di dati strutturati

Affinché i tuoi contenuti siano idonei per la visualizzazione come risultato avanzato, devi includere le proprietà obbligatorie. Puoi anche includere le proprietà consigliate per aggiungere ulteriori informazioni sui contenuti e offrire così un'esperienza utente migliore.

Course

Utilizza le seguenti proprietà per eseguire il markup di almeno 3 corsi; questi ultimi possono essere inseriti in pagine dei dettagli distinte o in un'unica pagina elenco.

La definizione completa di Course è disponibile all'indirizzo schema.org/Course. Le proprietà supportate da Google sono le seguenti:

Proprietà obbligatorie
description

Text

Una descrizione del corso. Limite di visualizzazione di 60 caratteri.
name

Text

Il titolo del corso.
Proprietà consigliate
provider

Organization

L'organizzazione che pubblica i contenuti di origine del corso. Ad esempio, la UC Berkeley.

ItemList

Oltre alle proprietà Course, aggiungi le seguenti proprietà per specificare l'elenco. Puoi aggiungere queste proprietà a una pagina di riepilogo o a una pagina all-in-one.

La definizione completa di ItemList è disponibile all'indirizzo schema.org/ItemList.

Proprietà obbligatorie
itemListElement

ListItem

Annotazione per una pagina di elemento.
ListItem.position

Integer

Posizione ordinale della pagina elemento nell'elenco.
ListItem.url

URL

L'URL canonico della pagina elemento. Ogni elemento deve avere un URL univoco.

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.