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 interventi manuali. 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 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 tra maiuscole e minuscole (de-DE vs de-de) e i formati dei separatori (en-US vs en_us), vengono gestite automaticamente, riducendo la configurazione manuale. Gli amministratori possono definire mappature personalizzate nelle impostazioni del connettore per i codici delle impostazioni locali non standard o specifici, 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 del 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 (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 e consentono una comunicazione personalizzata e multicanale.
Canvas:

Percorsi dei clienti articolati in più fasi, che inviano messaggi su diversi canali in base a eventi di attivazione, segmenti di pubblico e tempistiche. 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 della localizzazione

Localizzazione a livello di modello

Localizza 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 lavori su campagne o canvas, puoi localizzare anche altri tipi di messaggi, inclusi i modelli drag-and-drop.

Le campagne e i canvas costituiscono il livello di distribuzione. I modelli drag-and-drop non possono essere localizzati direttamente dalla Libreria modelli, ma possono esserlo quando vengono utilizzati in 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 modelli	Localizzali tramite campagne o canvas: saranno visibili in Phrase TMS
Incongruenze tra i codici locali	Possono causare errori nella creazione dei lavori	Usa i trattini bassi in modo coerente nei codici locali
Autorizzazioni mancanti	Possono bloccare la sincronizzazione	Crea nuove chiavi API e assicurati che abbiano accesso a 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 per i richiedenti per consentire loro 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 dei documenti monitorati o di una cartella.
- Solo i contenuti traducibili nuovi o aggiornati attivano l'APC; l'esportazione di traduzioni e le 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 multilingua di 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 è legata all'account utente Braze che l'ha generata.

Assicurati che queste autorizzazioni siano selezionate:
- Modelli
- Canvas
- Campagne
Le chiavi generate per il connettore legacy non funzioneranno più.
Copia l'URL dell'endpoint REST di Braze.
Assicurati che le impostazioni locali delle lingue in Impostazioni area di lavoro - Impostazioni locali multilingue siano nel formato standard con un trattino basso. Trattini o altri formati causeranno errori.
Per tutti i modelli, le campagne e i passaggi dei canvas che richiedono una traduzione, assicurati che la funzionalità multilingue sia configurata per tutte le impostazioni locali richieste, inclusa quella di origine.

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.
Imposta Tipo su Braze e assegna un nome al 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.
Fai clic su Mostra impostazioni opzionali per configurare opzioni aggiuntive:
- Tag per la traduzione
  
  Fornisci gli ID dei tag per i contenuti da importare. I tag devono corrispondere a quelli presenti in Braze.
- Mappatura delle lingue
  
  Fai clic su Aggiungi mappatura lingua per mappare le lingue di Braze alle lingue di TMS.
  
  Ogni lingua di Phrase può essere associata a un solo codice locale di Braze alla volta. Se due codici Braze (ad esempio da e visitor_da) sono entrambi mappati sulla stessa lingua di Phrase, il connettore seleziona automaticamente uno dei codici e non c'è modo di controllare quale codice venga scelto. Non è possibile creare il lavoro per il codice non selezionato e il connettore registra un errore per quella lingua.
  
  Per creare un lavoro, l'impostazione locale di origine e tutte quelle di destinazione configurate nel connettore o nella mappatura delle lingue APC devono essere già presenti nel singolo elemento di un canvas o di una campagna Braze. Configurare un'impostazione locale a livello del connettore o di APC non è sufficiente. Se in un canvas manca un'impostazione locale, l'importazione fallisce e viene visualizzato un errore che indica che l'impostazione locale di origine o di destinazione non è configurata nell'elemento Braze. Aggiungi le impostazioni locali mancanti direttamente al canvas in Braze prima di riprovare l'importazione.
- Filtro di importazione dei contenuti recenti
  
  Imposta numero massimo di giorni dall'ultimo aggiornamento per importare solo i contenuti aggiornati negli ultimi giorni indicati. Imposta il valore su 0 per importare tutti i contenuti, indipendentemente da quanto siano datati.
Fai clic 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. È ideale 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:
- Racchiudi l'area traducibile tra i 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 tra tag; 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 collegamenti e lo stile rimangono completamente intatti nella versione localizzata.
- Per tradurre l'oggetto e il preheader, racchiudili singolarmente tra tag:
```
{% translation phrase_subject %}Testo dell'oggetto{% endtranslation %}
{% translation phrase_preheader %}Testo del preheader{% endtranslation %}
```
Salva il modello.
Riapri il modello, seleziona Multilingua 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.
In Phrase TMS, seleziona Importa da integrazione - Braze - Modelli.

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

Le versioni localizzate vengono visualizzate automaticamente nelle rispettive impostazioni locali. Usa Anteprima e test - Utente multilingua 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. Per questi tipi di contenuto, Phrase TMS riceve più email e non può unirle in un unico documento HTML da visualizzare; per questo la scheda Anteprima non è disponibile.

Per usare l'anteprima contestuale, 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.

La localizzazione avviene direttamente nelle campagne o nei canvas, non nella libreria dei modelli.
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 tra tag Phrase.

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

Da Campagne o Canvas, apri l'asset richiesto.
Aggiungi i tag di traduzione:
- Se usi l'editor HTML
  Racchiudi l'area traducibile tra i 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 collegamenti e lo stile rimangono completamente intatti nella versione localizzata.
  
  Per tradurre l'oggetto e il preheader, racchiudili singolarmente tra i tag:
  
  {% translation phrase_subject %}Testo dell'oggetto{% endtranslation %} {% translation phrase_preheader %}Testo del preheader{% endtranslation %}
  - Per le email drag-and-drop, aggiungi un blocco Paragrafo in alto e uno in basso nell'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 tra i tag 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 con il tag vengono visualizzate e possono essere selezionate.

Prima dell'importazione, assicurati che l'impostazione locale di origine e tutte quelle di destinazione siano aggiunte alla campagna o al canvas in Braze (impostazioni multilingua) e che l'impostazione locale di origine contenga il contenuto di origine. Se nell'elemento manca un'impostazione locale di destinazione, l'importazione non riesce e viene segnalato un errore nella cronologia APC, anche se il formato dell'impostazione locale configurato nel connettore è corretto. Se l'impostazione locale di origine manca o è vuota, il messaggio viene omesso dal lavoro senza errori.
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

Al termine, esporta la versione localizzata in Braze. Usa Anteprima e test - Utente multilingua per passare da un'impostazione locale all'altra e verificare il risultato.

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. Nuove istanze di questo connettore possono essere create 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.

L'integrazione di Phrase TMS con Braze consente di aumentare il coinvolgimento dei clienti e favorire la crescita in nuovi mercati grazie a una localizzazione senza intoppi. 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 dei richiedenti 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 di documenti monitorati o di una cartella monitorata.
- Solo i contenuti traducibili nuovi o aggiornati attivano l'APC; l'esportazione di traduzioni o le 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 chiave API REST.

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.
Imposta Tipo su Braze e assegna un nome al 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.
Fai clic su Mostra impostazioni opzionali per configurare opzioni aggiuntive:
- Tag per la traduzione
  
  Fornisci gli ID dei tag per i contenuti da importare. I tag devono corrispondere a quelli presenti in Braze.
- Mappatura delle lingue
  
  Fai clic su Aggiungi mappatura lingua per associare le lingue di Braze a quelle del TMS.
  
  Ogni lingua di Phrase può essere mappata su un solo codice locale di Braze alla volta. Se due codici Braze (ad esempio da e visitor_da) sono entrambi mappati sulla stessa lingua di Phrase, il connettore seleziona automaticamente uno dei codici e non c'è modo di controllare quale codice venga scelto. Il processo per il codice non selezionato non viene creato e il connettore registra un errore per quella lingua.
  
  Per creare un processo, l'impostazione locale di origine e tutte quelle di destinazione configurate nel connettore o nella mappatura delle lingue APC devono già essere presenti nel singolo canvas o elemento di campagna di Braze. Configurare un'impostazione locale a livello di connettore o APC non è sufficiente. Se in un canvas manca un'impostazione locale, l'importazione non va a buon fine e viene visualizzato un errore che indica che l'impostazione locale di origine o di destinazione non è configurata nell'elemento Braze. Aggiungi le impostazioni locali mancanti direttamente al canvas in Braze prima di riprovare l'importazione.
- Filtro di importazione dei contenuti recenti
  
  Imposta numero massimo di giorni dall'ultimo aggiornamento per importare solo i contenuti aggiornati entro il numero di giorni specificato. Imposta il valore su 0 per importare tutti i contenuti, indipendentemente dalla data dell'ultimo aggiornamento.
Fai clic su Salva.

Il connettore viene aggiunto all'elenco nella pagina Connettori.