# Ad Spaces
# What are Ad Spaces?
An Ad Space is a single-sided virtual billboard. It is the tool that enables game developers to place revenue-raising advertisements easily and intrinsically within game environments without interfering with performance or experience.
# Ad Space Configurations
Each Ad Space has configurable properties that determine how it will function in your game.
# Ratios
Frameplay offers a variety of horizontal and vertical Ad Space ratios designed to fit in your game environments. There are 12 supported ratios: 3:2
, 2:3
, 4:3
, 3:4
, 16:9
, 9:16
, 21:9
, 9:21
, 40:9
, 9:40
, 60:9
, 9:60
, and 1:1
.
# Content Type
Content type describes the format of advertisement and refresh period of the Ad Space content.
Static
Ad Spaces will load a single advertisement that will continue to display until the object is despawned.
Dynamic
Ad Spaces will attempt to load a new advertisement every 60 seconds. Similar to a real world electronic billboard.
# 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.
For example:
- A High quality 40:9 ratio Ad Space will have a maximum texture size of 8192x2048.
- A Low quality 1:1 ratio Ad Space will have a maximum texture size of 256x256.
Quality and Resolution can also be controlled at a global level. See our Frameplay Data Asset page for more information.
# Placeholder Materials
Ad Spaces will not always have an advertisement loaded. A Placeholder Material will be displayed instead. The default material is the Frameplay Placeholder.
You can customize this Placeholder with your own texture to fit your environment.
Ad Spaces can also be set to remain hidden until an advertisement is loaded with the Place Holder Visible During Play
property.
See our Best Practices Guide on how to preserve your game environment style by utilizing Placeholders.
# 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 Frameplay Session is started and a Camera is registered
- The Ad Space functionality isn't paused (Is Active On Enable is true)
- An Activation Collider is setup, and a collision is detected with the registered camera