# Alpha Ads - AdColony Integration

**Engine:** UE4 4.27 | **Platform:** Android | **Version:** 1.0 | **Author:** Alpha XP

**Documentation:** https://alpha-xp5-ai.github.io/advertisement/AdColony/

---

## Overview

Alpha Ads - AdColony Integration exposes rewarded video, banner, interstitial, native, app open ads to UE4 Blueprint projects on Android. No C++ required.

## Features

- Banner, Interstitial, Rewarded Video, Native, and App Open ad formats
- Full Blueprint API — no C++ required
- Event delegates for all ad lifecycle callbacks (Loaded, Failed, Shown, Clicked, Closed, Rewarded)
- Game Instance Subsystem access from any Blueprint
- GDPR / CCPA / COPPA consent API
- Test mode toggle for development builds
- Bundled SDK — zero external download or setup
- Android armv7 + arm64 support
- Project Settings panel for credentials (App ID, Zone IDs)
- UE 4.27 compatible

## Third-Party SDK

| Field | Value |
|---|---|
| SDK | AdColony v4.8.0 |
| Provider | Digital Turbine |
| License | AdColony Publisher SDK License |
| File | `Source/ThirdParty/AdColonySDK/AdColonySDK.jar` |
| Site | https://www.adcolony.com |

> You must independently agree to the AdColony terms and set up your own account.

---

## Setup

1. Copy plugin to your project Plugins/ directory.
2. Enable in Edit > Plugins.
3. Enter credentials in Edit > Project Settings > Alpha Ads - AdColony Integration.
4. Rebuild and package Android Shipping.

---

## Example Project

A minimal demo project is included with the plugin download under `/ExampleProject`. It contains:

- A sample Level (`L_AdsDemo`) with UMG buttons for each ad format
- A demo Blueprint (`BP_AdsManager`) showing init, load, show, and event-binding flow
- Pre-configured Project Settings using AdColony test App ID / Zone IDs
- Ready-to-package Android Shipping config (armv7 + arm64)

Open `ExampleProject/AdsDemo.uproject` in UE 4.27, enable the plugin, and Launch on an Android device to verify integration.

---

## License

Integration code is subject to the Fab product page terms. Bundled SDK files have their own licenses (see ThirdPartyNotices.md).