Integrace
    1. Phrase
    2. Phrase TMS
    3. Integrace

    Braze (TMS)

    Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

    K dispozici pro

    • edice Team, Professional, Business a Enterprise

    S dotazy ohledně licencí se obraťte na prodejní oddělení.

    K dispozici pro

    • Tarify Ultimate a Enterprise (starší verze)

    S dotazy ohledně licencí se obraťte na prodejní oddělení.

    Konektor Braze umožňuje marketérům lokalizovat kampaně, canvasy a šablony v Braze bez manuální práce. Propojením Phrase TMS s vícejazyčným API Braze se vícejazyčný obsah automaticky vyměňuje mezi oběma platformami za účelem překladu.

    Tato integrace je navržena pro marketéry, nikoli pro vývojáře. Odstraňuje potřebu úprav kódu, exportů souborů nebo duplikování šablon.

    Konektor obsahuje funkci sjednoceného mapování jazyků, která automaticky přiřazuje jazykové kódy Phrase TMS k jazykovým kódům Braze. Běžné rozdíly, například ve velikosti písmen (de-DE vs de-de) nebo v použití oddělovačů (en-US vs en_us), se řeší automaticky, což omezuje potřebu ručního nastavení. Administrátoři mohou v nastavení konektoru definovat vlastní mapování pro nestandardní nebo jedinečné kódy národního prostředí, které budou mít přednost před automatickým mapováním.

    Automatická upozornění lze nakonfigurovat tak, aby byli překladatelé informováni o příchodu nové úlohy a marketéři obdrželi oznámení o jejím dokončení.

    Braze vyžaduje, aby každý překlad měl jedinečné ID štítku.

    Průvodce lokalizací Braze

    Poznámka

    Z důvodu kontinuálního vylepšování nemusí uživatelské rozhraní vypadat stejně jako na videu.

    Struktura obsahu Braze

    • Šablony:

      Opakovaně použitelná rozvržení zpráv, jako jsou e-maily, zprávy v aplikaci nebo push oznámení, která tvoří základ vašich kampaní a canvasů.

    • Kampaně:

      Používají se k odesílání cílených zpráv publiku prostřednictvím jednoho nebo více kanálů (e-mailem, push oznámeními nebo zprávami v aplikaci). Kampaně mohou být jednorázové, opakující se nebo spouštěné na základě události a podporují personalizovanou vícekanálovou komunikaci.

    • Canvasy:

      Vícekrokové zákaznické cesty, které odesílají zprávy napříč několika kanály pomocí spouštěčů, segmentů publika a logiky časování. Canvasy jsou ideální pro koordinaci automatizovaných postupů zapojení zákazníků založených na jejich chování.

    • Bloky obsahu:

      Znovupoužitelné úryvky obsahu, které lze vložit do šablon, kampaní a canvasů.

    Případy použití lokalizace

    • Lokalizace na úrovni šablony

      Lokalizujte šablony před jejich propojením s kampaněmi nebo canvasy.

      Omezení:

      • Podporuje pouze HTML šablony pro e-maily, push oznámení a zprávy v aplikaci (nikoli šablony vytvářené přetahováním).

      • Šablony vytvářené přetahováním jsou podporovány prostřednictvím kampaní a canvasů.

    • Lokalizace na úrovni kampaně a canvasu

      Při práci v kampaních nebo canvasech lze lokalizovat další typy zpráv, včetně šablon vytvářených přetahováním.

      Kampaně a canvasy slouží jako doručovací vrstva. Šablony vytvářené přetahováním nelze lokalizovat přímo z knihovny šablon, lze je však lokalizovat při jejich použití v kampaních nebo canvasech. To znamená, že všechny typy zpráv lze přeložit na příslušné vrstvě.

    Omezení

    Omezení

    Popis

    Alternativní řešení

    Šablony vytvářené přetahováním

    Nejsou viditelné jako šablony

    Lokalizujte je prostřednictvím kampaní nebo canvasů a budou viditelné v Phrase TMS

    Nesoulad kódů národního prostředí

    Může způsobit chyby při vytváření úloh

    Používejte jednotný zápis kódů národního prostředí s podtržítky

    Chybějící oprávnění

    Může blokovat synchronizaci

    Ujistěte se, že vytváříte nové klíče API s oprávněními pro šablony (Template), canvasy (Canvas) a kampaně (Campaign).

    Příklady použití

    Konektor lze použít v několika případech:

    • Projektoví manažeři mohou přidat soubory přímo do projektů z online úložiště.

    • Nastavte portál zadavatele tak, aby zadavatelé mohli přidat soubory k požadavkům přímo z online úložiště.

    • Použijte automatizované vytváření projektů (APC) k automatickému vytváření nových projektů, jakmile se u sledovaných dokumentů nebo složky změní obsah.

      • APC spouští pouze nový nebo aktualizovaný přeložitelný obsah; export překladů nebo změny nepřeložitelného obsahu nové projekty nevytvářejí.

    • API konektoru lze použít k automatizaci kroků jinak prováděných ručně prostřednictvím uživatelského rozhraní. Pomocí webhooků mohou být systémy třetích stran informovány o určitých událostech (například když se změní stav zakázky).

    Nastavení vícejazyčnosti v Braze

    1. Přihlaste se ke svému účtu Braze.

    2. Přejděte na APIs and Identifiers v části Setttings v konzoli pro vývojáře.

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

      Pokud je vyžadováno omezení:

      1. Přejděte na Templates v konzoli pro vývojáře.

      2. Otevřete možnosti Templates a vyberte templates.translations.get a templates.translations.update.

    4. Vytvořte nový Rest API Key.

      Tento klíč je vyžadován pro konfiguraci konektoru.

      Klíč REST API je vázán na uživatelský účet Braze, který jej vygeneroval.

      Zajistěte, aby byla vybrána tato oprávnění:

      • Šablony

      • Canvasy

      • Kampaně

      Pokud byl pro starší konektor vygenerován klíč, nebude již fungovat.

    5. Zkopírujte Braze REST Endpoint URL.

    6. Zajistěte, aby kódy národního prostředí v části Workspace Settings – Multi-Language Locale Setttings měly standardní formát s podtržítkem. Spojovníky nebo jiné formáty způsobí chyby.

    7. U všech šablon, kampaní a kroků canvasu vyžadujících překlad zajistěte, aby byla nastavena vícejazyčnost se všemi požadovanými kódy národního prostředí včetně zdrojového.

    Nastavení Phrase TMS

    1. Na stránce Nastavení Setup_gear.png přejděte dolů do oddílu Integrace.

    2. Klikněte na Konektory.

      Otevře se stránka Konektory.

    3. Klikněte na New connector.

      Otevře se stránka Create connector.

    4. Změňte Type na Braze a zadejte název konektoru.

    5. Z rozevíracího seznamu vyberte adresu URL koncového bodu Braze REST.

    6. Zadejte klíč REST API, který naleznete v části Braze Settings → APIs and Identifiers → API Keys.

    7. Klikněte na Zkouška spojení.

      • Pokud je test úspěšný, vedle tlačítka Test connection se zobrazí malé zaškrtnutí.

    8. Kliknutím na Show optional settings nakonfigurujte další možnosti:

      • Tagy pro překladu

        Zadejte ID štítků pro obsah, který chcete importovat. Tagy musí odpovídat tagům v Braze.

      • Přiřazení jazyků

        Kliknutím na Add language mapping namapujte jazyky Braze na jazyky TMS.

        Každý jazyk Phrase lze mapovat pouze na jeden kód národního prostředí Braze současně. Pokud jsou dva kódy Braze (například da a visitor_da) mapovány na stejný jazyk Phrase, konektor automaticky vybere jeden z kódů a nelze ovlivnit, který kód bude vybrán. Úloha pro kód, který nebyl vybrán, se nevytvoří a konektor pro daný jazyk zaznamená chybu.

        Aby bylo možné vytvořit úlohu, musí již zdrojové národní prostředí a všechna cílová národní prostředí nastavená v konektoru nebo v mapování jazyků APC existovat u příslušné položky canvasu nebo kampaně v Braze. Konfigurace národního prostředí na úrovni konektoru nebo APC není dostatečná. Pokud v Canvasu chybí jazyková varianta, import selže s chybou oznamující, že zdrojová nebo cílová jazyková varianta není v položce Braze nakonfigurována. Před opakováním importu přidejte chybějící jazykové varianty přímo do Canvasu v Braze.

      • Filtr importu dle aktuálnosti

        Nastavte maximální počet dní od poslední aktualizace, aby se importoval pouze obsah aktualizovaný v zadaném počtu dní. Nastavte hodnotu na 0, chcete-li importovat veškerý obsah bez ohledu na jeho stáří.

    9. Klikněte na Uložit.

      Konektor je přidán do seznamu na stránce Konektory.

    Lokalizace HTML e-mailových šablon

    Při použití editoru HTML v Braze lze obsah lokalizovat přímo na úrovni šablony. To je ideální pro opakovaně použitelné e-maily.

    Pro lokalizaci HTML e-mailové šablony postupujte podle těchto kroků:

    1. V Template - Email Templates - HTML Editor otevřete šablonu.

    2. Přidejte překladové značky:

      • Obalte přeložitelnou oblast značkami Phrase:

        {% translation phrase_body %}
...your email content here...
{% endtranslation %}

        Tip

        Umístěte otevírací značku na první řádek a uzavírací značku na poslední řádek editoru HTML. Věty není třeba obalovat jednotlivě; převodník Phrase automaticky analyzuje vše mezi dvěma značkami a připraví to k překladu v pracovním prostoru Phrase TMS. Formátování HTML, odkazy a styly zůstávají v lokalizované verzi plně zachovány.

      • Chcete-li přeložit předmět a náhled, obalte je jednotlivě:

        {% translation phrase_subject %}Subject text{% endtranslation %}
{% translation phrase_preheader %}Preheader text{% endtranslation %}

    3. Uložte šablonu.

    4. Znovu otevřete šablonu, vyberte Vícejazyčné a zvolte zdrojovou a cílovou jazykovou variantu. Ujistěte se, že jazykové varianty odpovídají nastavení v konfiguraci Phrase.

    5. Uložte šablonu.

    6. Ve Phrase TMS vyberte Import z integrace - Braze - Šablony.

      Šablona HTML se zobrazí jako překladová úloha.

    7. Přeložte a zkontrolujte.

    8. Po schválení exportujte překlady zpět do Braze.

      Lokalizované verze se automaticky zobrazí u příslušných jazykových variant. Použijte Náhled a test - Vícejazyčný uživatel k ověření zobrazení a rozvržení.

    Práce s kampaněmi a Canvasy

    Poznámka

    Kontextový náhled není v editoru CAT k dispozici pro úlohy importované z kampaní nebo Canvasů. Phrase TMS přijímá v rámci těchto typů obsahu více e-mailů a nemůže je sloučit do jednoho HTML pro vykreslení, takže se karta Náhled nezobrazuje.

    Chcete-li použít kontextový náhled, lokalizujte raději přímo e-mailovou šablonu.

    Při lokalizaci v rámci kampaní nebo Canvasů se pracovní postup mírně liší. Namísto lokalizace samostatné šablony HTML se pracuje s aktivními podklady kampaně nebo s jejími koncepty, které mohou obsahovat obsah vytvořený přetahováním.

    • Lokalizace nepocházejí z knihovny šablon, ale přímo z kampaní nebo Canvasů.

    • Šablony typu drag-and-drop se stanou lokalizovatelnými, jakmile jsou v těchto kontextech použity.

    • Všechny typy zpráv (e-maily, push notifikace a zprávy v aplikaci) lze lokalizovat, pokud jsou obaleny značkami Phrase.

    Chcete-li pracovat s kampaní nebo Canvasem, postupujte podle těchto kroků:

    1. V části Kampaně nebo Canvasy otevřete požadovaný podklad.

    2. Přidejte překladové značky:

      • Pokud používáte HTML editor

        • Obalte přeložitelnou oblast značkami Phrase:

          {% translation phrase_body %}
...your email content here...
{% endtranslation %}

          Tip

          Umístěte otevírací značku na první řádek a uzavírací značku na poslední řádek editoru HTML. Věty není třeba obalovat jednotlivě; převodník Phrase automaticky analyzuje vše mezi dvěma značkami a připraví to k překladu v pracovním prostoru Phrase TMS. Formátování HTML, odkazy a styly zůstávají v lokalizované verzi plně zachovány.

        • Chcete-li přeložit předmět a náhled, obalte je jednotlivě:

          {% translation phrase_subject %}Subject text{% endtranslation %}
{% translation phrase_preheader %}Preheader text{% endtranslation %}

        • U e-mailů typu drag-and-drop přidejte jeden blok Odstavec na začátek a jeden na konec e-mailu. Umístěte otevírací značku {% translation phrase_body %} do horního bloku a uzavírací značku {% endtranslation %} do spodního bloku. To pokrývá celý e-mail; každou větu není třeba obalovat jednotlivě.

    3. Označit k překladu

      Pokud je použití značky nakonfigurováno na úrovni konektoru, označte kampaň nebo Canvas značkou pro překlad.

    4. Importovat do Phrase TMS

      Ve Phrase TMS přejděte na Import z integrace - Braze - Kampaně/Canvasy. Označené kampaně se zobrazí k výběru.

      Před importem se ujistěte, že jsou ke kampani nebo Canvasu v Braze přidány zdrojová i všechny cílové jazykové varianty (v nastavení vícejazyčného obsahu) a že zdrojová jazyková varianta obsahuje zdrojový obsah. Pokud v položce chybí cílová jazyková varianta, import selže a v historii APC se zobrazí chyba, i když je formát jazykové varianty nakonfigurovaný v konektoru správný. Pokud zdrojová jazyková varianta chybí nebo je prázdná, zpráva se z úlohy vynechá bez oznámení chyby.

    5. Přeložit a zkontrolovat

      Lingvisté překládají v pracovním prostoru Phrase. HTML a formátování jsou zachovány automaticky.

    6. Exportovat a zobrazit náhled

      Jakmile budete hotovi, exportujte lokalizovanou verzi zpět do Braze. Pomocí Náhled a test - Vícejazyčný uživatel přepínejte mezi jazykovými variantami a ověřte výsledek.

    Braze Legacy (TMS)

    K dispozici pro

    • edice Team, Professional, Business a Enterprise

    S dotazy ohledně licencí se obraťte na prodejní oddělení.

    K dispozici pro

    • Edice Ultimate a Enterprise (starší)

    S dotazy ohledně licencí se obraťte na prodejce.

    Důležité

    Konektor Braze (Legacy) bude označen za zastaralý dne 30. listopadu 2026. Nové instance tohoto konektoru lze vytvářet do 17. srpna 2026. Než bude konektor označen za zastaralý, přejděte na nový konektor.

    Úplného průvodce migrací naleznete v článku Ukončení podpory staršího konektoru.

    Díky integraci Phrase TMS pro Braze lze zvýšit zapojení zákazníků a podpořit růst na nových trzích pomocí bezproblémové lokalizace. Integrace umožňuje uživatelům Braze překládat e-mailové šablony a bloky obsahu.

    Přeložitelné prvky obsahu:

    Poznámka

    Z důvodu kontinuálního vylepšování nemusí uživatelské rozhraní vypadat stejně jako na videu.

    Příklady použití

    Konektor lze použít v několika případech:

    • Projektoví manažeři mohou přidat soubory přímo do projektů z online úložiště.

    • Nastavte portál zadavatele tak, aby zadavatelé mohli přidat soubory k požadavkům přímo z online úložiště.

    • Použijte automatizované vytváření projektů (APC) k automatickému vytváření nových projektů, jakmile se u sledovaných dokumentů nebo složky změní obsah.

      • APC spouští pouze nový nebo aktualizovaný přeložitelný obsah; export překladů nebo změny nepřeložitelného obsahu nové projekty nevytvářejí.

    • API konektoru lze použít k automatizaci kroků jinak prováděných ručně prostřednictvím uživatelského rozhraní. Pomocí webhooků mohou být systémy třetích stran informovány o určitých událostech (například když se změní stav zakázky).

    Nastavení Braze

    1. Přihlaste se ke svému účtu Braze.

    2. Přejděte do Developer Console a klikněte na API Settings.

    3. Vytvořte nový Rest API Key.

      Tento klíč je vyžadován pro konfiguraci konektoru.

    4. Zkopírujte Braze REST Endpoint URL.

    Nastavení Phrase TMS

    1. Na stránce Nastavení Setup_gear.png přejděte dolů do oddílu Integrace.

    2. Klikněte na Konektory.

      Otevře se stránka Konektory.

    3. Klikněte na New connector.

      Otevře se stránka Create connector.

    4. V poli Type vyberte Braze a zadejte název konektoru.

    5. Z rozevíracího seznamu vyberte adresu URL koncového bodu Braze REST.

    6. Zadejte klíč REST API, který naleznete v části Braze Settings → APIs and Identifiers → API Keys.

    7. Klikněte na Zkouška spojení.

      • Pokud je test úspěšný, vedle tlačítka Test connection se zobrazí malé zaškrtnutí.

    8. Kliknutím na Show optional settings nakonfigurujte další možnosti:

      • Tagy pro překladu

        Zadejte ID značek pro obsah, který chcete importovat. Tagy musí odpovídat tagům v Braze.

      • Přiřazení jazyků

        Kliknutím na Add language mapping namapujte jazyky Braze na jazyky TMS.

        Každý jazyk Phrase lze mapovat pouze na jeden kód národního prostředí Braze současně. Pokud jsou dva kódy Braze (například da a visitor_da) mapovány na stejný jazyk Phrase, konektor automaticky vybere jeden z kódů a nelze ovlivnit, který kód bude vybrán. Úloha pro kód, který nebyl vybrán, se nevytvoří a konektor pro daný jazyk zaznamená chybu.

        Vytvoření úlohy vyžaduje, aby zdrojové národní prostředí a každé cílové národní prostředí nakonfigurované v konektoru nebo v mapování jazyků APC již existovaly v příslušné položce plátna nebo kampaně v Braze. Konfigurace národního prostředí na úrovni konektoru nebo APC není dostatečná. Pokud v plátně chybí národní prostředí, import selže s chybou, která indikuje, že zdrojové nebo cílové národní prostředí není v položce Braze nakonfigurováno. Před opakovaným pokusem o import přidejte chybějící národní prostředí přímo do plátna v Braze.

      • Filtr importu dle aktuálnosti

        Nastavte maximum days since last update, aby se importoval pouze obsah aktualizovaný během zadaného počtu dní. Nastavte hodnotu 0, chcete-li importovat veškerý obsah bez ohledu na stáří.

    9. Klikněte na Uložit.

      Konektor je přidán do seznamu na stránce Konektory.

    Byl pro vás tento článek užitečný?
    ★ ★ ★ ★ ★

    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.