Comparação entre estratégias de localização da Contentful

A localização molda toda a experiência para um mercado específico, em vez de se limitar a converter o texto para outro idioma. No Contentful, essa diferença se reflete na forma como você estrutura os tipos de conteúdo e as entradas.  

A Contentful descreve quatro padrões/abordagens principais de localização — nível de campo, nível de entrada, tipo de conteúdo e nível de espaço —, mas não chega a indicar qual deles escolher, nem quando passar de um para outro. Escolher o padrão errado logo no início pode prender suas equipes em fluxos de trabalho frágeis, conteúdo duplicado e reconstruções dispendiosas assim que você adicionar seu terceiro mercado ou segundo canal.

Este guia explica cada estratégia, como as configurações regionais e os planos alternativos funcionam na API e as vantagens e desvantagens relevantes para o seu modelo de publicação. Também mostraremos como combinar o Contentful com uma ferramenta de tradução de sites baseada em IA, como Weglot , oferece um caminho mais rápido para um site multilíngue.

Principais Conclusões

• Escolha primeiro sua estratégia do Contentful – cada uma se adapta a um modelo diferente de governança e publicação.
  
• Decida logo no início se deseja uma separação estrita por mercado ou conteúdo compartilhado com alternativas; alterar isso após a terceira localização geralmente implica uma recompilação.
  
• Considere as cadeias de fallback como um elemento de design deliberado – elas determinam quais mercados herdam conteúdo de outros e em que momento.
  
• Tenha clareza sobre onde as traduções devem ficar: dentro do Contentful para reutilização em vários canais, ou na camada do site, se sua prioridade for lançar rapidamente um site multilíngue.
  
• Uma ferramenta de tradução por IA como Weglot oferece automação, SEO e maior flexibilidade, pois lida com todo o trabalho técnico na nuvem.

Como a Contentful estrutura o conteúdo multilíngue

No Contentful, tudo começa com as configurações regionais – cada uma delas é um par de idioma-região, como en-US ou de-AT, e cada espaço possui uma única configuração regional padrão que a API de Entrega de Conteúdo (CDA) retorna quando você não especifica uma. As configurações regionais estão definidas no nível do ambiente, e você pode ter até 500 delas por ambiente, dependendo do seu plano.

Você controla a localização no nível dos campos dentro de um tipo de conteúdo. Qualquer campo marcado como `localized: true` armazena valores distintos para cada localidade, enquanto os campos não localizados mantêm um único valor comum a todos os idiomas. Isso é ideal para itens como SKUs, IDs ou datas globais. Você pode editar e adicionar localidades por meio da API de gerenciamento de conteúdo, incluindo códigos e nomes personalizados, de modo que não fica limitado a uma lista ISO rígida, desde que cada código seja único.

Ao configurar uma localização, a opção “Permitir campos vazios para esta localização” permite que os editores publiquem mesmo que alguns campos localizados ainda não tenham valores, o que é útil quando diferentes mercados evoluem em ritmos distintos. Os valores ausentes podem então ser preenchidos automaticamente pela sua hierarquia de localizações personalizada, de modo que você decide se a localização de-CH deve herdar da de-DE, da en-US ou de nenhuma outra.

Comparação entre localização em nível de campo, nível básico, nível de tipo de conteúdo e nível de espaço

O Contentful oferece quatro estratégias principais para arquitetura multilíngue: localização no nível do campo, no nível da entrada, no nível do tipo de conteúdo e no nível do espaço. Cada uma delas resolve um problema diferente relacionado à governança, à independência de publicação e ao grau de separação que você deseja estabelecer entre os mercados.

Aqui está uma comparação geral:

‍

A localização no nível do campo mantém todos os idiomas em uma única entrada. Os campos localizados armazenam valores separados por configuração regional, e você ainda conta com publicação baseada na configuração regional, opções alternativas e governança baseada em funções. Para a maioria das equipes, esse é o melhor ponto de partida, pois mantém o modelo organizado e, ao mesmo tempo, permite publicar por configuração regional quando necessário.

A localização básica utiliza uma entrada de “invólucro global” que remete para entradas localizadas separadas. Essa abordagem é adequada quando as equipes regionais precisam de mais autonomia, de um conteúdo ligeiramente diferente ou de seus próprios fluxos de aprovação. Você mantém o comportamento de fallback no campo de referência, mas não obtém permissões estritamente limitadas ao escopo da localidade, pois os tradutores estão editando entradas diferentes, em vez de diferentes localizações de uma única entrada.

A localização no nível do tipo de conteúdo duplica os tipos de conteúdo por localidade dentro do mesmo espaço, enquanto a localização no nível do espaço duplica todo o modelo de conteúdo em espaços separados para cada localidade ou região.

Ambas as opções oferecem uma separação clara e publicação totalmente independente, mas você perde os recursos automáticos de fallback e precisa lidar com o trabalho constante de sincronização de esquemas e conteúdos. Recomendamos essas opções apenas para casos de conformidade rigorosa ou para mercados em que o conteúdo jurídico, de produtos ou de marca deva ser completamente diferente do seu site principal.

“Weglot contorna todas essas limitações de modelagem ao traduzir a interface renderizada por meio de um snippet de JavaScript snippet ou no lado do servidor, quando compatível), para que você possa lançar rapidamente um site multilíngue no Contentful sem precisar redesenhar seu modelo de conteúdo primeiro.”

– Christophe Garcia, diretor de suporte da Weglot

{{banner-citação-cta}}

Configurando cadeias de fallback e a armadilha do valor vazio

Adicionar uma localização no Contentful é um processo de três etapas: criá-la, configurar os fallbacks e, por fim, ativá-la nos campos. Você adiciona a localidade por meio da API de Gerenciamento de Conteúdo (ou do aplicativo web), define seu fallbackCode para construir uma cadeia como de-CH → de-AT → de-DE e, por fim, marca os campos desejados como localized: true para que possam armazenar valores por localidade. Essa cadeia define como o CDA sobe até uma localidade pai quando nenhum valor é definido.

O ponto delicado é como o Contentful determina que um valor está faltando. O CDA trata três estados de campo de maneira diferente:

• Ausente: Não há nenhum valor definido para essa localidade, portanto, o CDA segue a cadeia de substituição configurada.
  
• Nulo (definido via CMA): O CDA retorna nulo para essa localidade e não tenta a cadeia de fallback.
  
• String vazia "" (definida via CMA): O CDA retorna "" para essa localidade e não tenta a cadeia de fallback.

Só é possível criar esses estados nulos ou "" programaticamente por meio do CMA – o aplicativo web impede que os editores os salvem –, e é por isso que esse bug costuma passar despercebido em scripts de migração e integrações personalizadas.

A caixa de seleção “Permitir que campos obrigatórios fiquem em branco para esta localização” diz respeito à validação. Ela permite que os editores publiquem entradas nas quais alguns campos localizados ainda não tenham nenhum valor, mas o CDA continuará seguindo as mesmas regras de substituição quando encontrar essas localizações não definidas no momento da leitura.

Publicação independente de configurações regionais e gerenciamento do acesso dos tradutores

Para selecionar um idioma específico no seu front-end, utilize o parâmetro de consulta "locale" com a API de Entrega de Conteúdo.

Exemplo: locale=de-AT retorna os campos em alemão austríaco com a sua cadeia de fallback configurada, enquanto locale=* retorna todas as variantes localizadas de cada campo em uma única carga.

Nos bastidores, a API Sync sempre funciona como o modo curinga e inclui todas as configurações regionais, independentemente da configuração regional solicitada; portanto, os sistemas downstream precisam lidar com o conjunto completo de localizações.

A publicação por localidade é uma opção ativável no nível do ambiente, disponível apenas em planos pagos específicos, que permite aos editores publicar ou retirar do ar uma ou mais localidades de uma entrada de forma independente. Ela funciona para a publicação manual no editor de entradas, mas a publicação programada e os lançamentos continuam operando no nível da entrada como um todo.

Com fluxos de trabalho localizados, as etapas e tarefas do fluxo de trabalho agora podem ser direcionadas a configurações regionais específicas; assim, quando a publicação baseada em configuração regional estiver ativada, um bloqueio na configuração regional “Francês” não impedirá mais que você publique a configuração regional “Inglês” separadamente.

As funções dos tradutores podem ser restringidas por localidade na localização em nível de campo, mas, na localização em nível de entrada, muitas vezes é necessário recorrer a soluções alternativas para as permissões de conteúdo, já que, tecnicamente, os tradutores editam entradas diferentes, em vez de localidades diferentes da mesma entrada.

A publicação por localidade não altera o comportamento das APIs, mas sim quais conteúdos são elegíveis para serem entregues. Uma vez ativada, você poderá ver o status (rascunho/publicado/alterado) por localidade na interface do usuário, mas as APIs CDA e Sync continuarão a entregar as versões localizadas que estiverem publicadas no momento para as localidades solicitadas.

Comparativo de ferramentas de tradução para o Contentful

O Contentful oferece duas opções gerais para tradução:

1. Mantenha as traduções dentro do Contentful conectando uma ferramenta que sincronize o texto traduzido de volta aos seus campos localizados (por exemplo, Lokalise, Crowdin, Phrase) e utilizando os próprios recursos de tradução e localização do Contentful para coordenar o fluxo de trabalho.
2. Mantenha as traduções fora do Contentful usando uma ferramenta de tradução de sites como Weglot , que funciona no site renderizado, armazena as traduções em sua própria interface de usuário na nuvem e não precisa gravar em seu modelo de conteúdo.

Veja a seguir uma comparação entre as principais opções:

‍

Em resumo:

• O Lokalise, o Crowdin e o Phrase extraem o conteúdo do Contentful, traduzem-no e, em seguida, enviam as traduções de volta para os campos localizados por meio de seus aplicativos. O Contentful continua sendo a fonte de referência, e seu front-end simplesmente lê os campos localizados como de costume.
• Weglot e traduz o site gerado (HTML) e armazena as traduções na nuvem, e não nos campos do Contentful. Em seguida, ele disponibiliza as versões traduzidas em URLs de idiomas distintos, com o SEO gerenciado automaticamente.

Como o Contentful armazena apenas o texto original, Weglot lançamentos mais rápidos, reduz a carga sobre o seu modelo de conteúdo e simplifica a gestão em geral.

{{ai-banner}}

Escolhendo a abordagem de localização certa para sua equipe

Escolha uma estratégia do Contentful que se adapte à forma como suas equipes realmente trabalham. Utilize a localização no nível do campo para a maior parte do conteúdo compartilhado. Recorra à localização no nível da entrada, do tipo de conteúdo ou mesmo do espaço apenas quando as regiões precisarem de verdadeira liberdade editorial, ou quando questões de conformidade e conteúdos regionais muito distintos tornarem difícil manter um modelo compartilhado.

Depois de definir isso, a próxima decisão é onde armazenar as traduções. Se o Contentful for o seu hub compartilhado para dispositivos móveis, APIs e várias interfaces de usuário, você pode manter todas as versões em cada entrada.

Se você precisa principalmente de um site desenvolvido com o Contentful disponível em vários idiomas, uma camada de tradução front-end costuma ser mais rápida e muito mais leve em termos de arquitetura. Weglot perfeitamente nessa abordagem, pois traduz o site já renderizado, cria URLs específicas para cada idioma e lida com o SEO multilíngue sem alterar o seu modelo de conteúdo existente.

Pronto para ver como isso fica na sua própria infraestrutura? Comece hoje mesmo um Weglot gratuito de 14 dias Weglot e lance um site multilíngue no Contentful em poucos minutos.