تدويل حملات Braze: أفضل الممارسات

تدويل حملات Braze: أفضل الممارسات

تعد عملية تدويل حملات Braze مشكلة تتعلق بالبيانات والحوكمة قبل أن تكون مشكلة ترجمة. فالموقع (Locale) موجود في ملف تعريف المستخدم، ووسوم الترجمة تحدد النص، وملفات الترجمة تُرفق بكل حملة. حدد مفاتيح الموقع واللغة الاحتياطية قبل إنشاء الرسالة الأولى، لأن إعادة العمل عليها لاحقاً تعني تعديل كل حملة قمت بإرسالها بالفعل.

كيف تقرر Braze اللغة التي يراها المستخدم؟

يوجد الموقع (Locale) في ملف تعريف المستخدم. توثق Braze أن معلومات الموقع تُخزن هناك بناءً على البيانات التي يجمعها الـ SDK تلقائياً، أو من خلال واجهة برمجة التطبيقات (API). وهي تحمل معرفاً للغة والمنطقة، وتظهر في التقسيم (Segmentation) تحت تصنيفي البلد واللغة.

تلك الجملة الواحدة تحدد ترتيب العمل. لا يمكن لأي شيء لاحق أن يكون صحيحاً إذا كانت سمة الملف الشخصي التي تغذيه خاطئة أو مفقودة أو غير متسقة في حالتها عبر مصادرك. الموقع هو مسألة تتعلق باستيعاب البيانات، وتظهر أعراضها في المراسلات.

هناك مسار ثانٍ. يمكن تحديد الموقع من خلال سمات مخصصة بدلاً من سمات اللغة والبلد الافتراضية. تنص Braze على أنه عندما يطابق المستخدم كلاً منهما، فإن الموقع المحدد بالسمة المخصصة هو الذي يُعتمد. دوّن هذه القاعدة، فهي التي تقرر أي تعريف سيتم تطبيقه.

كيف تخطط لطرح تدويل حملات Braze؟

التسلسل هنا أهم من الأدوات. كل خطوة أدناه تنتج شيئاً تعتمد عليه الخطوة التالية، وكل خطوة منها غير مكلفة الآن ولكنها ستصبح مكلفة بعد الإطلاق.

  1. دقق سمة الموقع في المصدر. تأكد مما تكتبه الـ SDK وواجهة برمجة التطبيقات (API) فعلياً، بما في ذلك حالة الأحرف واللواحق الخاصة بالمنطقة، قبل أن يفتح أي شخص حملة.
  2. اتفق على اصطلاح تسمية مفتاح الموقع ودوّنه. لا تفرض Braze تنسيقاً معيناً وتذكر أنه يمكنك استخدام اصطلاح التسمية المفضل لديك.
  3. أنشئ المواقع في إعدادات مساحة العمل، وقرر لكل موقع ما إذا كان سيتم تشغيله بواسطة السمات الافتراضية أو السمات المخصصة.
  4. اتفق على النص الاحتياطي والقاعدة التي تنتجه، قبل وجود أي ترجمة.
  5. أنشئ رسالة واحدة من البداية إلى النهاية بلغة غير الإنجليزية، بما في ذلك رابط ورابط متتبع، وأرسل اختباراً.
  6. بعد ذلك فقط، توسع إلى الأسواق المتبقية.

الخطوة الخامسة هي التي تتجاهلها الفرق. رسالة واحدة يتم تمريرها بالكامل عبر المعاينة تكشف مشاكل الرابط والتتبع والسمات الموضحة أدناه. نطاق التأثير هنا هو حملة واحدة، وليس البرنامج بأكمله.

ما هو نهج التنظيم الذي يجب أن تختاره؟

توثق Braze أربعة مناهج: قالب واحد للجميع، قالب واحد لكل بلد، رحلة واحدة للجميع، ورحلة واحدة لكل بلد. الاختيار هنا هو اختيار تقارير بقدر ما هو اختيار بناء.

النهجالتقارير التي تحصل عليهااختره عندماقالب واحد للجميعمقاييس مجمعة، تقسيم البلد يحتاج إلى مسارات تقسيم مخصصةالمحتوى متطابق عبر الأسواق باستثناء اللغةقالب واحد لكل بلدتحليلات إرسال لكل بلد في لوحة التحكمالعروض أو الأسعار أو النصوص القانونية تختلف حسب السوقرحلة واحدة للجميعتحليلات Canvas مجمعةمنطق الرحلة مشترك والنص فقط هو الذي يتغيررحلة واحدة لكل بلدتحليلات لكل بلد، بما في ذلك لكل خطوة ومتغيرالتوقيت أو مزيج القنوات أو شكل الرحلة يختلف حسب السوق

تذكر Braze اعتبارات الخيارات المركزية بوضوح: بناء التقارير يدوياً، المقاييس المجمعة بدلاً من المقاييس الخاصة بكل بلد، وصعوبة الجدولة عبر المناطق الزمنية. هذه هي التكاليف التي تقبلها عند اختيار قالب واحد لكل شيء.

الطريقة الموصى بها لإدراج اللغة في رسالة واحدة هي وسم الترجمة Liquid، الذي يغلف النص بمعرف وسم. أصبحت الترجمات متعددة اللغات متاحة للجميع في إصدارات أبريل 2026، لذا فهذا هو المسار الحالي وليس مسار الوصول المبكر.

ما الذي يتعطل عندما تلتقي وسوم الترجمة بعناوين URL؟

تعد الروابط من أكثر العناصر التي تفشل فيها الرسائل المترجمة في بيئة الإنتاج دون سابق إنذار، ونادراً ما يظهر هذا الفشل في المحرر. توضح منصة Braze كيفية التعامل مع هذه الحالة بدقة.

احتفظ بالبروتوكول خارج وسم الترجمة واكتفِ بتضمين النطاق والمسار فقط. توضح Braze السبب مباشرة: قد يقوم المترجمون بتغيير أو حذف أحرف خاصة، مما يؤدي إلى تعطل الرابط. وللسبب نفسه، يجب أن تظل معاملات الاستعلام (Query parameters) خارج الوسم.

يتطلب تتبع روابط البريد الإلكتروني خطوة إضافية؛ حيث تضيف Braze معاملات تتبع لكل رابط URL. وعندما يوضع الرابط داخل وسوم الترجمة، قد لا يتمكن النظام من تحديد مكان إضافة هذه المعاملات. الحل الموثق هو إضافة حرف لاحق بعد وسم الإغلاق؛ استخدم علامة الاستفهام إذا كان الرابط لا يحتوي على أي منها، وعلامة "و" (&) إذا كان الرابط يحتوي بالفعل على معامل استعلام.

ينطبق النهج نفسه على الترميز (Markup). يجب ألا يحتوي وسم الترجمة إلا على النصوص القابلة للقراءة البشرية، وتحذر Braze من تضمين السمات مثل الفئات (class) أو الأنماط (style) أو قيم المعرفات (identifier) داخل الوسوم. كما لا يمكن تداخل الوسوم.

أين تكمن أخطاء مفاتيح اللغة (Locale keys)؟

هناك سلوكان موثقان يستحقان الإدراج في دليل التشغيل الخاص بك، لأن كلاهما يفشل بصمت.

توضح Braze أنه في حال حذف سمة مخصصة أو تغيير نوعها، لن يتمكن المستخدم من الوصول إلى تلك اللغة. سيتم نقله إلى أسفل قائمة الأولويات أو سيتلقى الترجمات التسويقية الافتراضية. لن يتلقى أحد رسالة خطأ، بل سيحصل المستخدم في ذلك السوق على المحتوى باللغة الإنجليزية ببساطة.

تعمل كتل المحتوى (Content Blocks) بالطريقة نفسها. تشير Braze إلى أن كتلة المحتوى التي تفتقر إلى ترجمات لإحدى اللغات المضافة ستظهر بلغتها الأصلية للمستخدمين في تلك المنطقة. لذا، فإن ظهور رسالة مترجمة جزئياً هو نتيجة واقعية وليس مجرد حالة استثنائية.

لهذا السبب يعد النص الاحتياطي (Fallback text) قراراً تصميمياً وليس مجرد بقايا. توصي Braze دائماً بتضمين نص احتياطي، وتحدد الفئات التي تتلقاه: المستخدمون الذين لم يحددوا لغة، والمستخدمون الذين لغتهم غير مدعومة، والمستخدمون الذين لا يمكن اكتشاف لغة أجهزتهم.

ما الذي يجب عليك التحقق منه قبل إضافة لغة جديدة؟

من الأفضل معرفة بعض القيود والسلوكيات قبل البدء في عملية البناء بدلاً من اكتشافها أثناء التنفيذ.

ماذاالسلوك الموثقعدد اللغات لكل مساحة عملحتى 200 لغةالسمات لكل لغةحتى سمتين مخصصتين، أو سمتين افتراضيتين للغة، مع اختيارية الثانيةوسوم الترجمة لكل رسالةحتى 200 وسمالنص الافتراضي لكل وسمحتى 2000 حرفالترجمات لكل لغةحتى 409,600 بايت، أي حوالي 409.6 كيلوبايتأين توجد ملفات الترجمةعلى مستوى الحملة، لذا يحتاج كل متغير من الرسالة إلى ترجماته الخاصةالمسؤول عن توفير الترجماتأنت، عبر رفع الملفات أو استخدام واجهة برمجة تطبيقات الترجمة (API)التكرار تنتقل الترجمات مع الحملة المكررة، أو خطوة Canvas، أو المتغير، وتنتقل عبر مساحات العمل عند وجود اللغات في الوجهة

يعد التخزين على مستوى الحملة هو العامل الذي يشكل سير العمليات. ولأن الملفات مرتبطة بالحملة، فإن تصحيح الترجمة يكون إجراءً خاصاً بكل حملة على حدة، ما لم يكن النص موجوداً في كتلة محتوى (Content Block). إن وضع النصوص المتكررة مثل التذييلات والنصوص القانونية في كتل المحتوى يحول عملية التصحيح من تعديلات متعددة إلى تعديل واحد فقط.

تنشر Braze أيضاً جدول تحقق يغطي حالات فشل الرفع والتحميل. لن يتم رفع ملف يحتوي على لغات غير موجودة في الرسالة. أما الملف الذي لم تعد نصوصه الافتراضية مطابقة للرسالة، فسيقوم بإضافة ترجمات مع ترك النص الأصلي كما هو، وهو أكثر أنواع الفشل صمتاً.

بصفتنا شريكاً في تنفيذ حلول Braze، فإن القاعدة التي نضعها في دليل تشغيل العميل مختصرة: تعامل مع مفاتيح اللغة كأنها مخطط بيانات (Schema)، وقم بإصدار نسخ منها، ولا تقم أبداً بإعادة تسمية مفتاح في مساحة عمل نشطة دون التحقق أولاً من كل حملة تشير إليه.

الأسئلة الشائعة

هل تقوم Braze بترجمة النصوص نيابة عني؟
توضح Braze أنك مسؤول عن توفير ترجماتك الخاصة. يمكنك رفع ملف أو استخدام واجهة برمجة تطبيقات الترجمة (API).

كم عدد اللغات التي يمكن أن تحتوي عليها مساحة العمل الواحدة؟
حتى 200 لغة، وفقاً لوثائق إعدادات التوطين (Localisation).

هل يمكنني تغيير النص المترجم بعد إنشاء الحملة؟
قم بتعديل الملف وإعادة تحميله، أو استخدم نقاط نهاية تحديث واجهة برمجة تطبيقات الترجمة (API).

ماذا يحدث للمستخدم الذي لا تتوفر لغته؟
يتلقى المحتوى الاحتياطي، ولهذا السبب توصي Braze دائمًا بتضمين نص احتياطي في الرسالة.

هل تبقى الترجمات عند تكرار الحملة؟
نعم، تبقى. توثق Braze أن الترجمات يتم تضمينها عند تكرار حملة أو خطوة في Canvas أو تباين، وكذلك عند النسخ عبر مساحات العمل إذا كانت الإعدادات المحلية موجودة هناك.

المصادر

  • Braze، التوطين. تم الاسترجاع في 11 سبتمبر 2026. https://www.braze.com/docs/user_guide/messaging/messaging_fundamentals/localization
  • Braze، إعدادات التوطين. تم الاسترجاع في 11 سبتمبر 2026. https://www.braze.com/docs/user_guide/administer/global/workspace_settings/multi-language_settings
  • Braze، الرسائل متعددة اللغات. تم الاسترجاع في 11 سبتمبر 2026. https://www.braze.com/docs/user_guide/messaging/messaging_fundamentals/localization/locales_in_messages
  • Braze، ما الجديد في Braze. تم الاسترجاع في 11 سبتمبر 2026. https://www.braze.com/docs/releases/home/

قراءات ذات صلة على هذا الموقع: التخصيص الفائق في حملات Braze، تقديم المحتوى الديناميكي، رحلات الإعداد في Canvas، حملات الإعداد التي ترفع معدل التنشيط، استراتيجيات الاحتفاظ بالعملاء باستخدام Braze.

التفضيلات

الخصوصية مهمة بالنسبة لنا، لذا لديك خيار تعطيل أنواع معينة من التخزين التي قد لا تكون ضرورية للوظائف الأساسية للموقع. قد يؤثر حظر بعض الفئات على تجربتك في الموقع.

قبول جميع ملفات تعريف الارتباط
قبول جميع ملفات تعريف الارتباط

هذه العناصر مطلوبة لتمكين الوظائف الأساسية للموقع.

نشط دائماً

تُستخدم هذه العناصر لتقديم إعلانات أكثر صلة بك وباهتماماتك.

تسمح هذه العناصر للموقع بتذكر الاختيارات التي تقوم بها (مثل اسم المستخدم، أو اللغة، أو المنطقة التي تتواجد فيها) وتوفير ميزات محسنة وأكثر تخصيصاً.

تساعد هذه العناصر مشغل الموقع على فهم كيفية أداء موقعه، وكيفية تفاعل الزوار معه، وما إذا كانت هناك أي مشكلات تقنية.

شكراً لك! لقد تم استلام طلبك بنجاح.
عذراً! حدث خطأ ما أثناء إرسال النموذج.