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 ai marketer di localizzare campagne, canvas e modelli Braze senza lavoro manuale. Collegando Phrase TMS all'API multilingua di Braze, i contenuti multilingue vengono scambiati automaticamente tra le due piattaforme per la traduzione.

Questa integrazione è progettata per i marketer, non per gli sviluppatori. Elimina la necessità di modifiche al codice, esportazioni di file o duplicazione di 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 codici locali non standard o univoci, 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 i marketer ricevano una notifica al completamento del lavoro stesso.

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 (email, 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 singole, ricorrenti o attivate da eventi, supportando una comunicazione personalizzata e multicanale.
Canvas:

Percorsi cliente a più fasi che inviano messaggi su più 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 tipi di messaggio aggiuntivi, 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 messaggio possono essere tradotti al livello appropriato.

Limitazioni

Limitazione	Descrizione	Soluzione alternativa
Modelli drag-and-drop	Non visibile come modello	Localizzare tramite campagne o Canvas e saranno visibili in Phrase TMS
Mancate corrispondenze di impostazioni locali	Possono causare errori di creazione del processo	Mantieni i codici delle impostazioni locali coerenti con i trattini bassi
Autorizzazioni mancanti	Potrebbe bloccare la sincronizzazione	Assicurati di creare nuove chiavi API, con accesso fornito per modelli, canvas e campagne.

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 submitter portal per consentire ai submitter 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 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 Settings nella Developer Console.
Seleziona Opt in to Braze IP allowlisting if you plan to make Braze-to-Braze webhooks.

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

Questa chiave è necessaria per la configurazione del connettore.

La chiave API REST è collegata 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 delle 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 dei tag.
Se specificato, seleziona una cartella predefinita (possibile solo dopo il salvataggio).
Clicca su Salva.

Il connettore viene aggiunto all'elenco nella pagina Connettori.

Elimina un connettore

Per eliminare un connettore:

Dalla pagina Integrazioni, seleziona il connettore da eliminare.
Fai clic su Elimina.

Si apre la finestra Elimina connettore.
Digita "delete" e fai clic su Elimina.

Il connettore viene eliminato e viene visualizzato l'elenco dei connettori.

Nota

Un connettore non può essere eliminato mentre è ancora collegato a lavori incompleti in un progetto, inclusi i lavori presenti nel Cestino. Il tentativo di eliminare tale connettore restituisce un errore "Impossibile eliminare il connettore".

Risoluzione: Apri il progetto associato al connettore e completa o elimina tutti i lavori rimanenti. Vai su Impostazioni/Cestino e svuotalo per rimuovere tutti i lavori ancora collegati al connettore. Riprova a eliminare il connettore.

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 Modello - Modelli email - Editor HTML, apri il modello.
Aggiungi i tag di traduzione:
- Avvolgi l'area traducibile nei tag Phrase:
```
{% translation phrase_body %}
...il contenuto della tua email 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 Oggetto e 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 lingue di origine e di destinazione. Assicurati che le lingue 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 rispettive lingue. Usa Preview & Test - Multi-language user per verificare la visualizzazione e il layout.

Lavorare con Campagne e Canvas

Nota

L'anteprima contestuale non è disponibile nell'editor CAT per i lavori importati da Campagne o Canvas. Phrase TMS riceve più email 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 utilizzare l'anteprima nel contesto, localizza direttamente il modello di email.

Quando si localizza all'interno di campagne o canvas, il flusso di lavoro differisce leggermente. Invece di localizzare un modello HTML autonomo, si lavora su risorse di campagna attive o in bozza che possono includere contenuti drag-and-drop.

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

Per lavorare con una campagna o un canvas, segui questi passaggi:

Da Campagne o canvas, apri la risorsa richiesta.
Aggiungi i tag di traduzione:
- Se utilizzi l'editor HTML
  Avvolgi l'area traducibile nei tag Phrase:
  
  {% translation phrase_body %} ...il contenuto della tua email 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 di frasi 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 Oggetto e Preheader, racchiudili singolarmente:
  
  {% translation phrase_subject %}Testo dell'oggetto{% endtranslation %} {% translation phrase_preheader %}Testo del preheader{% endtranslation %}
  - Per le email Drag-and-Drop, aggiungi un blocco Paragrafo all'inizio e uno alla fine dell'email. Inserisci il tag di apertura {% translation phrase_body %} nel blocco superiore e il tag di chiusura {% endtranslation %} nel blocco inferiore. Questo copre l'intera email; 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 Importa da integrazione - Braze - Campagne/Canvas. Le campagne contrassegnate appaiono per la selezione.
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 Anteprima e test - Utente multilingue 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 Deprecazione del connettore legacy 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 email e blocchi di contenuto.

Elementi di contenuto traducibili:

Modelli di email 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 richiedente 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 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 Braze

Accedi al tuo account Braze.
Vai alla Console sviluppatori 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 dei tag.
Se specificato, seleziona una cartella predefinita (possibile solo dopo il salvataggio).
Clicca su Salva.

Il connettore viene aggiunto all'elenco nella pagina Connettori.

Elimina un connettore

Per eliminare un connettore:

Dalla pagina Integrazioni, seleziona il connettore da eliminare.
Fai clic su Elimina.

Si apre la finestra Elimina connettore.
Digita "delete" e fai clic su Delete.

Il connettore viene eliminato e viene visualizzato l'elenco dei connettori.

Nota