Dados estruturados da organização (Organization)

Painel de informações do comerciante nos resultados da Pesquisa do Google
Painel de informações do comerciante nos resultados da Pesquisa do Google

Adicionar dados estruturados da organização à página inicial pode ajudar o Google a entender melhor os detalhes administrativos da sua organização e eliminar a ambiguidade nos resultados da pesquisa. Algumas propriedades são usadas em segundo plano para diferenciar a organização de outras (como iso6523 e naics), enquanto outras podem influenciar os elementos visuais em resultados da Pesquisa (como a exibição de logo nos resultados da Pesquisa e no Painel de informações). Se você tiver uma loja, poderá incluir mais detalhes no Painel de informações da loja e no perfil de marca, como a política de devolução, o endereço e os dados de contato. Não há propriedades obrigatórias. Recomendamos que você adicione o máximo de propriedades relevantes para a organização.

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 as many recommended properties that apply to your web page. There are no required properties; instead, add the properties that apply to your content. 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.

Exemplos

Organization

Confira um exemplo de informações da organização em código JSON-LD.


<html>
  <head>
    <title>About Us</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Organization",
      "image": "https://www.example.com/example_image.jpg",
      "url": "https://www.example.com",
      "sameAs": ["https://example.net/profile/example1234", "https://example.org/example1234"],
      "logo": "https://www.example.com/images/logo.png",
      "name": "Example Corporation",
      "description": "The example corporation is well-known for producing high-quality widgets",
      "email": "contact@example.com",
      "telephone": "+47-99-999-9999",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "Rue Improbable 99",
        "addressLocality": "Paris",
        "addressCountry": "FR",
        "addressRegion": "Ile-de-France",
        "postalCode": "75001"
      },
      "vatID": "FR12345678901",
      "iso6523Code": "0199:724500PMK2A2M1SQQ228"
    }
    </script>
  </head>
  <body>
  </body>
</html>

OnlineStore com política de devolução (exemplo de subtipo de Organization)

Confira um exemplo de informações da loja on-line em código JSON-LD.

<html>
  <head>
    <title>About Us</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "OnlineStore",
      "name": "Example Online Store",
      "url": "https://www.example.com",
      "sameAs": ["https://example.net/profile/example12", "https://example.org/@example34"],
      "logo": "https://www.example.com/assets/images/logo.png",
      "contactPoint": {
        "contactType": "Customer Service",
        "email": "support@example.com",
        "telephone": "+47-99-999-9900"
      },
      "vatID": "FR12345678901",
      "iso6523Code": "0199:724500PMK2A2M1SQQ228",
      "hasMerchantReturnPolicy": {
        "@type": "MerchantReturnPolicy",
        "applicableCountry": ["FR", "CH"],
        "returnPolicyCountry": "FR",
        "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
        "merchantReturnDays": 60,
        "returnMethod": "https://schema.org/ReturnByMail",
        "returnFees": "https://schema.org/FreeReturn",
        "refundType": "https://schema.org/FullRefund"
      }
      ... // Other Organization-level properties
    }
    </script>
  </head>
  <body>
  </body>
</html>

Diretrizes

Siga estas diretrizes para que os dados estruturados sejam qualificados para inclusão nos resultados da Pesquisa Google.

Diretrizes técnicas

Recomendamos que você insira essas informações na sua página inicial ou em uma única página que descreva sua organização, por exemplo, a página Sobre. A inclusão não é necessária em todas as páginas do site.

Recomendamos usar o subtipo Organization de schema.org mais específico que corresponda à sua organização. Por exemplo, se você tem um site de e-commerce, recomendamos usar o subtipo OnlineStore em vez de OnlineBusiness. Caso seu site seja sobre uma empresa local, como um restaurante ou uma loja física, recomendamos que você forneça seus detalhes administrativos usando os subtipo(s) mais específicos de LocalBusiness e siga os campos obrigatórios e recomendados para Empresa local, além dos campos recomendados neste guia.

Definições de tipos de dados estruturados

O Google reconhece as seguintes propriedades de Organization. Para ajudar o Google a entender melhor sua página, inclua todas as propriedades recomendadas que se aplicam à página da Web. Não há propriedades obrigatórias; adicione as propriedades que se aplicam à sua organização.

Propriedades recomendadas
address

PostalAddress

O endereço (físico ou de correspondência) da sua organização, se aplicável. Inclua todas as propriedades que se aplicam ao seu país. Quanto mais propriedades você informar, maior será a qualidade do resultado para os usuários. Você poderá fornecer vários endereços se tiver instalações em várias cidades, estados ou países. Exemplo:

"address": [{
  "@type": "PostalAddress",
  "streetAddress": "999 W Example St Suite 99 Unit 9",
  "addressLocality": "New York",
  "addressRegion": "NY",
  "postalCode": "10019",
  "addressCountry": "US"
},{
  "streetAddress": "999 Rue due exemple",
  "addressLocality": "Paris",
  "postalCode": "75001",
  "addressCountry": "FR"
}]
address.addressCountry

Text

O país do seu endereço postal, usando o código do país no formato ISO 3166-1 alfa-2 com duas letras.

address.addressLocality

Text

A cidade do seu endereço postal.

address.addressRegion

Text

A região do seu endereço postal, se aplicável. Por exemplo, um estado.

address.postalCode

Text

O código postal do seu endereço.

address.streetAddress

Text

Seu endereço postal completo.

alternateName

Text

Outro nome comum usado pela organização, se aplicável.

contactPoint

ContactPoint

A melhor maneira de um usuário entrar em contato com a empresa, se aplicável. Inclua todos os métodos de suporte disponíveis para os usuários seguindo as práticas recomendadas do Google. Exemplo:

"contactPoint": {
  "@type": "ContactPoint",
  "telephone": "+9-999-999-9999",
  "email": "contact@example.com"
}
contactPoint.email

Text

O endereço de e-mail para entrar em contato com sua empresa, se aplicável. Se você estiver usando o tipo LocalBusiness, especifique um endereço de e-mail principal no nível de LocalBusiness antes de usar contactPoint para especificar várias maneiras de entrar em contato com sua organização.

contactPoint.telephone

Text

O número de telefone para entrar em contato com a empresa, se aplicável. Não se esqueça de incluir o código do país e o código de área no número de telefone. Se você estiver usando o tipo LocalBusiness, especifique um número de telefone principal no nível de LocalBusiness antes de usar contactPoint para especificar várias maneiras de entrar em contato com sua organização.

description

Text

Uma descrição detalhada da organização, se aplicável.

duns

Text

O número DUNS da Dun & Bradstreet para identificar sua Organization, se aplicável. Recomendamos usar o campo iso6523Code com o prefixo 0060:.

email

Text

O endereço de e-mail para entrar em contato com sua empresa, se aplicável.

foundingDate

Date

A data de fundação da Organization, no formato de data ISO 8601, se aplicável.

globalLocationNumber

Text

O número de local global da GS1 que identifica o local da sua Organization, se aplicável.

hasMerchantReturnPolicy

MerchantReturnPolicy

A política de devolução usada pela sua Organization, se aplicável. Se você adicionar essa propriedade, inclua também os campos obrigatórios e recomendados para MerchantReturnPolicy.

iso6523Code

Text

O identificador ISO 6523 da sua organização, se aplicável. A primeira parte de um identificador ISO 6523 é o ICD (Designação de Código Internacional), que define qual esquema de identificação é usado. A segunda parte é o identificador em si. Recomendamos separar o ICD e o identificador com dois-pontos (U+003A). Os valores de ICD comuns incluem:

  • 0060: sistema de numeração universal de dados (DUNS, na sigla em inglês) da Dun & Bradstreet
  • 0088: número global de localização GS1 (GLN)
  • 0199: identificador de entidade jurídica (LEI, na sigla em inglês)
legalName

Text

A razão social registrada da sua Organization, se aplicável e diferente da propriedade name.

leiCode

Text

É o identificador da sua Organization, conforme definido na ISO 17442, se aplicável. Recomendamos usar o campo iso6523Code com o prefixo 0199:.

logo

URL ou ImageObject

Um logotipo que represente a organização, se aplicável. Com essa propriedade, o Google pode entender melhor qual logotipo você quer mostrar, por exemplo, nos resultados da Pesquisa e nos Painéis de informações.

Diretrizes de imagem:

  • A imagem precisa ter, no mínimo, 112 x 112 px.
  • O URL da imagem precisa ser rastreável e indexável.
  • O formato do arquivo de imagem precisa ser compatível com o Imagens do Google.
  • Confirme se a imagem tem a aparência que você quer em um fundo branco. Por exemplo, se o logotipo for principalmente branco ou cinza, talvez ele não fique do jeito que você quer quando exibido em um fundo branco.

Se você usar o tipo ImageObject, confira se ele tem uma propriedade contentUrl ou url válida que siga as mesmas diretrizes do tipo URL.

naics

Text

O código do Sistema de Classificação do Setor da América do Norte (NAICS, na sigla em inglês) para sua Organization, se aplicável.

name

Text

O nome da organização. Use os mesmos name e alternateName do nome do site

numberOfEmployees

QuantitativeValue

O número de funcionários em seu Organization, se aplicável.

Exemplo com um número específico de funcionários:

"numberOfEmployees": {
  "@type": "QuantitativeValue",
  "value": 2056
}

Exemplo com o número de funcionários em um intervalo:

"numberOfEmployees": {
  "@type": "QuantitativeValue",
  "minValue": 100,
  "maxValue": 999
}
sameAs

URL

O URL de uma página em outro site com mais informações sobre sua organização, se aplicável. Por exemplo, um URL para a página de perfil da sua organização em um site de mídias sociais ou de avaliações. É possível informar vários URLs sameAs.

taxID

Text

O CPF/CNPJ ou outro ID fiscal associado à Organization, se aplicável. O taxID precisa corresponder ao país que você informou no campo address.

telephone

Text

Um número de telefone da empresa que será a forma de contato principal para os clientes, se aplicável. Não se esqueça de incluir o código do país e o código de área no número de telefone.

url

URL

O URL do site da sua organização, se aplicável. Isso ajuda o Google a identificar sua organização de maneira exclusiva.

vatID

Text

O código do IVA (Imposto sobre Valor Agregado) associado à sua Organization, se aplicável ao seu país e empresa. Esse é um indicador de confiança importante para os usuários (por exemplo, eles podem procurar sua empresa em registros de IVA públicos).

MerchantReturnPolicy

Use as propriedades a seguir a fim de descrever políticas gerais de devolução para toda a Organization, se aplicável. Se você tiver políticas específicas para produtos individuais, use marcação de produtos do comerciante.

Propriedades obrigatórias (escolha a opção mais adequada ao seu caso de uso)
Opção A
applicableCountry

Text

O código do país ao qual a política de devolução se aplica, usando a formatação de código de país ISO 3166-1 alfa-2 com duas letras. É possível especificar até 50 países.

returnPolicyCategory

MerchantReturnEnumeration

É o tipo de política de devolução. Use um dos seguintes valores:

  • https://schema.org/MerchantReturnFiniteReturnWindow: há um número definido de dias para devolver um produto.
  • https://schema.org/MerchantReturnNotPermitted: não é permitido fazer devoluções.
  • https://schema.org/MerchantReturnUnlimitedWindow: o prazo de devolução de um produto é ilimitado.

Se você usar MerchantReturnFiniteReturnWindow, a propriedade merchantReturnDays vai ser obrigatória.

returnPolicyCountry

Text

O país para onde o produto é enviado em caso de devoluções. Esse país pode ser diferente do país para onde o produto foi originalmente enviado. Formatação de código do país ISO 3166-1 alfa-2. É possível especificar até 50 países.

Opção B
Propriedades recomendadas
customerRemorseReturnFees

ReturnFeesEnumeration

Um tipo específico de taxa de devolução se o produto for devolvido por arrependimento do cliente. Consulte returnFees para conferir os possíveis valores.

customerRemorseReturnLabelSource

ReturnLabelSourceEnumeration

O método como o consumidor recebe o rótulo para envio de devolução de um produto. Consulte returnLabelSource para conferir os possíveis valores.

customerRemorseReturnShippingFeesAmount

MonetaryAmount

O custo do frete para devolver um produto devido a arrependimento do cliente. Essa propriedade só é obrigatória caso haja uma taxa de frete diferente de zero a ser paga pelo consumidor para devolver um produto. Consulte returnShippingFeesAmount para ver detalhes.

itemCondition

OfferItemCondition

As condições aceitáveis de um item que pode ser devolvido. Você pode informar várias condições que são aceitas. Use os valores a seguir:

  • https://schema.org/DamagedCondition: itens danificados são aceitos.
  • https://schema.org/NewCondition: itens novos são aceitos.
  • https://schema.org/RefurbishedCondition: itens recondicionados são aceitos.
  • https://schema.org/UsedCondition: itens usados são aceitos.
itemDefectReturnFees

ReturnFeesEnumeration

Um tipo específico de taxa de devolução para produtos com defeito. Consulte returnFees para conferir os possíveis valores.

itemDefectReturnLabelSource

ReturnLabelSourceEnumeration

O método como o consumidor pode receber o rótulo para envio de devolução de um produto. Consulte returnLabelSource para conferir os possíveis valores.

itemDefectReturnShippingFeesAmount

MonetaryAmount

O custo do frete para devolução de um produto devido a defeito. Essa propriedade só é obrigatória caso haja uma taxa de frete diferente de zero a ser paga pelo consumidor para devolver um produto. Consulte returnShippingFeesAmount para ver detalhes.

merchantReturnDays

Integer ou Date ou DateTime

O número de dias (a partir da data de entrega) que um produto pode ser devolvido. Essa propriedade só vai ser obrigatória se você definir returnPolicyCategory como MerchantReturnFiniteReturnWindow.

refundType

RefundType

O tipo de reembolso disponível para o consumidor ao devolver um produto.

  • https://schema.org/ExchangeRefund: o item pode ser trocado pelo mesmo produto.
  • https://schema.org/FullRefund: o item pode ser reembolsado pelo valor total.
  • https://schema.org/StoreCreditRefund: o item pode ser reembolsado por crédito na loja.
returnFees

ReturnFeesEnumeration

O tipo padrão de taxa de devolução. Use um dos seguintes valores compatíveis:

  • https://schema.org/FreeReturn: não há custo financeiro para o consumidor devolver o produto. Se essa opção for usada, não inclua a propriedade returnShippingFeesAmount.
  • https://schema.org/ReturnFeesCustomerResponsibility: o consumidor precisa lidar e pagar pelo frete da devolução. Se essa opção for usada, não inclua a propriedade returnShippingFeesAmount.
  • https://schema.org/ReturnShippingFees: há uma taxa de frete cobrada do consumidor pelo comerciante para devolver o produto. Especifique a taxa de frete diferente de zero usando a propriedade returnShippingFeesAmount.
returnLabelSource

ReturnLabelSourceEnumeration

O método como o consumidor pode receber o rótulo para envio de devolução de um produto. Use um dos seguintes valores:

  • https://schema.org/ReturnLabelCustomerResponsibility: é responsabilidade do consumidor criar uma etiqueta de devolução.
  • https://schema.org/ReturnLabelDownloadAndPrint: o cliente precisa baixar e imprimir a etiqueta de devolução.
  • https://schema.org/ReturnLabelInBox: a etiqueta de devolução foi incluída quando o produto foi enviado originalmente.
returnMethod

ReturnMethodEnumeration

É o tipo de método de devolução oferecido. Isso só é recomendado se returnPolicyCategory for diferente de MerchantReturnNotPermitted. Use um ou mais dos seguintes valores:

  • https://schema.org/ReturnAtKiosk: o item pode ser devolvido em um quiosque.
  • https://schema.org/ReturnByMail: o item pode ser devolvido pelo correio.
  • https://schema.org/ReturnInStore: o item pode ser devolvido na loja.
returnPolicySeasonalOverride

MerchantReturnPolicySeasonalOverride

Uma substituição sazonal de uma política de devolução para especificar políticas de devolução em eventos especiais, como feriados. Por exemplo, a categoria da sua política de devolução normal está definida como MerchantReturnPolicyUnlimitedWindow, mas o período de devolução precisa ser limitado durante as promoções da Black Friday:

"returnPolicySeasonalOverride": {
  "@type": "MerchantReturnPolicySeasonalOverride",
  "startDate": "2024-11-29",
  "endDate": "2024-12-06",
  "merchantReturnDays": 10,
  "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow"
}

Saiba como especificar várias substituições sazonais. Neste exemplo, a política de devolução comum é ilimitada, mas ela é limitada durante os dois períodos a seguir:

"returnPolicySeasonalOverride": [{
  "@type": "MerchantReturnPolicySeasonalOverride",
  "startDate": "2024-11-29",
  "endDate": "2024-12-06",
  "merchantReturnDays": 10,
  "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow"
},
{
  "@type": "MerchantReturnPolicySeasonalOverride",
  "startDate": "2024-12-26",
  "endDate": "2025-01-06",
  "merchantReturnDays": 10,
  "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow"
}]
returnPolicySeasonalOverride.endDate

Date ou DateTime

A data de término da substituição sazonal.

returnPolicySeasonalOverride.merchantReturnDays

Integer ou Date ou DateTime

O número de dias (a partir da data de entrega) que um produto pode ser devolvido. Essa propriedade só vai ser obrigatória se você definir returnPolicyCategory como MerchantReturnFiniteReturnWindow.

returnPolicySeasonalOverride.returnPolicyCategory

MerchantReturnEnumeration

É o tipo de política de devolução. Use um dos seguintes valores:

  • https://schema.org/MerchantReturnFiniteReturnWindow: há um número definido de dias para devolver um produto.
  • https://schema.org/MerchantReturnNotPermitted: não é permitido fazer devoluções.
  • https://schema.org/MerchantReturnUnlimitedWindow: o prazo de devolução de um produto é ilimitado.

Se você usar MerchantReturnFiniteReturnWindow, a propriedade merchantReturnDays vai ser obrigatória.

returnPolicySeasonalOverride.startDate

Date ou DateTime

A data de início da substituição sazonal.

returnShippingFeesAmount

MonetaryAmount

O custo do frete para devolver um produto. Essa propriedade só será obrigatória se houver uma taxa de frete diferente de zero a ser paga pelo consumidor ao comerciante para devolver um produto. Nesse caso, returnFees precisa ser definido como https://schema.org/ReturnShippingFees. returnFees vai precisar ser definido como https://schema.org/FreeReturn. Se o consumidor precisar lidar e pagar o custo do frete da devolução, defina returnFees como https://schema.org/ReturnFeesCustomerResponsibility.

Abordagem alternativa para definir as configurações de devolução no Google

As políticas de devolução para lojas podem ser complexas e mudar com frequência. Se você estiver com dificuldades para indicar e manter os detalhes de devolução atualizados com marcações e tiver uma conta do Google Merchant Center, considere definir as políticas de devolução na Ajuda do Google Merchant Center. Também é possível configurar políticas de devolução no nível da conta no Search Console, que são adicionadas automaticamente ao Merchant Center.

Combinar várias configurações de frete e devolução

Ao combinar várias configurações de frete e devolução, pense em como substituir as informações da política com base na ordem de precedência. Por exemplo, se você fornecer marcação no nível da organização no seu site e configurações da política de devolução no Search Console, o Google só usará as informações fornecidas no Search Console. Se você enviar um feed de produtos no Merchant Center e definir as configurações de frete no Search Console, as informações do seu feed do Merchant Center substituirão as configurações do Search Console.

Veja o que tem precedência para informações de frete e política de devolução (classificadas por força, sendo os feeds mais fortes):

Solução de problemas

Se você tiver problemas para implementar ou depurar dados estruturados, veja alguns recursos que podem ajudar.