PlayableLabs Docs
Tùy Chỉnh

Bản Địa Hóa

Quản lý nội dung đa ngôn ngữ cho quảng cáo playable với quản lý bản dịch và tham số theo locale

Tổng Quan

PlayableLabs hỗ trợ bản địa hóa toàn diện cho quảng cáo playable, bao gồm bản địa hóa văn bản, âm thanh và hình ảnh. Bạn có thể dịch nội dung thủ công hoặc sử dụng dịch hàng loạt bằng AI để bản địa hóa nhiều tham số cùng lúc.

Locales vs Bản Địa Hóa: Đây là hai khái niệm riêng biệt trong PlayableLabs:

  • Cấu hình Locale (Settings > Locales) — Thêm/xóa ngôn ngữ, đặt mặc định, bật/tắt locale cho tổ chức
  • Quản lý bản dịch (Settings > Localization HOẶC tab Localization của variant) — Quản lý bản dịch nội dung, dịch hàng loạt AI và theo dõi nguồn

Cấu hình locales trước tại Cài đặt tổ chức > Locales, sau đó quản lý bản dịch tại đây.

Cách Bản Địa Hóa Hoạt Động

Các Loại Tham Số Có Thể Bản Địa Hóa

Hệ thống bản địa hóa hỗ trợ ba loại nội dung:

  • TEXT parameters -- Chuỗi văn bản, nhãn và mô tả
  • AUDIO parameters -- File âm thanh cho các ngôn ngữ/khu vực khác nhau
  • TEXTURE parameters -- Hình ảnh có thể chứa văn bản hoặc nội dung theo khu vực

Tham số có thể bản địa hóa được đánh dấu với badge hiển thị nguồn (DIRECT, INHERITED hoặc AUTO_TRANSLATED).

Phân Giải Locale

Khi quảng cáo playable được hiển thị, hệ thống phân giải giá trị tham số theo thứ tự:

  1. Giá trị theo locale cho locale đã chọn (nếu đã đặt)
  2. Giá trị locale mặc định (dự phòng)
  3. Giá trị tham số gốc (key tiếng Anh)

Điều này đảm bảo quảng cáo playable luôn có nội dung để hiển thị, ngay cả khi thiếu bản dịch.

Quản Lý Bản Dịch

Chọn Locale

  1. Mở một variant và điều hướng đến tab Customize
  2. Sử dụng bộ chọn locale trong header trình chỉnh sửa để chuyển giữa các ngôn ngữ
  3. Các tham số có thể bản địa hóa cập nhật để hiển thị giá trị của locale đã chọn
  4. Các tham số không bản địa hóa giữ nguyên

Bộ Chọn Locale

Thêm Locale Mới

  1. Điều hướng đến cài đặt Bản Địa Hóa của game
  2. Nhấn Thêm Locale
  3. Chọn ngôn ngữ từ danh sách có sẵn
  4. Locale mới được tạo với giá trị dự phòng từ locale mặc định

Chỉnh Sửa Bản Dịch

Bảng bản địa hóa cung cấp giao diện chuyên dụng để quản lý bản dịch:

  1. Mở một variant và điều hướng đến tab Localization
  2. Chọn locale đích từ bộ chọn locale
  3. Sử dụng bộ lọc tab để hiển thị tham số TEXT, AUDIO hoặc TEXTURE
  4. Áp dụng chế độ lọc: all, translated, untranslated hoặc inherited
  5. Chỉnh sửa giá trị trực tiếp trong bảng bản địa hóa

Bảng Bản Địa Hóa

Dịch Hàng Loạt Bằng AI

Dịch nhiều tham số văn bản cùng lúc bằng AI:

  1. Trong tab Localization, chọn locale đích
  2. Nhấn nút AI Batch Translate (xuất hiện khi có item chưa dịch)
  3. Chọn locale nguồn (hoặc "auto" để tự động phát hiện)
  4. Chọn chiến lược dịch:
    • SEQUENTIAL -- Chậm hơn nhưng cẩn thận hơn (30 giây)
    • CHUNKED_PARALLEL -- Nhanh hơn cho batch lớn (10 giây)
  5. Tùy chọn thêm gợi ý ngữ cảnh để cải thiện chất lượng dịch
  6. Nhấn Translate
  7. Theo dõi cập nhật tiến độ thời gian thực
  8. Xem lại tham số đã dịch với badge AI

Tất cả tham số được dịch bằng AI đều được đánh dấu với badge tím "AI" để dễ nhận biết.

Theo Dõi Nguồn

Mỗi bản địa hóa hiển thị nguồn của nó:

  • DIRECT -- Đặt trực tiếp tại cấp này
  • INHERITED -- Kế thừa từ cấp cha (game/version)
  • AUTO_TRANSLATED -- Được dịch bởi dịch hàng loạt AI

Badge nguồn xuất hiện bên cạnh mỗi giá trị đã bản địa hóa để minh bạch hoàn toàn.

Bản Địa Hóa Tài Nguyên

Ngoài văn bản, bạn có thể bản địa hóa âm thanh và hình ảnh:

Bản Địa Hóa Âm Thanh

Tải lên các file âm thanh khác nhau cho từng locale:

  • Lồng tiếng bằng các ngôn ngữ khác nhau
  • Hiệu ứng âm thanh theo khu vực
  • Bản nhạc được bản địa hóa

Tham số âm thanh hiển thị bộ chọn locale và điều khiển tải lên trong bảng bản địa hóa.

Bản Địa Hóa Hình Ảnh

Một số hình ảnh chứa văn bản hoặc nội dung theo khu vực cần bản địa hóa:

  • Ảnh chụp màn hình với văn bản UI
  • Banner với nội dung marketing
  • Icon với văn bản nhúng

Tải lên các tài nguyên hình ảnh khác nhau cho từng locale qua tab TEXTURE trong bảng bản địa hóa.

Kế Thừa Thứ Bậc Với Bản Địa Hóa

Bản địa hóa hoạt động cùng với hệ thống phân cấp tham số:

Variant (locale) > Variant (mặc định) > Version > Game > Organization

Giá trị theo locale trên variant có ưu tiên cao nhất. Nếu không có giá trị locale trên variant, hệ thống dự phòng theo thứ bậc sử dụng locale mặc định.

Ví Dụ

CấpMặc Định (en)Tiếng Tây Ban Nha (es)
Game"Play Now"--
Version----
Variant--"Jugar Ahora"
Kết Quả"Play Now""Jugar Ahora"

Variant tiếng Tây Ban Nha hiển thị "Jugar Ahora" (đặt ở cấp variant), trong khi tiếng Anh dự phòng về "Play Now" cấp game.

Thực Hành Tốt Nhất

  • Đặt locale mặc định trước -- Hoàn thành ngôn ngữ mặc định trước khi thêm bản dịch
  • Dùng key tham số mô tả -- Key như ctaButtonText dễ dịch hơn text_1
  • Kiểm tra độ phủ thường xuyên -- Kiểm tra dashboard độ phủ bản địa hóa trước khi xuất
  • Thử nghiệm mỗi locale trong xem trước -- Chuyển locale trong bản xem trước để xác minh bản dịch đúng trong ngữ cảnh
  • Xử lý độ dài văn bản -- Một số ngôn ngữ tạo văn bản dài hơn; xác minh bố cục chứa được bản dịch

Tích Hợp API

Khi lấy tham số qua API, chỉ định query parameter locale để nhận giá trị đã bản địa hóa:

GET /api/customization/variants/{variantId}/parameters?locale=es

Phản hồi bao gồm cả value gốc và localizedValue cho locale được yêu cầu, cùng với thống kê độ phủ.

Tiếp Theo

On this page