# Ad Spaces
# What is an Ad Space?
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.
Frameplay offers a variety of horizontal and vertical Ad Space ratios designed to fit in your game environments. There are 11 supported ratios:
# 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.
# Instance Type
Instance type describes how and where an Ad Space will spawn.
Single Instance Ad Spaces have a fixed location in your game environment. For each play through Ad Spaces set to Single Instance should remain in the same position.
Multi Instance Ad Spaces can be spawned at different positions and have duplicated instances. They are designed for environments with components that are replicated or spawned programmatically.
For example, a procedurally generated level would contain Multi Instance Ad Spaces.
# 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 by using
Place Holder Visible During Play.
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