# 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.

Image

# 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 11 supported ratios: 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 9:21, 40:9, 9:40 and 1:1.

Ad Space 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.

For example:

  • 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.

Image

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

Read more about Ad Space implementation in your preferred game engine: Unity, Unreal or Lumberyard.

Last Updated: 7/14/2020, 9:11:29 AM