Quản lý ứng dụng

Ứng dụng của tôi (Bảng điều khiển)

Ứng dụng của tôi (/ hoặc /apps) là trang đích sau khi đăng nhập và là nơi quản lý tập trung mọi ứng dụng của nhóm bạn.

Bảng ứng dụng. Mỗi hàng hiển thị: số thứ tự, biểu tượng ứng dụng (hoặc ảnh đại diện bằng chữ cái nếu chưa tải biểu tượng lên), tên và package/bundle ID, Thương hiệu được gán, Cửa hàng (biểu tượng nền tảng iOS/Android/Amazon), Phiên bản SDK hiện tại (có thể sắp xếp), chấm trạng thái Cấu hình mặc định (màu xanh lá "Đã thêm" nếu đã tạo cấu hình mặc định cho ứng dụng, màu xám "Chưa thêm" nếu chưa có), Ngày tạo (có thể sắp xếp) và cột Thao tác.

Tìm kiếm và lọc. Ô tìm kiếm lọc theo tên/package ngay khi bạn nhập. Các bộ lọc dạng danh sách thả xuống riêng cho Thương hiệu, Cửa hàng và Phiên bản SDK (trên Thanh bộ lọc) có thể kết hợp với tìm kiếm. Phân trang sử dụng phần chân trang tùy chỉnh "Hiển thị X–Y trên tổng số Z", kèm bộ chọn số hàng mỗi trang và các nút điều hướng ⟨ ‹ › ⟩, thay vì bộ phân trang tích hợp sẵn của bảng.

Menu Thao tác. Menu ba chấm trên mỗi hàng cung cấp các tùy chọn Chỉnh sửa, Nhân bản và Xóa, tùy theo quyền của bạn (xem phần Giới hạn gói và quyền trong chế độ xem được chia sẻ bên dưới).

Giới hạn gói và ứng dụng bị khóa. Gói đăng ký giới hạn số ứng dụng bạn có thể có (maxApps). Nếu số ứng dụng hiện tại vượt quá giới hạn này — ví dụ sau khi hạ cấp gói — một biểu ngữ cảnh báo màu vàng cam sẽ xuất hiện ở đầu trang: "Bạn đã vượt giới hạn ứng dụng — Đã sử dụng X/Y ứng dụng", kèm thanh tiến trình nhỏ và nút Nâng cấp gói dẫn đến trang Gói đăng ký.

Khi bạn vượt giới hạn, Cổng quản trị không tùy ý chọn ứng dụng nào để khóa — hệ thống giữ lại các ứng dụng cũ nhất (theo ngày tạo) để bạn tiếp tục sử dụng trong giới hạn của gói, và khóa mọi ứng dụng được tạo sau đó. Menu Thao tác của ứng dụng bị khóa được rút gọn: khi nhấp nút ba chấm, bạn chỉ thấy tiêu đề "ĐÃ KHÓA" với lời giải thích "Ứng dụng này nằm ngoài giới hạn gói của bạn. Hãy xóa ứng dụng để giải phóng một suất", cùng tùy chọn "Xóa ứng dụng" màu đỏ nếu bạn có quyền xóa. Các hàng bị khóa không có tùy chọn Chỉnh sửa và Nhân bản; cách duy nhất để truy cập lại ứng dụng bị khóa là xóa các ứng dụng khác để giải phóng một suất hoặc nâng cấp gói.

Nút tạo. Bạn chỉ có thể nhấp nút + Tạo ứng dụng khi gói vẫn còn suất trống (canCreateApp()). Nếu đã đạt giới hạn, nút này được thay bằng chỉ báo mức sử dụng nhỏ ("Đã sử dụng X/Y ứng dụng") và liên kết "🔒 Nâng cấp gói" dẫn đến trang Gói đăng ký.

Chế độ xem được chia sẻ/cộng tác viên. Nếu bạn đang xem trang này trong ngữ cảnh tài khoản đã chuyển sang hoặc được chia sẻ (xem menu Tài khoản ở trên), bảng sẽ lấy thêm các quyền cụ thể của bạn đối với tài khoản đó (qua /rights/user-permissions) và dùng chúng để kiểm soát thao tác Chỉnh sửa/Xóa/Nhân bản trên từng hàng — ví dụ, bạn có thể xem và chỉnh sửa ứng dụng nhưng không được xóa, tùy theo quyền chủ sở hữu tài nguyên đã cấp.

Thêm ứng dụng mới

Nhấp + Tạo ứng dụng để mở biểu mẫu Ứng dụng ở chế độ "tạo", dưới dạng hộp thoại ở giữa màn hình với bố cục dọc.

Các trường:

• Biểu tượng — không bắt buộc. Ô tải ảnh lên hình vuông lớn ở phía trên hiển thị "Tải ảnh lên" cho đến khi bạn chọn tệp; hỗ trợ các định dạng JPEG, PNG và GIF.
• Cửa hàng — bắt buộc chọn một tùy chọn: Apple App Store, Google Play hoặc Amazon App Store (danh sách được tải động từ backend; nếu yêu cầu đó thất bại, hệ thống dùng ba lựa chọn này làm dự phòng).
• Tên — bắt buộc, từ 4–70 ký tự.
• Package / Bundle ID — bắt buộc, phải bắt đầu bằng com. (được kiểm tra theo mẫu com.*).
• URL — bắt buộc khi tạo. Chọn cửa hàng Google Play sẽ tự động điền https://play.google.com/store/apps/details?id={package}; chọn Apple App Store sẽ tự động điền URL cơ sở https://apps.apple.com/. Bạn vẫn có thể chỉnh sửa URL thủ công sau khi tự động điền. Khi Google Play đang được chọn, thay đổi package cũng sẽ cập nhật URL tự động điền cho khớp.
• Thương hiệu — danh sách thả xuống gồm các Thương hiệu hiện có của bạn.

Khi gửi biểu mẫu, hệ thống gọi endpoint tạo ứng dụng. Ứng dụng được tạo mà chưa cấu hình mạng mediation hay đơn vị quảng cáo nào — bạn sẽ cấu hình các mục đó tiếp theo trong Chi tiết ứng dụng. Nhấp Hủy để đóng hộp thoại mà không lưu.

Chỉnh sửa hoặc nhân bản ứng dụng (hộp thoại nhanh)

Chọn Chỉnh sửa từ menu Thao tác của một hàng để mở cùng thành phần biểu mẫu ở chế độ "chỉnh sửa", nhưng với bố cục một hàng ngang gọn thay vì bố cục dọc khi tạo: biểu tượng (kèm nút bút chì nhỏ đè lên để thay biểu tượng), Tên, trường Package chỉ đọc, trường URL chỉ đọc, danh sách thả xuống Thương hiệu và nút Lưu. Package và URL trở thành trường chỉ đọc vĩnh viễn sau khi ứng dụng được tạo (bạn không thể thay đổi package ID hoặc URL cửa hàng của ứng dụng sau khi tạo — chỉ có thể đổi tên, biểu tượng và thương hiệu). Hàng này chịu sự kiểm soát của quyền canUpdate; trong ngữ cảnh được chia sẻ/cộng tác viên, quyền này phụ thuộc vào các quyền Thông tin ứng dụng mà bạn được cấp.

Chọn Nhân bản để mở một bản biểu mẫu khác ở chế độ tạo, được điền sẵn thông tin từ ứng dụng nguồn, với .copy được thêm vào cuối tên package để tránh trùng với bản gốc. Sau đó, bạn có thể điều chỉnh theo ý muốn (tên, biểu tượng, thương hiệu) trước khi lưu thành một ứng dụng hoàn toàn mới — mediation, đơn vị quảng cáo và mọi thiết lập khác trong Chi tiết ứng dụng đều không được sao chép; bản nhân bản bắt đầu từ đầu giống như một ứng dụng mới tạo.

Chi tiết ứng dụng

Mở một ứng dụng (qua Ứng dụng của tôi → Chỉnh sửa hoặc nhấp trực tiếp vào hàng ứng dụng) sẽ đưa bạn đến Chi tiết ứng dụng — trang phức tạp nhất trong Cổng quản trị và là nơi cấu hình hành vi thực tế của SDK cho ứng dụng đó.

Chế độ Live và Dev. Nút chuyển ở đầu trang chuyển toàn bộ trang giữa cấu hình Live và Dev. Mọi mục bên dưới — Mediation, Đơn vị quảng cáo, Placeholder, Tùy chọn hiển thị, MMP, Quảng bá tính năng, Cài đặt — đều được cấu hình riêng cho từng chế độ, để bạn có thể chuẩn bị và kiểm thử thay đổi trong Dev mà không ảnh hưởng đến cấu hình đang hoạt động trong ứng dụng đã phát hành. Hai nút Áp dụng Live sang Dev và Áp dụng Dev sang Live cho phép sao chép toàn bộ cấu hình của một chế độ sang chế độ kia chỉ bằng một thao tác (hữu ích khi "đưa" cấu hình Dev đã kiểm thử lên Live hoặc đặt lại Dev cho khớp với Live trước khi thử nghiệm thay đổi mới).

Phần đầu trang cũng hiển thị số Phiên bản cấu hình hiện tại của ứng dụng, liên kết Lịch sử thay đổi (xem bên dưới) và nút Lấy cấu hình (xem bên dưới). Một số thành phần giao diện cấu hình (và bộ chọn Nhóm khu vực được đề cập bên dưới) chỉ xuất hiện khi phiên bản SDK do ứng dụng báo cáo đáp ứng ngưỡng phiên bản nhất định (Cổng quản trị yêu cầu phiên bản SDK tối thiểu cho một số tính năng mới, để các bản dựng ứng dụng cũ không hiển thị tùy chọn mà chúng thực tế không thể sử dụng).

Phần còn lại của trang được tổ chức thành các mục có thể mở rộng, theo thứ tự sau:

Thông tin ứng dụng

Thông tin nhận diện cơ bản của ứng dụng: tên, package/bundle ID, cửa hàng, biểu tượng và thương hiệu được gán — về cơ bản giống các trường trong biểu mẫu tạo/chỉnh sửa Ứng dụng, được hiển thị tại đây để thuận tiện thao tác.

Chọn mạng mediation

Chọn mạng mediation được sử dụng cho ứng dụng/chế độ này (ví dụ: mạng theo mô hình waterfall hoặc AppLovin MAX). Đây là lựa chọn tiên quyết: cho đến khi bạn chọn mạng mediation tại đây, các mục Đơn vị quảng cáo, Placeholder quảng cáo và Đơn vị quảng cáo cho placeholder bên dưới vẫn bị khóa, vì các mục này cần biết bạn đang cấu hình theo SDK và định dạng đơn vị quảng cáo của mạng nào.

Thêm đơn vị quảng cáo

Nhập ID đơn vị quảng cáo do mạng mediation cấp, được tổ chức thành các tab theo định dạng quảng cáo — App Open (mở ứng dụng), Interstitial (xen kẽ), Banner, Native (tự nhiên) và Rewarded (có thưởng). Chỉ các định dạng mà mạng mediation đã chọn ở trên thực sự hỗ trợ mới xuất hiện dưới dạng tab.

Placeholder quảng cáo

Định nghĩa các placeholder có tên: những vị trí logic trong ứng dụng hoặc trò chơi mà quảng cáo có thể xuất hiện (ví dụ: "Hoàn thành màn chơi" hoặc "Banner menu chính"). Các placeholder được hiển thị dưới dạng lưới có đánh số; bạn có thể thêm hoặc đổi tên. Vì tên placeholder thường cần khớp với các hằng số trong mã nguồn ứng dụng, Cổng quản trị hỗ trợ nhập và xuất toàn bộ danh sách placeholder dưới dạng tệp enum Kotlin (.kt), giúp giữ đồng bộ mã nguồn và cấu hình trên Cổng quản trị mà không phải nhập lại thủ công.

Đơn vị quảng cáo cho placeholder quảng cáo

Đây là lưới ánh xạ: một trục là các placeholder, trục còn lại là các định dạng quảng cáo (Interstitial / Banner / Native / Rewarded). Với mỗi tổ hợp, bạn chọn đơn vị quảng cáo cụ thể (trong số các đơn vị đã thêm ở trên) để phân phối quảng cáo tại placeholder đó.

Đáng chú ý, Quảng bá chéo cũng xuất hiện dưới dạng tùy chọn trong lưới này, bên cạnh các đơn vị quảng cáo thực từ mạng quảng cáo. Khi chọn tùy chọn này cho một placeholder, vị trí đó sẽ không hiển thị quảng cáo trả phí từ mạng — thay vào đó, vị trí này hiển thị mẫu quảng bá chéo cho một ứng dụng khác của bạn, theo cấu hình trong Chiến dịch. Đây là cơ chế kết nối tính năng Chiến dịch với các vị trí quảng cáo thực tế trong ứng dụng.

Tùy chọn hiển thị quảng cáo

Với mỗi định dạng quảng cáo, bạn có thể kiểm soát trải nghiệm khi tải: có hiển thị hộp thoại đang tải hoặc hiệu ứng shimmer trong lúc lấy quảng cáo hay không, và thời gian chờ tối đa trước khi ngừng chờ. Quảng cáo Interstitial có thêm các tùy chọn logic kích hoạt ngoài việc thiết lập thời điểm hiển thị đơn thuần — bạn có thể chọn kích hoạt khi nhấp, sau một khoảng thời gian, kết hợp cả hai hoặc dựa trên việc chuyển cảnh trong ứng dụng. Mỗi chế độ kích hoạt có các tham số có thể điều chỉnh riêng (ví dụ: khoảng thời gian hoặc số lần nhấp).

Paywall cho placeholder ứng dụng

Ánh xạ trực tiếp một Mẫu paywall của bạn (được thiết kế trong tính năng Mẫu paywall — xem mục Paywall riêng ở phần sau của hướng dẫn này) vào các placeholder của ứng dụng, để SDK biết cần hiển thị paywall nào khi ứng dụng yêu cầu.

Nút chuyển Bật ở cấp tổng thể dùng để bật hoặc tắt toàn bộ tính năng này cho ứng dụng. Sau khi bật, mỗi hàng ghép một paywall với các Placeholder ứng dụng (đã định nghĩa trước đó trong mục Placeholder quảng cáo) nơi paywall sẽ xuất hiện: tìm paywall theo tên, rồi dùng + Thêm placeholder để gắn một hoặc nhiều placeholder — mỗi placeholder được gắn hiển thị dưới dạng thẻ bo tròn có thể xóa, kèm huy hiệu số lượng nhỏ. Một placeholder chỉ có thể được ánh xạ tới một paywall tại một thời điểm; khi gán sang paywall khác, hệ thống tự động gỡ placeholder đó khỏi paywall trước.

Khác với các mục còn lại trong Chi tiết ứng dụng, ánh xạ này không bị ràng buộc chặt với chế độ Live/Dev mà bạn đang chọn ở đầu trang. Một ứng dụng thực tế đã cài đặt không tự có trạng thái "Live" hay "Dev" — sự phân biệt đó chỉ nhằm hỗ trợ chuẩn bị và kiểm thử cấu hình ở phía quản trị — vì vậy, khi bạn đã ánh xạ paywall vào placeholder ở một trong hai chế độ và lưu, các thiết bị thực tế có thể tra cứu được ánh xạ đó; bạn không cần lặp lại cùng ánh xạ ở chế độ còn lại chỉ để đưa vào môi trường production.

Chọn MMP

Kết nối một đối tác đo lường di động (Mobile Measurement Partner) — các lựa chọn gồm Adjust, AppsFlyer, Firebase, Cost Center và Solar Engine — đồng thời bật/tắt báo cáo doanh thu quảng cáo theo từng định dạng, để các sự kiện doanh thu quảng cáo được gửi vào hệ thống phân bổ nguồn/ phân tích của bạn cùng với dữ liệu cài đặt và tương tác khác.

Quảng bá tính năng

Cấu hình banner hoặc thẻ quảng bá trong ứng dụng không liên quan đến mạng quảng cáo — chẳng hạn "thông báo tính năng mới" hoặc "giới thiệu gói premium" ngay trong giao diện ứng dụng. Mỗi mục trong bảng có thể chỉnh sửa này gồm tiêu đề, loại, khóa, hình ảnh và một hành động (chẳng hạn deep link hoặc đích điều hướng trong ứng dụng) được kích hoạt khi người dùng chạm vào.

Cài đặt

Các thiết lập khác ở cấp ứng dụng không thuộc những mục trên: bật log console để gỡ lỗi, bật ghi log sự kiện quảng cáo, mức chênh lệch thời gian cho phép đối với thông báo cục bộ, cùng URL Chính sách quyền riêng tư và Điều khoản dịch vụ của ứng dụng (một số mạng quảng cáo và cửa hàng ứng dụng yêu cầu bạn hiển thị các URL này).

Lấy cấu hình

Nhấp Lấy cấu hình để tạo chuỗi cấu hình đã mã hóa, chứa toàn bộ nội dung bạn đã cấu hình ở trên cho chế độ (Live hoặc Dev) đang được chọn. Nếu bạn đã chọn một Nhóm khu vực trong bộ chọn khu vực ở phần đầu trang Chi tiết ứng dụng, liên kết/chuỗi được tạo sẽ kèm ID của nhóm đó dưới dạng tham số truy vấn, để cấu hình được lấy khi chạy có thể khác nhau theo nhóm khu vực. Cổng quản trị cũng hướng dẫn bạn phát hành chuỗi này qua Firebase Remote Config với khóa tham số AKS_AND_LIVE — đây là cách ứng dụng đã phát hành thực sự nhận cấu hình khi chạy, vì bản thân Cổng quản trị không đẩy cấu hình trực tiếp đến thiết bị của người dùng cuối.

Lịch sử thay đổi

Mỗi lần lưu cấu hình ứng dụng, hệ thống ghi nhận một Phiên bản cấu hình mới. Lịch sử thay đổi (trang riêng, truy cập qua liên kết trong Chi tiết ứng dụng) liệt kê mọi phiên bản của ứng dụng trong một bảng: số thứ tự, Phiên bản cấu hình, Mô tả nội dung thay đổi (các mô tả dài được phân tách nội bộ bằng dấu gạch đứng và hiển thị thành các dòng riêng, được rút gọn sau 20 ký tự đầu tiên với nút chuyển "Xem thêm / Thu gọn"), Ngày cập nhật và Người cập nhật. Bộ lọc khoảng ngày ở đầu trang giúp giới hạn danh sách trong một khoảng thời gian cụ thể. Nhờ đó, bạn có nhật ký kiểm tra cơ bản để biết ai đã thay đổi cấu hình ứng dụng và vào lúc nào.

Được chia sẻ với tôi

Nếu một nhóm khác mời bạn cộng tác trên ứng dụng của họ và bạn đã chấp nhận, các tài nguyên được chia sẻ đó sẽ xuất hiện trong Được chia sẻ với tôi (/SharedWithMe) — bảng các lời mời bạn nhận được, tách biệt với ứng dụng do nhóm của bạn sở hữu. Mỗi hàng hiển thị người mời và trạng thái hiện tại của lời mời.

Tại đây, bạn có thể Chấp nhận hoặc Từ chối lời mời đang chờ xử lý. Cả hai thao tác đều gọi cùng endpoint xử lý lời mời với quyết định tương ứng. Sau khi chấp nhận, người mời sẽ xuất hiện trong danh sách thả xuống chuyển đổi tài khoản của bạn (được mô tả ở trên), để bạn có thể chuyển sang tài khoản của họ và làm việc trong phạm vi quyền được cấp.

Nếu bạn truy cập trang này qua liên kết thông báo chứa tham số truy vấn ?invitationId=, Hộp thoại lời mời sẽ tự động mở khi tải trang, thay vì bạn phải tự tìm hàng tương ứng.

Hộp thoại lời mời. Hộp thoại này hiển thị email của tài khoản mời trong một thẻ bo tròn ở phía trên, cùng tiêu đề/biểu tượng tùy theo trạng thái: biểu tượng quà tặng cho lời mời đang chờ xử lý, dấu kiểm cho lời mời bạn đã chấp nhận, dấu X cho lời mời đã từ chối và đồng hồ cho lời mời đã hết hạn. Bên dưới là danh sách cuộn "Quyền truy cập N tài nguyên" — mỗi hàng hiển thị biểu tượng ứng dụng tạm, tên tài nguyên (ví dụ: "Ứng dụng", "Thông tin ứng dụng", được định dạng từ khóa quyền bên dưới) và các huy hiệu căn phải cho biết những quyền bạn sẽ có đối với tài nguyên đó (Đọc / Tạo / Cập nhật / Xóa). Nếu lời mời có ngày hết hạn, một dòng cảnh báo sẽ hiển thị ngày đó.

Các nút ở chân hộp thoại phụ thuộc vào trạng thái: lời mời đang chờ xử lý hiển thị "Để sau" và "✓ Chấp nhận lời mời"; lời mời đã xử lý hoặc hết hạn chỉ hiển thị "Đóng", kèm nội dung giải thích (với lời mời hết hạn, chẳng hạn "Vui lòng yêu cầu {email người mời} gửi lời mời mới").

---