Apps Kit SDK logoApps Kit SDK
Tài liệu · Cổng quản trị Apps Kit SDK

Mẫu quảng cáo native

Mẫu quảng cáo native là nơi bạn thiết kế bố cục hiển thị thực tế của quảng cáo native ngay trên Portal, thay vì cung cấp bố cục quảng cáo native bằng mã trong ứng dụng. Đây là phần cấu hình trên Portal tương ứng với lệnh gọi showTemplatedNative() của SDK (AdsManager.showTemplatedNative trên Android, AppsKitSDKAdsManagerIOS.instance.showTemplatedNative trên iOS): mẫu được cấu hình cho một placeholder tại đây chính là mẫu mà lệnh gọi SDK đó sẽ hiển thị khi chạy — ứng dụng không truyền bất kỳ tài nguyên bố cục nào (không có res/XIB), vì thiết kế được lưu tại đây.

Danh sách mẫu

Trang Ad Templates (trên thanh bên, cùng nhóm với Brands và Region Groups) liệt kê tất cả mẫu quảng cáo native bạn đã thiết kế dưới dạng bảng.

1786548205099-Screenshot_2026-08-12_at_8.22.34_PM.png

Mỗi hàng hiển thị: số thứ tự, ảnh thu nhỏ xem trước bố cục ở cột Image, tên mẫu ở Template Name, số lượng thành phần ở Elements (số khối thành phần có sẵn — biểu tượng, tiêu đề, nội dung đa phương tiện, CTA, v.v. — mà mẫu thực sự sử dụng), nhãn trạng thái Status (Published — Đã xuất bản hoặc Draft — Bản nháp), ngày tạo Created At / ngày cập nhật Updated At có thể sắp xếp, và menu Actions. Ô tìm kiếm lọc theo tên; các menu thả xuống Filter, Status và Brand giúp thu hẹp danh sách hơn nữa, còn Clear All dùng để xóa toàn bộ bộ lọc. Phần phân trang sử dụng cùng định dạng chân trang "Showing X of Y" (Hiển thị X trên tổng số Y) như các trang khác trên Portal. Nhấp + Create Template để tạo mẫu mới, hoặc nhấp vào một hàng hiện có để mở mẫu trong trình chỉnh sửa Canvas bên dưới.

Thiết kế mẫu (Canvas)

Khi mở một mẫu — mới hoặc đã có — bạn sẽ được đưa đến trình chỉnh sửa Canvas để xây dựng bố cục theo từng thành phần.

1786548453622-Screenshot_2026-08-12_at_8.27.14_PM.png

  • Elements (bảng bên trái) — các khối thành phần có sẵn cho quảng cáo native: biểu tượng, tiêu đề, nhà quảng cáo, nhãn được tài trợ, điểm xếp hạng, mô tả, nội dung đa phương tiện, giá, cửa hàng và nút CTA. Chỉ những thành phần hiện được đặt trên canvas mới ở trạng thái hoạt động (đây là số lượng được hiển thị ở cột "Elements" trên trang danh sách); các thành phần còn lại vẫn bị làm mờ trong bảng cho đến khi bạn thêm chúng. Tập hợp này tương ứng chính xác với những gì một đối tượng quảng cáo native có thể cung cấp — bạn đang chọn những tài nguyên quảng cáo native của chính mạng quảng cáo để đưa vào bố cục và cách bố trí chúng, chứ không tạo các trường tùy chỉnh.
  • Canvas (ở giữa) — bản xem trước trực tiếp của bố cục theo kích thước thực tính bằng dp, với nút chuyển Labels / Sample data để xem trước bằng nhãn giữ chỗ hoặc nội dung mẫu gần với thực tế, các nút điều khiển thu phóng, tùy chọn Import XML (nhập bố cục Android có sẵn thay vì tạo từ đầu), và Reset to start để hủy các thay đổi, đưa mẫu về trạng thái được lưu gần nhất.
  • Canvas properties (bảng bên phải) — vị trí và kích thước (menu thả xuống Size preset, cùng các trường chiều rộng Width / chiều cao Height, mỗi trường có thể được đặt độc lập thành một giá trị cố định, match_parent hoặc wrap_content), giao diện (màu nền Background color dưới dạng ô màu + giá trị hex, và bán kính bo góc Corner radius), và khoảng đệm Paddings (Trái / Trên / Phải / Dưới, mỗi mục có nút tăng giảm riêng).

Nút chuyển Draft / Live bên cạnh tiêu đề (kèm biểu tượng bút chì để đổi tên mẫu ngay tại chỗ) quyết định mẫu đã đủ điều kiện để gán cho placeholder hay chưa — mẫu ở trạng thái Draft sẽ không xuất hiện dưới dạng tùy chọn có thể sử dụng ở bất kỳ nơi nào khác. Nút Save changes vẫn bị vô hiệu hóa cho đến khi bạn thực sự chỉnh sửa nội dung nào đó, giống cơ chế không cho lưu khi chưa có thay đổi được áp dụng trên toàn Portal.

Cấu hình phạm vi sử dụng mẫu

Nhấp Configure trong trình chỉnh sửa Canvas để mở hộp thoại Configure Template Availability — đây là bước cho phép một ứng dụng hoặc thương hiệu cụ thể sử dụng mẫu, tách biệt với bước thiết kế.

1786548681524-Screenshot_2026-08-12_at_8.30.53_PM.png

Hộp thoại gồm hai cột lựa chọn, có cấu trúc giống bước Publishing trong trình hướng dẫn Campaign (phần Brands ở bước Targeting, với lựa chọn "All Brands" hoặc danh sách chọn từng thương hiệu/ứng dụng cụ thể):

  • Brands (bên trái) — chọn ô tổng All brands để chọn tất cả thương hiệu, hoặc chọn từng thương hiệu cụ thể trong danh sách có hỗ trợ tìm kiếm. Các thương hiệu đã chọn cũng được hiển thị dưới dạng thẻ có thể xóa ở phía trên danh sách.
  • Apps (bên phải) — hiển thị các ứng dụng theo những thương hiệu được chọn ở bên trái, phân nhóm theo thương hiệu. Mỗi nhóm thương hiệu có tùy chọn chọn nhanh All apps (inc. future) để bao gồm mọi ứng dụng thuộc thương hiệu đó — cả hiện tại lẫn tương lai — mà không cần chọn từng ứng dụng; hoặc bạn có thể đánh dấu từng ứng dụng cụ thể. Các ứng dụng đã chọn cũng được hiển thị dưới dạng thẻ.

Nhấp Done để lưu phạm vi sử dụng. Chỉ khi mẫu vừa ở trạng thái Live, vừa được cho phép sử dụng cho một ứng dụng/thương hiệu tại đây, bạn mới có thể chọn mẫu đó khi gán mẫu quảng cáo native cho placeholder trong phần cấu hình ứng dụng bên dưới.

Gán mẫu cho placeholder

Quay lại bảng App Details → Ad Placeholders → Ad Units for Ad Placeholders của ứng dụng (được mô tả ở trên, trong phần App Details), cột Native hoạt động tương tự các cột Interstitial / Banner / Rewarded — bạn có thể thêm một hoặc nhiều placement cho mỗi placeholder và sắp xếp lại theo mức độ ưu tiên để chuyển sang placement dự phòng khi có lỗi — nhưng cột này còn có biểu tượng mẫu bên cạnh tiêu đề, vì placement quảng cáo native cần được gán thiết kế, chứ không chỉ đơn vị quảng cáo.

1786549032156-Screenshot_2026-08-12_at_8.36.46_PM.png

Nhấp vào biểu tượng đó để mở Configure Native Template, với phạm vi áp dụng là tất cả placeholder quảng cáo native hiện hiển thị trong bảng (tiêu đề hộp thoại nêu rõ phạm vi, ví dụ: "All native placeholders (10)" — Tất cả placeholder quảng cáo native (10)).

1786549069198-Screenshot_2026-08-12_at_8.37.30_PM.png

Tìm và chọn một mẫu trong số các mẫu được cho phép sử dụng cho ứng dụng này (theo phần Configure Template Availability ở trên), sau đó nhấp Apply Template để gán mẫu cho toàn bộ phạm vi chỉ bằng một thao tác, thay vì mở riêng thẻ Native của từng placeholder. Sau khi áp dụng, mọi placeholder trong phạm vi đó gọi showTemplatedNative() khi chạy đều hiển thị theo thiết kế của mẫu này — đây là cơ chế kết nối mẫu bạn thiết kế tại đây với quảng cáo native thực tế hiển thị trong ứng dụng, tương tự cách Cross Promotion (được mô tả trong phần Ad Units for Ad Placeholders, thuộc App Details ở trên) kết nối một Campaign với một placement quảng cáo đang hoạt động.