Braze (TMS)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Disponibile per

Piani Team, Professional, Business ed Enterprise

Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.

Disponibile per

Piani Ultimate ed Enterprise (Legacy)

Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.

Il connettore Braze consente agli esperti di marketing di localizzare campagne, canvas e modelli Braze senza lavoro manuale. Collegando Phrase TMS all'API multilingue di Braze, i contenuti multilingue vengono scambiati automaticamente tra le due piattaforme per la traduzione.

Questa integrazione è progettata per gli esperti di marketing, non per gli sviluppatori. Elimina la necessità di modifiche al codice, esportazioni di file o duplicazione dei modelli.

Il connettore include una funzionalità di mappatura linguistica unificata che allinea automaticamente i codici lingua di Phrase TMS con quelli di Braze. Le variazioni comuni come le differenze di maiuscole/minuscole (de-DE vs de-de) e i formati dei separatori (en-US vs en_us) vengono risolte automaticamente, riducendo la configurazione manuale. Gli amministratori possono definire mappature personalizzate nelle impostazioni del connettore per impostazioni locali non standard o univoche, che avranno la priorità sulla mappatura automatica.

Gli avvisi automatici possono essere configurati in modo che i traduttori vengano avvisati quando arriva un nuovo lavoro e gli esperti di marketing ricevano una notifica al completamento di tale lavoro.

Braze richiede che ogni traduzione abbia un ID tag univoco.

Guida alla localizzazione di Braze

Nota

A causa dei miglioramenti che vengono apportati regolarmente, l'interfaccia utente potrebbe apparire leggermente diversa da quella mostrata nel video.

Struttura dei contenuti di Braze

Modelli:

Layout di messaggi riutilizzabili (e-mail, messaggi in-app o notifiche push) che fungono da base per le tue campagne e i tuoi canvas.
Campagne:

Utilizzate per inviare messaggi mirati al pubblico attraverso uno o più canali (email, push o in-app). Le campagne possono essere una tantum, ricorrenti o attivate da eventi, supportando una comunicazione multicanale personalizzata.
Canvas:

Percorsi cliente a più fasi che inviano messaggi attraverso molteplici canali utilizzando trigger, segmenti di pubblico e logiche temporali. I canvas sono ideali per orchestrare flussi di coinvolgimento automatizzati basati sul comportamento.
Blocchi di contenuto:

Frammenti di contenuto riutilizzabili che possono essere incorporati in modelli, campagne e canvas.

Casi d'uso di localizzazione

Localizzazione a livello di modello

Localizzare i modelli prima di collegarli a campagne o canvas.

Limitazioni:
- Supporta solo modelli HTML per email, push e in-app (non drag-and-drop).
- I modelli drag-and-drop sono supportati tramite Campagne e Canvas.
Localizzazione a livello di campagna e canvas

Quando si lavora in Campagne o canvas, è possibile localizzare ulteriori tipi di messaggi, inclusi i modelli drag-and-drop.

Le Campagne e i canvas fungono da livello di distribuzione. Sebbene i modelli drag-and-drop non possano essere localizzati direttamente dalla Libreria modelli, possono essere localizzati quando vengono utilizzati all'interno di Campagne o canvas. Ciò significa che tutti i tipi di messaggi possono essere tradotti al livello appropriato.

Limitazioni

Limitazione	Descrizione	Soluzione alternativa
Modelli drag-and-drop	Non visibili come modello	Localizzare tramite Campagne o canvas e saranno visibili in Phrase TMS
Mancate corrispondenze di impostazioni locali	Può causare errori di creazione del lavoro	Mantieni i codici delle impostazioni locali coerenti, usando il trattino basso.
Autorizzazioni mancanti	Potrebbe bloccare la sincronizzazione	Assicurati di creare nuove chiavi API, con accesso fornito per Template, Canvas e Campaign

Casi d'uso

Ci sono una serie di casi d'uso per il connettore:

I project manager possono aggiungere file direttamente ai progetti da un archivio online.
Configura il portale richieste per consentire ai richiedenti di aggiungere file alle richieste direttamente dall'archivio online.
Usa la creazione di progetti automatizzata (APC) per creare automaticamente nuovi progetti quando si rileva una modifica nel contenuto per i documenti o le cartelle monitorati.
- Solo i contenuti traducibili nuovi o aggiornati attivano l'APC; l'esportazione di traduzioni o modifiche a contenuti non traducibili non crea nuovi progetti.
L'API del connettore può essere utilizzata per automatizzare i passaggi che verrebbero altrimenti eseguiti manualmente tramite l'interfaccia utente. I webhook possono essere utilizzati per inviare notifiche a sistemi di terze parti in merito a determinati eventi (ad esempio, una modifica dello stato lavoro).

Impostazioni multilingua Braze

Accedi al tuo account Braze.
Vai su API and Identifiers in Impostazioni nella Developer Console.
Seleziona Attiva la allowlist degli IP Braze se prevedi di creare webhook Braze-to-Braze.

Se è richiesta una restrizione:
1. Vai su Modelli nella Developer Console.
2. Apri le opzioni Modelli e seleziona templates.translations.get e templates.translations.update.
Crea una nuova chiave API REST.

Questa chiave è necessaria per la configurazione del connettore.

La chiave API REST è legata all'account utente Braze che l'ha generata.

Assicurati che queste autorizzazioni siano selezionate:
- Modelli
- Canvas
- Campagne
Se era stata generata una chiave per il connettore legacy, questa non funzionerà più.
Copia l'URL dell'endpoint REST di Braze.
Assicurati che le impostazioni locali delle lingue in Impostazioni area di lavoro - Impostazioni locali multilingua siano nel formato standard, con un trattino basso. Trattini o altri formati causeranno errori.
Per tutti i modelli che richiedono la traduzione, assicurati che sia specificata la modalità multilingua con tutte le impostazioni locali richieste.

Impostazioni Phrase TMS

Dalla pagina Impostazioni , scorri verso il basso fino alla sezione Integrazioni.
Fai clic su Connettori.

Si apre la pagina Connettori.
Fai clic su Nuovo connettore.

Si apre la pagina Crea connettore.
Cambia il Tipo in Braze e fornisci un nome per il connettore.
Seleziona l'URL dell'endpoint REST di Braze dall'elenco a discesa.
Fornisci la chiave API REST che si trova in Impostazioni Braze → API e identificatori → Chiavi API.
Fai clic su Test connessione.
- Se l'operazione ha esito positivo, accanto al pulsante Test connessione viene visualizzato un piccolo segno di spunta.
Se il contenuto è contrassegnato per la traduzione, fai clic su Mostra impostazioni opzionali e fornisci gli ID tag.
Se specificato, seleziona una cartella predefinita (possibile solo dopo il salvataggio).
Clicca su Salva.

Il connettore viene aggiunto all'elenco nella pagina Connettori.

Localizzazione di modelli di email HTML

Quando si utilizza l'editor HTML di Braze, il contenuto può essere localizzato direttamente a livello di modello. Questo è perfetto per le email riutilizzabili.

Per localizzare un modello di email HTML, segui questi passaggi:

Da Template - Email Templates - HTML Editor, apri il modello.
Aggiungi i tag di traduzione:
- Racchiudi l'area traducibile nei tag Phrase:
```
{% translation phrase_body %}
...il contenuto della tua e-mail qui...
{% endtranslation %}
```
  Consiglio
  
  Posiziona il tag di apertura sulla prima riga e il tag di chiusura sull'ultima riga dell'editor HTML. Le frasi non devono essere racchiuse singolarmente; il convertitore Phrase analizza automaticamente tutto ciò che si trova tra i due tag, preparandolo per la traduzione nell'area di lavoro di Phrase TMS. La formattazione HTML, i link e lo stile rimangono completamente intatti nella versione localizzata.
- Per tradurre l'oggetto e il preheader, racchiudili singolarmente:
```
{% translation phrase_subject %}Testo dell'oggetto{% endtranslation %}
{% translation phrase_preheader %}Testo del preheader{% endtranslation %}
```
Salva il modello.
Riapri il modello, seleziona Multi-language e scegli le impostazioni locali di origine e di destinazione. Assicurati che le impostazioni locali siano le stesse della configurazione di Phrase.
Salva il modello.
Da Phrase TMS, seleziona Import from Integration - Braze - Templates.

Il modello HTML appare come un lavoro di traduzione.
Traduci e revisiona.
Una volta approvate, esporta le traduzioni su Braze.

Le versioni localizzate appaiono automaticamente sotto le impostazioni locali assegnate. Usa Preview & Test - Multi-language user per verificare la visualizzazione e il layout.

Lavorare con Campaigns e Canvases

Nota

L'anteprima nel contesto non è disponibile nel CAT Editor per i job importati da Campaigns o Canvases. Phrase TMS riceve più e-mail come parte di questi tipi di contenuto e non può unirle in un unico HTML per il rendering, quindi non appare alcuna scheda Anteprima.

Per usare l'anteprima nel contesto, localizza direttamente il modello di e-mail.

Quando si localizza all'interno di Campaigns o Canvases, il flusso di lavoro differisce leggermente. Invece di localizzare un modello HTML autonomo, si lavora su asset di Campaign attivi o bozze che possono includere contenuti drag-and-drop.

Le localizzazioni non provengono dalla libreria di modelli, ma direttamente all'interno di Campaigns o Canvases.
I modelli drag-and-drop diventano localizzabili una volta utilizzati in questi contesti.
Tutti i tipi di messaggio (e-mail, push, in-app) possono essere localizzati se racchiusi tra tag Phrase.

Per lavorare con una Campaign o un Canvas, segui questi passaggi:

Da Campaigns o Canvases, apri l'asset richiesto.
Aggiungi i tag di traduzione:
- Se usi l'editor HTML
  Racchiudi l'area traducibile nei tag Phrase:
  
  {% translation phrase_body %} ...il contenuto della tua e-mail qui... {% endtranslation %}
  
  Consiglio
  
  Posiziona il tag di apertura sulla prima riga e il tag di chiusura sull'ultima riga dell'editor HTML. Le frasi non devono essere racchiuse singolarmente; il Phrase converter analizza automaticamente tutto ciò che si trova tra i due tag, preparandolo per la traduzione nell'area di lavoro di Phrase TMS. La formattazione HTML, i link e lo stile rimangono completamente intatti nella versione localizzata.
  
  Per tradurre l'oggetto e il preheader, racchiudili singolarmente:
  
  {% translation phrase_subject %}Testo dell'oggetto{% endtranslation %} {% translation phrase_preheader %}Testo del preheader{% endtranslation %}
  - Per le e-mail drag-and-drop, aggiungi un blocco Paragraph all'inizio e uno alla fine dell'e-mail. Inserisci il tag di apertura {% translation phrase_body %} nel blocco superiore e il tag di chiusura {% endtranslation %} nel blocco inferiore. Questo copre l'intera e-mail; non è necessario racchiudere ogni frase singolarmente.
Contrassegna per la traduzione

Se l'utilizzo dei tag è configurato a livello di connettore, contrassegna la campagna o il canvas con il tag di traduzione.
Importa in Phrase TMS

In Phrase TMS, vai su Import from Integration - Braze - Campaigns/Canvases. Le campagne contrassegnate con tag appaiono per essere selezionate.

Prima dell'importazione, assicurati che ogni impostazione locale di destinazione sia aggiunta alla campagna o al Canvas in Braze (impostazioni multilingua). Se un'impostazione locale di destinazione manca dall'elemento, l'importazione fallisce con un errore nella cronologia APC, anche quando il formato dell'impostazione locale configurato nel connettore è corretto.
Traduci e revisiona

I linguisti traducono all'interno dell'area di lavoro di Phrase. L'HTML e la formattazione vengono preservati automaticamente.
Esporta e visualizza in anteprima

Una volta terminato, esporta la versione localizzata su Braze. Usa Preview & Test - Multi-language user per alternare le impostazioni locali e confermare.

Braze Legacy (TMS)

Disponibile per

Piani Team, Professional, Business ed Enterprise

Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.

Disponibile per

Piani Ultimate ed Enterprise (Legacy)

Mettiti in contatto con il reparto vendite per dubbi relativi alle licenze.

Importante

Il connettore Braze (Legacy) sarà deprecato il 30 novembre 2026. È possibile creare nuove istanze di questo connettore fino al 17 agosto 2026. Esegui la migrazione al nuovo connettore prima della data di deprecazione.

Consulta Legacy Connector Deprecation per una guida completa alla migrazione.

Con l'integrazione di Phrase TMS per Braze, è possibile aumentare il coinvolgimento dei clienti e favorire la crescita in nuovi mercati con una localizzazione senza interruzioni. L'integrazione consente agli utenti di Braze di tradurre modelli di e-mail e blocchi di contenuto.

Elementi di contenuto traducibili:

Modelli di e-mail creati con l'editor HTML
Blocchi di contenuto

Nota

A causa dei miglioramenti che vengono apportati regolarmente, l'interfaccia utente potrebbe apparire leggermente diversa da quella mostrata nel video.

Casi d'uso

Ci sono una serie di casi d'uso per il connettore:

I project manager possono aggiungere file direttamente ai progetti da un archivio online.
Configura il portale richieste per consentire ai richiedenti di aggiungere file alle richieste direttamente dall'archivio online.
Usa la creazione di progetti automatizzata (APC) per creare automaticamente nuovi progetti quando viene rilevata una modifica nel contenuto dei documenti monitorati o di una cartella.
- Solo i contenuti traducibili nuovi o aggiornati attivano l'APC; l'esportazione di traduzioni o modifiche a contenuti non traducibili non creano nuovi progetti.
L'API del connettore può essere utilizzata per automatizzare i passaggi che verrebbero altrimenti eseguiti manualmente tramite l'interfaccia utente. I webhook possono essere utilizzati per inviare notifiche a sistemi di terze parti in merito a determinati eventi (ad esempio, una modifica dello stato lavoro).

Impostazioni Braze

Accedi al tuo account Braze.
Vai alla Console sviluppatore e fai clic su Impostazioni API.
Crea una nuova Rest API Key.

Questa chiave è necessaria per la configurazione del connettore.
Copia l'URL dell'endpoint REST di Braze.

Impostazioni Phrase TMS

Dalla pagina Impostazioni , scorri verso il basso fino alla sezione Integrazioni.
Fai clic su Connettori.

Si apre la pagina Connettori.
Fai clic su Nuovo connettore.

Si apre la pagina Crea connettore.
Cambia il Tipo in Braze e fornisci un nome per il connettore.
Seleziona l'URL dell'endpoint REST di Braze dall'elenco a discesa.
Fornisci la chiave API REST che si trova in Impostazioni Braze → API e identificatori → Chiavi API.
Fai clic su Test connessione.
- Se l'operazione ha esito positivo, accanto al pulsante Test connessione viene visualizzato un piccolo segno di spunta.
Se il contenuto è contrassegnato per la traduzione, fai clic su Mostra impostazioni opzionali e fornisci gli ID tag.
Se specificato, seleziona una cartella predefinita (disponibile solo dopo il salvataggio).
Clicca su Salva.

Il connettore viene aggiunto all'elenco nella pagina Connettori.