TransPerfect
A TransPerfect fornece tecnologia de idiomas e localização por meio do GlobalLink. O GlobalLink Connect se integra à Braze para que você possa navegar pelo conteúdo compatível da Braze, enviá-lo para tradução no GlobalLink e gravar as traduções concluídas de volta na Braze por meio da API de Traduções da Braze.
Essa integração é mantida pela TransPerfect.
Sobre a integração
Depois de configurar o GlobalLink Connect para a sua instância da Braze, os usuários navegam pelo conteúdo compatível da Braze no GlobalLink Connect e o enviam para tradução por meio da plataforma GlobalLink. O conector:
- Solicita conteúdo traduzível da Braze por meio da API de Traduções
- Extrai o conteúdo delimitado pelas tags de tradução da Braze
- Envia uma solicitação de tradução para o GlobalLink TMS
- Atualiza a Braze com o conteúdo traduzido após a conclusão do fluxo de trabalho do GlobalLink
Somente o conteúdo exposto por meio da API de Traduções da Braze está disponível para tradução.
Conteúdo compatível
Na versão atual, o GlobalLink Connect oferece suporte à tradução de:
- Modelos de e-mail
- Content Blocks
- Campaigns (apenas canal de e-mail)
O conector não extrai conteúdo de push, mensagens no app ou SMS.
Pré-requisitos
Antes de começar, você precisa do seguinte:
| Pré-requisito | Descrição |
|---|---|
| Uma conta TransPerfect GlobalLink | É necessário ter uma conta do GlobalLink Connect para usar essa integração. Entre em contato com a TransPerfect para começar. |
| Uma chave da API REST da Braze | Uma chave da API REST da Braze com as seguintes permissões: - campaigns.list- campaigns.translations.get- campaigns.translations.update- content_blocks.info- content_blocks.list- content_blocks.translations.get- content_blocks.translations.update- templates.email.info- templates.email.list- templates.translations.get- templates.translations.updateCrie essa chave no dashboard da Braze em Configurações > APIs e identificadores > Chaves de API. Para saber mais, consulte Criando chaves da API REST. |
| Um endpoint REST da Braze | A URL do seu endpoint REST. O endpoint depende da URL da Braze para a sua instância. |
| Configurações multilíngues da Braze | As localidades de origem e destino devem ser configuradas na Braze em Configurações > Configurações de localização. Para saber mais, consulte Configurações multilíngues. |
Integração
Etapa 1: Criar uma chave da API REST da Braze
- Na Braze, acesse Configurações > APIs e identificadores > Chaves de API.
- Selecione Criar chave de API.
- Insira um nome para a chave (por exemplo,
GlobalLink). - Selecione as permissões listadas em Pré-requisitos.
- Crie a chave e copie o identificador da chave de API e a URL do endpoint REST da sua instância (por exemplo,
https://rest.iad-03.braze.com).
O GlobalLink Connect usa o endpoint REST para o campo rest-api-url e a chave de API para o campo braze-api-key.
Etapa 2: Definir as configurações de localização na Braze
- Na Braze, acesse Configurações > Configurações de localização.
- Selecione Adicionar localidade e adicione cada idioma de origem e destino que deseja suportar. Para saber mais, consulte Configurações multilíngues.
- Anote o nome do idioma e o identificador da localidade para cada localidade. Você fornecerá esses valores à TransPerfect para que o GlobalLink Connect possa mapear as localidades de origem e destino.
Etapa 3: Configurar o conector do GlobalLink Connect
Forneça os seguintes valores à sua equipe da TransPerfect ou do GlobalLink para que eles possam concluir a configuração do conector da Braze:
| Campo de configuração | Descrição |
|---|---|
rest-api-url |
Endpoint da API REST da sua instância da Braze. |
braze-api-key |
Chave da API REST criada na Etapa 1. |
source-locale |
Nome, código e identificador da localidade de origem nas configurações de localização da Braze. |
target-locale |
Nomes, códigos e identificadores das localidades de destino nas configurações de localização da Braze. |
filename-configuration |
Como o GlobalLink nomeia os arquivos enviados para tradução: name_id (nome e ID), name (somente nome) ou ID (somente ID). |
preview-enabled |
true ou false para ativar ou desativar a prévia. |
include-archived-campaigns |
true ou false para incluir ou excluir Campaigns arquivadas. |
Para ver todos os detalhes da configuração do conector, consulte a documentação do GlobalLink Connect para Braze.
Etapa 4: Marcar o conteúdo para tradução na Braze
Delimite o conteúdo que você deseja traduzir com tags de tradução da Braze para que a API de Traduções possa expô-lo ao GlobalLink Connect. Para saber mais, consulte Mensagens multilíngues.
Ative as localidades correspondentes no modelo de e-mail, Content Block ou mensagem de Campaign antes de enviar o conteúdo para tradução.
Etapa 5: Enviar o conteúdo e retornar as traduções
- No GlobalLink Connect, navegue pelo conteúdo compatível da Braze (modelos de e-mail, Content Blocks e mensagens de e-mail de Campaigns).
- Envie o conteúdo para tradução por meio da plataforma GlobalLink.
- Após o GlobalLink TMS concluir a tradução e a revisão, o GlobalLink Connect atualiza a Braze por meio da API de Traduções.
- Na Braze, abra a mensagem, acesse Prévia e teste e selecione Usuário multilíngue para confirmar as traduções. Para saber mais, consulte Prévia de personalização.
Considerações
- O conector suporta apenas o canal de e-mail. Push, mensagens no app e SMS não estão disponíveis para extração na versão atual.
- Somente o conteúdo delimitado por tags de tradução e exposto por meio da API de Traduções da Braze aparece no GlobalLink Connect.