# Ad Spaces
# What are Ad Spaces?
An Ad Space is a single-sided virtual billboard placed within in-game environments, that raise advertising revenue without interrupting the players experience at runtime.
Frameplay offers a variety of horizontal and vertical Ad Space ratios designed to fit in your game environments, and be used at your discretion.
# Ad Space Configurations
Each Ad Space has configurable properties that determine how it will function in your game.
There are 11 supported Ad Space ratios you can implement in your game. They include
# Content Type
Content type describes the format of advertisement and refresh period of the Ad Space content.
# Static Image
Ad Spaces will load a single advertisement that will continue to display until the object is despawned.
# Dynamic Image
Ad Spaces will attempt to load a new advertisement every 60 seconds. Similar to a real world electronic billboard.
# Instance Type
Instance type describes how and where an Ad Space should spawn. This feature also enables you to determine which advertisements are performing best within your games environment.
# Single Instance Ad Space
Choose the Single Instance type option for Ad Spaces with a fixed location in your game environment.
# Multi Instance Ad Space
This option is designed for an environment that has replicated components. For example, a procedurally generated level. The performance of an Ad Space that does not have a fixed location is more difficult to determine.
The performance of each Ad Space is easily trackable on the Frameplay Dashboard.
# Placeholder Materials
Ad Spaces will not always have an advertisement loaded. When an advertisement is not loaded, a fully customizable Placeholder Material is displayed instead.
Ad Spaces can also be set to remain invisible when an advertisement is not loaded.
See our Best Practices Guide on how to preserve your game environment style by utilizing Placeholders.
# Quality and Resolution
Each Ad Space has a quality scale multiplier that affects the displayed advertisement texture size. Setting this value to either high, medium or low determines the maximum resolution.
- A High quality 1:1 ratio Ad Space will have a maximum texture size of 1024x1024.
- A Low quality 40:9 ratio Ad Space will have a maximum texture size of 4096x1024.
Quality and Resolution can also be controlled at a global level. See our Frameplay Data Asset page for more information.
# Ad Space Activation
When an Ad Space is activated, an advertisement is requested from Frameplay's servers, downloaded and displayed.
Activation will occur if the following criteria is met:
The Ad Space is not paused.
A Game Camera is registered.
If an Activation Collider is present and comes in contact with a registered camera, an advertisement will load. If a collider is not setup, activation will occur when the Ad Space is spawned.
An Activation Collider is a defined volume or area, typically surrounding an Ad Space, that is triggered by contact with the registered camera. More information on Activation Colliders