Đo lường từng game.
Quảng cáo đúng lúc.
Cấu hình Google Analytics và các mạng quảng cáo từ Admin. Mỗi game và mỗi bản phát hành lên cổng game có thể dùng một cấu hình riêng.
Mở Analytics ↗ · Mở Quảng cáo ↗ · Tài liệu đầy đủ
Google Analytics 4
- Tạo Web data stream trong GA4, lấy Measurement ID dạng
G-.... - Trong Admin → Analytics, chọn game, chọn cấu hình riêng, nhập ID. Bật Analytics và đặt tỷ lệ lấy mẫu lớn hơn 0.
- Lưu nháp, kiểm tra thay đổi rồi xuất bản. Kết nối CMP để truyền lựa chọn của người chơi vào SDK.
- Bật DebugView khi kiểm thử; xác nhận dữ liệu trong GA4 Realtime / DebugView rồi tắt chế độ debug.
SDK gắn game_id, phiên bản, ngôn ngữ và target vào từng sự kiện; sự kiện được gửi đến đúng Measurement ID đã chọn. Admin hiển thị trạng thái cấu hình. Số liệu truy cập được xem trong Google Analytics.
veno.track('g_hint_used', { level: 4, source: 'rewarded' });
veno.analytics.flush();
console.log(veno.analytics.getStatus());
Nền tảng quảng cáo được hỗ trợ
| Provider | Định dạng | Yêu cầu |
|---|---|---|
| Google AdSense H5 | Interstitial, rewarded | Publisher ID và tài khoản H5 được duyệt |
| CrazyGames | Interstitial, rewarded | Game được tiếp nhận trên CrazyGames |
| Poki | Interstitial, rewarded | Game được tiếp nhận trên Poki |
| GameDistribution | Interstitial, rewarded | Game ID của nền tảng |
| GameMonetize | Interstitial | Game ID; rewarded chưa hỗ trợ |
| Mock | Mô phỏng nội bộ | Không tạo doanh thu |
| AdMob bridge | Qua ứng dụng native | Cần triển khai plugin Capacitor VenoAds |
Chọn provider trong Admin → Quảng cáo. Đặt giới hạn đầu phiên, khoảng cách quảng cáo, số lần tối đa và bật/tắt từng placement. Một provider cho mỗi game/target. Bản này chưa có banner display hoặc waterfall giữa các mạng.
// Gọi khi người chơi chủ động chọn xem quảng cáo nhận thưởng.
const result = await veno.ads.rewarded('hint');
if (result.granted) giveHint();
console.log(veno.ads.getStatus());
Consent và kiểm thử
Chưa có ID hoặc CMP thì giữ dịch vụ tắt. SDK chỉ tải dịch vụ sau khi nhận đồng ý. CMP cần kiểm tra cả mục đích sử dụng và vendor trước khi gọi:
veno.consent.set({
analytics: analyticsAllowed,
ads: selectedAdVendorAllowed,
personalized: personalizationAllowed
});
Demo, clean và quay video không gửi Analytics hoặc quảng cáo. SDK chờ tín hiệu hoàn tất rewarded trước khi trả thưởng, tạm dừng và tắt tiếng game khi quảng cáo chạy, khôi phục khi kết thúc hoặc hết thời gian chờ. Các kiểm thử adapter dùng callback giả lập; ad fill và doanh thu thực tế cần được xác nhận bằng tài khoản đã duyệt.
Hướng dẫn theo nền tảng: Google Analytics · AdSense H5 · CrazyGames · Poki · GameDistribution · GameMonetize.