Integrazioni

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, il contenuto multilingue viene scambiato automaticamente tra entrambe le 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 di modelli.

Il connettore include una funzionalità di mappatura della lingua unificata che allinea automaticamente i codici lingua di Phrase TMS con i codici lingua 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 di impostazioni locali non standard o univoci, che avranno la priorità sulla mappatura automatica.

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

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 del contenuto Braze

  • Modelli:

    Layout di messaggi riutilizzabili—e-mail, messaggi in-app o notifiche push—che fungono da base per le tue campagne e canvas.

  • Campagne:

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

  • Canvas:

    Percorsi cliente a più passaggi che inviano messaggi attraverso più canali utilizzando trigger, segmenti di pubblico e logica temporale. 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 delle impostazioni locali

  • Localizzazione a livello di modello

    Localizzare i modelli prima di collegarli a campagne o canvas.

    Limitazioni:

    • Supporta solo modelli HTML per e-mail, 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 usati 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

Mancata corrispondenza delle impostazioni locali

Può causare errori di creazione del lavoro

Mantieni i codici locali coerenti utilizzando il trattino basso.

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 richiedenti di aggiungere file alle richieste direttamente dall'archivio online.

  • Usa automated project creation (APC) per far sì che nuovi progetti vengano creati automaticamente quando viene rilevata una modifica nel contenuto per i documenti monitorati o una cartella.

    • Solo il contenuto traducibile nuovo o aggiornato attiva l'APC; l'esportazione di traduzioni o modifiche al contenuto non traducibile 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 multilingue di Braze

  1. Accedi al tuo account Braze.

  2. Vai su API e identificatori in Impostazioni nella Console sviluppatore.

  3. Seleziona Opt in to Braze IP allowlisting if you plan to make Braze-to-Braze webhooks.

    Se è richiesta una restrizione:

    1. Vai su Modelli nella Console sviluppatore.

    2. Apri le opzioni Modelli e seleziona templates.translations.get e templates.translations.update.

  4. Crea una nuova chiave API REST.

    Questa chiave è necessaria per la configurazione del connettore.

    Assicurati che queste autorizzazioni siano selezionate:

    • Modelli

    • Canvas

    • Campagne

    Se era stata generata una chiave per il connettore Legacy, questa non funzionerà più.

  5. Copia l'URL dell'endpoint REST di Braze.

  6. Assicurati che i codici locali nelle Impostazioni area di lavoro - Impostazioni locali multilingua siano nel formato standard, con un trattino basso. Trattini o altri formati causeranno errori.

  7. Per tutti i modelli che richiedono traduzione, assicurati che il multilingua sia specificato con tutte le impostazioni locali richieste.

Impostazioni Phrase TMS

  1. Dalla pagina Setup_gear.png Impostazioni, scorri verso il basso fino alla sezione Integrazioni.

  2. Fai clic su Connettori.

    Si apre la pagina Connettori.

  3. Fare clic su Nuovo connettore.

    Si apre la pagina Crea connettore.

  4. Modificare il Tipo in Braze e fornire un nome per il connettore.

  5. Selezionare l'URL dell'endpoint REST di Braze dall'elenco a discesa.

  6. Fornire la chiave API REST trovata in Impostazioni Braze → API e identificatori → Chiavi API.

  7. Fai clic su Test connessione.

    • Se l'operazione ha esito positivo, viene visualizzato un piccolo segno di spunta accanto al Test connessione.

  8. Se il contenuto è contrassegnato per la traduzione, fare clic su Mostra impostazioni facoltative e fornire gli ID tag.

  9. Se specificato, selezionare una cartella predefinita (possibile solo dopo il salvataggio).

  10. Clicca su Salva.

    Il connettore viene aggiunto all'elenco nella pagina Connettori.

Elimina un connettore

Per eliminare un connettore:

  1. Dalla pagina Integrazioni, selezionare il connettore da eliminare.

  2. Fare clic su Elimina.

    Si apre la finestra Elimina connettore.

  3. 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 eventuali lavori rimanenti. Vai su Impostazioni/Cestino e svuotalo per rimuovere eventuali lavori ancora collegati al connettore. Riprova a eliminare il connettore.

Localizzazione di modelli di e-mail HTML

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

Per localizzare un modello di e-mail HTML, segui questi passaggi:

  1. Da Template - Email Templates - HTML Editor, apri il template.

  2. Aggiungi i tag di traduzione:

    • Avvolgi l'area traducibile nei tag Phrase:

      {% translation phrase_body %}
      ...il tuo contenuto e-mail qui...
      {% endtranslation %}

      Consiglio

      Posiziona il tag di apertura sulla prima riga e il tag di chiusura sull'ultima riga dell'editor. Le frasi non devono essere avvolte singolarmente; il convertitore Phrase analizza automaticamente tutto ciò che si trova tra i due tag, preparandolo per la traduzione nell'area di lavoro Phrase TMS. La formattazione HTML, i collegamenti e lo stile rimangono completamente intatti nella versione localizzata.

    • Per tradurre oggetto e Preheader, avvolgili singolarmente:

      {% translation phrase_subject %}Subject text{% endtranslation %}
      {% translation phrase_preheader %}Preheader text{% endtranslation %}
      
  3. Salva il modello.

  4. Riapri il modello e seleziona Multi-language e scegli le lingue di origine e destinazione. Assicurati che le lingue siano le stesse della configurazione Phrase.

  5. Salva il modello.

  6. Da Phrase TMS, seleziona Import from Integration - Braze - Templates.

    Il modello HTML appare come un lavoro di traduzione.

  7. Traduci e revisiona.

  8. Una volta approvato, esporta le traduzioni su Braze.

    Le versioni localizzate appaiono automaticamente sotto le loro lingue assegnate. Usa Preview & Test - utente multilingua per verificare la visualizzazione e il layout.

Lavorare con campagne e Canvas

Nota

L'anteprima nel contesto non è disponibile nel CAT Editor per i lavori importati da campagne o Canvas. Phrase 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, localizzare invece direttamente il modello di e-mail.

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 contenuto 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 usati in questi contesti.

  • Tutti i tipi di messaggio (e-mail, push, in-app) possono essere localizzati se racchiusi con tag Phrase.

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

  1. Da Campagne o Canvas, apri l'asset richiesto.

  2. Aggiungi i tag di traduzione:

    • Se usi l'editor HTML

      • Avvolgi l'area traducibile nei tag Phrase:

        {% translation phrase_body %}
        ...il tuo contenuto e-mail qui...
        {% endtranslation %}

        Consiglio

        Posiziona il tag di apertura sulla prima riga e il tag di chiusura sull'ultima riga dell'editor. Le frasi non devono essere avvolte singolarmente; il convertitore Phrase analizza automaticamente tutto ciò che si trova tra i due tag, preparandolo per la traduzione nell'area di lavoro Phrase TMS. La formattazione HTML, i collegamenti e lo stile rimangono completamente intatti nella versione localizzata.

      • Per tradurre oggetto e Preheader, avvolgili singolarmente:

        {% translation phrase_subject %}Subject text{% endtranslation %}
        {% translation phrase_preheader %}Preheader text{% endtranslation %}
        
      • Per le e-mail drag-and-drop, aggiungi un blocco Paragraph all'inizio e uno alla fine dell'e-mail. Posiziona 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.

  3. Contrassegna per la traduzione

    Se l'uso del tag è configurato a livello di connettore, contrassegna la campagna o il canvas con il tag di traduzione.

  4. Importa in Phrase TMS

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

  5. Traduci e revisiona.

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

  6. Esporta e visualizza l'anteprima

    Una volta terminato, esporta la versione localizzata nuovamente su Braze. Usa Preview & Test - utente multilingua per cambiare lingua 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. Nuove istanze di questo connettore possono essere create fino al 17 agosto 2026. Migra al nuovo connettore prima della data di deprecazione.

Consulta Legacy Connector Deprecation per una guida completa alla migrazione.

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

Elementi di contenuto traducibili:

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 submitter portal per consentire ai submitter di aggiungere file alle richieste direttamente dall'archivio online.

  • Usa creazione di progetti automatizzata (APC) per far sì che nuovi progetti vengano creati automaticamente quando viene rilevata una modifica nel contenuto per i documenti monitorati o una cartella.

    • Solo il contenuto traducibile nuovo o aggiornato attiva l'APC; l'esportazione di traduzioni o modifiche al contenuto non traducibile 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

  1. Accedi al tuo account Braze.

  2. Vai alla Developer Console e fai clic su Impostazioni API.

  3. Crea una nuova chiave API REST.

    Questa chiave è necessaria per la configurazione del connettore.

  4. Copia l'URL dell'endpoint REST di Braze.

Impostazioni Phrase TMS

  1. Dalla pagina Setup_gear.png Impostazioni, scorri verso il basso fino alla sezione Integrazioni.

  2. Fai clic su Connettori.

    Si apre la pagina Connettori.

  3. Fare clic su Nuovo connettore.

    Si apre la pagina Crea connettore.

  4. Modificare il Tipo in Braze e fornire un nome per il connettore.

  5. Selezionare l'URL dell'endpoint REST di Braze dall'elenco a discesa.

  6. Fornire la chiave API REST trovata in Impostazioni Braze → API e identificatori → Chiavi API.

  7. Fai clic su Test connessione.

    • Se l'operazione ha esito positivo, viene visualizzato un piccolo segno di spunta accanto al pulsante Test connection.

  8. Se il contenuto è contrassegnato per la traduzione, fare clic su Mostra impostazioni facoltative e fornire gli ID tag.

  9. Se specificato, selezionare una cartella predefinita (possibile solo dopo il salvataggio).

  10. Clicca su Salva.

    Il connettore viene aggiunto all'elenco nella pagina Connettori.

Elimina un connettore

Per eliminare un connettore:

  1. Dalla pagina Integrazioni, selezionare il connettore da eliminare.

  2. Fare clic su Elimina.

    Si apre la finestra Elimina connettore.

  3. 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 eventuali lavori rimanenti. Vai su Impostazioni/Cestino e svuotalo per rimuovere eventuali lavori ancora collegati al connettore. Riprova a eliminare il connettore.

Questo articolo ti è stato utile?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.