UNITY ANDROID MONETIZATION & ANALYTICS

INTEGRATION GUIDE
Version 2.0
Platform: Android Only
Unity Version: 2022.3 LTS+
Document Owner: Publishing Team

1. Overview
This document describes the complete integration process for the Android
Monetization Framework.
The framework includes:
 AppLovin MAX Mediation
 Firebase Analytics
 Firebase Remote Config
 Adjust Attribution
 Unity IAP
 EDM4U Dependency Resolver
Supported Ad Formats:
 Banner
 Interstitial
 Rewarded Video
 App Open

2. System Architecture
Application Launch
↓
Firebase Initialization
↓
Remote Config Fetch
↓
Adjust Initialization
↓
Advertisement Initialization
↓
IAP Initialization
↓
Game Ready

3. Required SDKs
3.1 AppLovin MAX Unity SDK
Purpose
Ad mediation and monetization.
Repository
[Link]
Supported Formats
 Banner
 Interstitial
 Rewarded
 App Open
Installation
1. Import MAX Unity Package
2. Open Integration Manager
3. Install required adapters
4. Configure SDK Key
Verification
Expected Log:
MAX SDK Initialized
3.2 Firebase Unity SDK
Purpose
Analytics and Remote Config.
Repository
[Link]
Required Modules
 Firebase Analytics
 Firebase Remote Config
Required File
[Link]
Location
Assets/[Link]
Verification
Expected Log:
Remote Config fetched and applied successfully

3.3 Adjust Unity SDK

Purpose
Attribution and Revenue Tracking.
Repository
[Link]
Required Features
 Install Tracking
 Revenue Tracking
 Purchase Tracking
Verification
Install events appear in Adjust Dashboard.
3.4 EDM4U
Purpose
Dependency Resolution.
Repository
[Link]
Required Action
Assets
→ External Dependency Manager
→ Android Resolver
→ Resolve
Run after importing all SDKs.

4. Installation Order
Install SDKs in the following order:
1. EDM4U
2. Firebase Analytics
3. Firebase Remote Config
4. Adjust
5. AppLovin MAX
6. Unity IAP
After installation:
1. Resolve Dependencies
2. Restart Unity
3. Verify Compilation
4. Configure SDK Keys
5. Build Test APK

5. Scripting Define Symbols

Required Symbols
USE_FIREBASE
USE_MAX_SDK
VIRTUESKY_IAP
Location
Project Settings
→ Player
→ Scripting Define Symbols

6. Advertisement Framework
AdvertisementManager is the central controller for all advertising features.
Supported Ad Formats

Format Supported
Banner Yes
Interstitial Yes
Rewarded Yes
App Open Yes

7. Advertisement Configuration
Banner
Required Fields
Android Banner Ad Unit ID
Example
maxBannerAdUnitId_Android

Interstitial
Required Fields
Android Interstitial Ad Unit ID
Example
maxInterstitialAdUnitId_Android

Rewarded
Required Fields
Android Rewarded Ad Unit ID
Example
maxRewardedAdUnitId_Android

App Open
Required Fields
Android App Open Ad Unit ID
Example
maxAppOpenAdUnitId_Android

8. Remote Config Variables

The following Firebase Remote Config keys are mandatory.

Key Type Default

enable_open_ad Boolean true
enable_banner_ad Boolean true
enable_inter_ad Boolean true
enable_reward_ad Boolean true
inter_ad_from_level Integer 10
inter_ad_level_inter Integer 1
val
reward_bonus_from Integer 1
_level
aoa_first_show_sess Integer 2
ion
aoa_resume_first_s Integer 1
Key Type Default
how_day
battle_pass_start_d String 2026-05-
ate 27T00:00:00

9. Ad Placement Rules
Interstitial
Recommended Placements
after_level_complete
after_level_failed
before_next_level
shop_exit
Rules
 First Show Level = 10
 Interval = Every 1 Level
Controlled via Remote Config.

Rewarded
Recommended Placements
extra_coin
extra_life
hint
booster
skip_level
Rewarded ads must always be user initiated.

App Open
Display Conditions
Application Launch
Application Resume
Controlled through Remote Config.

10. Advertisement API

Interstitial
Show Interstitial
[Link](
currentLevel,
"after_level_complete"
);

Rewarded
Show Rewarded
[Link](
"extra_coin",
OnRewardSuccess
);

Banner
Show Banner
[Link]();

Hide Banner
[Link]();

11. Analytics Events

Gameplay
level_start
level_end
tutorial_action
session_start

Ads
ad_request
ad_impression
ad_click
ad_complete
ad_load_failed
ad_display_failed

IAP
iap_show
iap_purchase_success
iap_purchase_failed

Economy
resource_earn
resource_spend

12. Event Parameters

ad_request
Parameter
ad_format
ad_platform
ad_network
Parameter
ad_unit_id
placement
is_load
load_time

ad_impression
Parameter
ad_format
ad_platform
ad_network
ad_unit_id
placement
revenue

ad_complete
Parameter
ad_format
placement
duration_ad
reward_type
end_type

13. Unity IAP

Supported Product Types
 Consumable
 Non-Consumable
Purchase Flow
User Purchase
↓
Store Validation
↓
Purchase Success
↓
Grant Reward
↓
Firebase Event
↓
Adjust Event

14. QA Test Cases

Test Case 01
Banner Ad
Expected Result
Banner displays correctly.

Test Case 02
Interstitial Ad
Expected Result
Interstitial displays and closes successfully.

Test Case 03
Rewarded Ad
Expected Result
Reward is granted after completion.

Test Case 04
App Open Ad
Expected Result
App Open displays on launch.

Test Case 05
Remote Config
Expected Result
Values update without client update.

15. Troubleshooting
Firebase Not Working
Verify:
 [Link]
 EDM Resolve
 Internet Connection

Ads Not Showing

Verify:
 Ad Unit IDs
 Remote Config Values
 Fill Rate
 SDK Initialization

Build Failed
Run:
Assets
→ External Dependency Manager
→ Android Resolver
→ Resolve
Then rebuild.
16. Release Checklist
Development
□ Firebase Installed
□ Remote Config Installed
□ Adjust Installed
□ MAX Installed
□ IAP Installed
□ Dependencies Resolved
QA
□ Banner Tested
□ Interstitial Tested
□ Rewarded Tested
□ App Open Tested
□ Analytics Verified
□ Revenue Tracking Verified
Production
□ Test Ads Disabled
□ Production Ad Units Assigned
□ Firebase Production Config Installed
□ Adjust Production Token Installed
□ Release Approved
END OF DOCUMENT