Tích hợp SDK: quảng cáo, analytics, mua trong ứng dụng, đăng nhập mạng xã hội
Kiến trúc lớp bọc SDK (interface TS → adapter nền tảng → bridge → SDK, có bản giả), luồng quảng cáo nhận thưởng và mediation, đồng ý quyền riêng tư (GDPR/ ATT), thiết kế sự kiện analytics, luồng IAP an toàn có xác thực server và khôi phục giao dịch, đăng nhập Google/ Apple/ Facebook và yêu cầu của store.
- “Integrate third-party SDKs”
- “Proven experience integrating mobile SDKs (Ads, Analytics, IAP, Social Login)”
Doanh thu game casual đến gần như hoàn toàn từ quảng cáo và IAP: lỗi ở đây là mất tiền trực tiếp (người chơi xem quảng cáo không nhận thưởng, giao dịch bị hoàn tiền, bị hack nhận vật phẩm miễn phí). Người phỏng vấn kiểm tra cả kỹ thuật lẫn hiểu biết sản phẩm: bạn có nghĩ tới timeout, giao dịch treo, xác thực server, chính sách store hay không.
🎯 Mục tiêu học tập
- Thiết kế lớp bọc SDK độc lập nền tảng
- Cài luồng rewarded ads có timeout và trạng thái
- Xử lý đồng ý quyền riêng tư (UMP/ ATT)
- Thiết kế sự kiện analytics có quy ước
- Cài luồng IAP an toàn và đăng nhập mạng xã hội đúng chính sách
🟢 Kiến trúc lớp bọc SDK
- Bản giả cho editor/ web: phát triển gameplay không cần thiết bị, test luồng phần thưởng ngay.
- Mọi lệnh gửi trước khi SDK khởi tạo xong được xếp hàng hoặc trả lỗi rõ ràng, không im lặng.
- Một giao thức JSON có version giữa script và native giúp thêm tính năng không phá bản cũ.
🟡 Quảng cáo nhận thưởng: luồng đầy đủ
export type RewardResult = 'rewarded' | 'skipped' | 'failed' | 'timeout';
export class RewardedAds {
private busy = false;
constructor(private readonly native: IAdBridge, private readonly analytics: IAnalytics) {}
async show(placement: string): Promise<RewardResult> {
if (this.busy) return 'failed'; // chống bấm đúp/ hai quảng cáo chồng
if (!this.native.isReady(placement)) { this.native.load(placement); return 'failed'; }
this.busy = true;
AudioService.pauseAll(); // tắt âm thanh game khi quảng cáo chạy
this.analytics.log('ad_rewarded_show', { placement });
try {
const res = await withTimeout(this.native.showRewarded(placement), 90_000, 'timeout');
this.analytics.log('ad_rewarded_result', { placement, res });
return res;
} finally {
this.busy = false;
AudioService.resumeAll();
this.native.load(placement); // nạp sẵn cho lần sau
}
}
}
function withTimeout<T>(p: Promise<T>, ms: number, onTimeout: T): Promise<T> {
return Promise.race([p, new Promise<T>(r => setTimeout(() => r(onTimeout), ms))]);
}
// Phát thưởng CHỈ khi nhận callback "rewarded" (không phải "closed").
// Phần thưởng giá trị cao: dùng server-side verification (SSV) của mạng quảng cáo để server cộng thưởng.| Chủ đề | Thực hành tốt |
|---|---|
| Mediation | Một SDK điều phối (AdMob mediation, AppLovin MAX, LevelPlay…) đấu giá giữa nhiều mạng để tăng doanh thu; cập nhật adapter đồng bộ phiên bản |
| Tần suất | Giới hạn interstitial (VD không quá 1 lần/ 2–3 phút, không ngay khi mở game), điều khiển bằng remote config |
| Trải nghiệm | Không hiện quảng cáo giữa thao tác; nút xem quảng cáo chỉ hiện khi đã sẵn sàng |
| Doanh thu | Ghi sự kiện ad_impression kèm doanh thu (nếu SDK cung cấp) vào analytics để tính LTV |
🟡 Quyền riêng tư và đồng ý
| Yêu cầu | Áp dụng | Cách làm |
|---|---|---|
| Đồng ý GDPR/ khu vực có luật tương tự | Người dùng ở EEA, Anh… (và quy định nơi khác) | Nền tảng quản lý đồng ý (VD Google UMP) hiển thị trước khi khởi tạo quảng cáo cá nhân hoá |
| App Tracking Transparency (iOS) | Theo dõi qua app/ IDFA | Hiện hộp thoại ATT trước khi SDK dùng IDFA; tôn trọng từ chối |
| Quảng cáo cho trẻ em | Game hướng trẻ em | Cờ hạn chế nội dung/ không cá nhân hoá theo chính sách SDK và store |
| Khai báo store | Data safety (Play), Privacy nutrition label (App Store) | Khai đúng dữ liệu mọi SDK thu thập |
Hiển thị đồng ý (UMP) → ATT (iOS) → khởi tạo SDK quảng cáo/ analytics với cấu hình tương ứng. Khởi tạo quảng cáo trước khi có đồng ý là lỗi tuân thủ hay gặp.
🟡 Analytics: sự kiện có quy ước
| Sự kiện | Tham số | Trả lời câu hỏi |
|---|---|---|
| tutorial_step | step (1..n) | Người chơi rơi rụng ở bước nào? |
| level_start / level_end | level, result (win/lose/quit), moves_left, duration_s, boosters_used | Màn nào quá khó? |
| ad_rewarded_result | placement, result | Vị trí quảng cáo nào hiệu quả? |
| purchase | product_id, price, currency (store cung cấp) | Doanh thu theo gói |
| economy_change | currency, delta, source/sink | Kinh tế tiền ảo có lạm phát? |
- Tên sự kiện chữ thường, gạch dưới, ổn định; mỗi sự kiện có tài liệu định nghĩa (giống thẻ chỉ số).
- Không gửi dữ liệu cá nhân (email, tên) vào analytics.
- Chú ý giới hạn số sự kiện/ tham số của nền tảng analytics; kiểm tra bằng chế độ debug view trước khi phát hành.
🔴 IAP: luồng an toàn
| Chi tiết | Vì sao quan trọng |
|---|---|
| Google Play: acknowledge (hoặc consume) giao dịch trong thời hạn quy định (vài ngày) | Không xác nhận → giao dịch tự hoàn tiền |
| StoreKit: finishTransaction sau khi đã cộng vật phẩm | Không finish → giao dịch lặp lại mỗi lần mở app; finish quá sớm → mất vật phẩm nếu app crash |
| Xử lý giao dịch treo/ đang chờ (pending) khi mở app | Người chơi đã trả tiền nhưng app crash giữa chừng |
| Cộng vật phẩm luỹ đẳng theo orderId/ transactionId | Callback có thể đến nhiều lần |
| Khôi phục giao dịch (Restore Purchases) | Bắt buộc với non-consumable/ subscription trên iOS |
| Giá hiển thị lấy từ store | Đúng tiền tệ, thuế từng quốc gia |
// Rút gọn: client chỉ là người đưa tin, server là người quyết định
async function buy(productId: string) {
const purchase = await iap.purchase(productId); // native trả token/ receipt
const res = await api.post('/iap/verify', { productId, token: purchase.token, platform: purchase.platform });
if (res.ok) {
inventory.applyServerState(res.inventory); // nhận trạng thái từ server, không tự cộng
await iap.finish(purchase); // acknowledge/ consume/ finishTransaction
}
}
// Khi mở app: iap.getPendingPurchases() → xác thực lại từng giao dịch còn treo
🟡 Đăng nhập mạng xã hội
| Phương thức | Lưu ý |
|---|---|
| Google (Android) | Thư viện đăng nhập hiện hành của Google (Credential Manager); gửi ID token lên server để xác minh chữ ký |
| Sign in with Apple | App Store Review Guidelines (mục Login Services) yêu cầu cung cấp tuỳ chọn đăng nhập đáp ứng các yêu cầu quyền riêng tư khi app dùng đăng nhập bên thứ ba; Sign in with Apple là lựa chọn phổ biến — đọc bản guideline mới nhất |
| Cấu hình key hash/ bundle id; phiên bản SDK và quyền tối thiểu | |
| Tài khoản khách → liên kết | Cho chơi ngay bằng tài khoản khách, liên kết sau để giữ tiến trình; xử lý xung đột khi tài khoản đã có tiến trình |
| Xoá tài khoản | App cho phép tạo tài khoản phải cho phép xoá tài khoản ngay trong app (yêu cầu của App Store) |
Token đăng nhập phải được server xác minh (chữ ký, audience, hạn) trước khi tạo phiên. Client chỉ chuyển token, không tự tin vào user id trả về từ SDK.
🎤 Câu hỏi phỏng vấn thường gặp (trả lời to trước khi mở)
🎤 Thiết kế lớp tích hợp quảng cáo để sau này đổi từ AdMob sang AppLovin MAX dễ dàng.
🎤 Người chơi báo xem quảng cáo xong không nhận thưởng. Bạn điều tra thế nào?
🎤 Mô tả luồng IAP an toàn của bạn.
🎤 Analytics bạn thiết kế gồm những sự kiện nào cho một game puzzle mới?
🎤 Cần chú ý gì về quyền riêng tư khi tích hợp quảng cáo?
⚠️ Sai lầm thường mắc
Vì sao nguy hiểm: Người chơi bỏ giữa chừng vẫn nhận thưởng.
Cách làm đúng: Chỉ phát ở callback rewarded (hoặc SSV).
Vì sao nguy hiểm: Bị hack, giao dịch giả.
Cách làm đúng: Xác thực server, luỹ đẳng.
Vì sao nguy hiểm: Hoàn tiền tự động hoặc mất vật phẩm.
Cách làm đúng: Theo luồng chuẩn, xử lý giao dịch treo.
Vì sao nguy hiểm: Vi phạm quyền riêng tư.
Cách làm đúng: UMP → ATT → init.
Vì sao nguy hiểm: Khó đổi SDK, không test được.
Cách làm đúng: Interface + adapter + bản giả.
Vì sao nguy hiểm: Treo chờ callback mãi.
Cách làm đúng: Timeout + trạng thái rõ ràng.
- Gameplay → interface → adapter → bridge → wrapper native → SDK; có bản giả.
- Rewarded: chống bấm đúp, tắt âm, timeout, thưởng ở callback rewarded/ SSV.
- Đồng ý quyền riêng tư trước khi khởi tạo quảng cáo; ATT trên iOS.
- IAP: server xác thực, luỹ đẳng, acknowledge/ finish đúng lúc, xử lý treo, restore.
- Đăng nhập: server xác minh token; tuân thủ yêu cầu login và xoá tài khoản của store.
🧩 Tự kiểm tra (bấm để xem đáp án)
1. Phát thưởng quảng cáo nên dựa vào:
A. Callback closed
B. Callback rewarded hoặc SSV
C. Thời gian xem
2. Giao dịch Google Play không được acknowledge trong thời hạn sẽ:
A. Vẫn bình thường
B. Tự hoàn tiền
C. Bị khoá tài khoản
3. Cộng vật phẩm luỹ đẳng nghĩa là:
A. Cộng mỗi lần callback
B. Dùng mã giao dịch để chỉ cộng một lần
C. Không cộng
4. Thứ tự đúng trên iOS:
A. Init quảng cáo → ATT
B. Đồng ý (UMP) → ATT → init SDK
C. Không cần đồng ý
5. Token đăng nhập Google nên:
A. Tin user id từ client
B. Gửi lên server xác minh
C. Lưu vào analytics
🏋️ Bài tập thực hành
Viết IAdService, IIapService, IAnalytics, IAuthService (TS) + bản giả có độ trễ và lỗi ngẫu nhiên có seed. Dựng màn test: xem quảng cáo nhận x2 xu, mua gói xu (giả server xác thực), giao dịch treo được xử lý lại khi khởi động, đăng nhập khách → liên kết. Nếu có thiết bị: thay bản giả quảng cáo bằng AdMob test ad unit.
💡 Gợi ý lời giải
📚 Tài nguyên học tập
- Google AdMobQuảng cáo, mediation, test ads, SSVTài liệu
- Google Play BillingLuồng mua, acknowledge, xác thựcTài liệu
- Apple StoreKitGiao dịch, App Store Server APITài liệu
- Firebase AnalyticsSự kiện, tham số, debug viewTài liệu
- App Store Review GuidelinesĐăng nhập, IAP, quyền riêng tưChính sách
✅ Tự đánh giá hoàn thành
- Vẽ kiến trúc lớp bọc SDK
- Viết luồng rewarded có timeout
- Liệt kê yêu cầu quyền riêng tư
- Thiết kế bộ sự kiện analytics
- Viết luồng IAP xác thực server