Dados estruturados da organização (Organization)

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

Você pode usar dados estruturados da organização para informar ao Google os detalhes administrativos da sua organização, como logotipo, endereço, dados de contato e identificadores da empresa. O Google pode usar essa marcação em Painéis de informações e outros elementos visuais (como atribuição), o que ajuda os usuários a encontrar os detalhes da sua organização na Pesquisa Google com mais facilidade.

Como adicionar dados estruturados

Os dados estruturados são um formato padronizado para fornecer informações sobre uma página e classificar o conteúdo dela. Caso você não saiba muito sobre o assunto, veja como os dados estruturados funcionam.

Esta é uma visão geral de como criar, testar e lançar dados estruturados.

  1. Adicione todas as propriedades recomendadas que se aplicam à página da Web. Não há propriedades obrigatórias; adicione as propriedades que se aplicam ao seu conteúdo. Com base no formato que você está usando, saiba onde inserir dados estruturados na página.
  2. Siga as diretrizes.
  3. Valide o código com o Teste de pesquisa aprimorada e corrija os erros críticos. Corrija também os problemas não críticos que possam ser sinalizados na ferramenta, porque eles podem melhorar a qualidade dos dados estruturados, mas isso não é necessário para se qualificar para pesquisas aprimoradas.
  4. Implante algumas páginas que incluam os dados estruturados e use a Ferramenta de inspeção de URL para testar como o Google vê a página. Verifique se a página está acessível ao Google e se não está bloqueada por um arquivo robots.txt, pela tag noindex ou por requisitos de login. Se estiver tudo certo, peça ao Google para rastrear novamente seus URLs.
  5. Para informar o Google sobre mudanças futuras, recomendamos que você envie um sitemap. É possível automatizar isso com a API Search Console Sitemap.

Exemplos

Organization

Confira um exemplo de informações da organização no 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 no 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. Por 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 sua organização, se aplicável.

contactPoint

ContactPoint

A melhor maneira de um usuário entrar em contato com sua empresa, se aplicável. Inclua todos os métodos de suporte disponíveis para os usuários seguindo as práticas recomendadas do Google. Por 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 sua 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 sua 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 sua 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 na sua 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 melhor opção para 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

Os tipos de reembolso disponíveis 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 monetário 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 relacionadas a 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"
}

Veja como especificar várias substituições sazonais. Neste exemplo, a política de devolução normal é ilimitado, mas é limitado 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 devolução de 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. Se a devolução não tiver custos financeiros, 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.

Solução de problemas

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