Contents

BannerAdvertisement

The component for adding a full-width banner ad.

Declaration

object BannerAdvertisement

Properties

NameTypeDescription
role Requiredstring

Always banner_advertisement for this component.

anchorAnchor

An object that defines vertical alignment with another component.

animation(ComponentAnimation | string("none"))

An object that defines an animation the component applies

Use the none value for conditional design elements. Adding it here has no effect.

bannerTypestring

The type of banner to show.

behavior(Behavior | string("none"))

An object that defines behavior for a component, like Parallax or Springy.

The none value is used for conditional design elements. Adding it here has no effect.

conditional(ConditionalComponent | [ConditionalComponent])

An instance or array of component properties that can be applied conditionally, and the conditions that cause them to be applied.

hiddenboolean

A Boolean value that determines whether the component is hidden.

identifierstring

An optional unique identifier for this component. If used, this identifier must be unique across the entire document. You will need an identifier for your component if you want to anchor other components to it.

layout(ComponentLayout | string)

An inline ComponentLayout object that contains layout information, or a string reference to a ComponentLayout object that is defined at the top level of the document.

If layout is not defined, size and position will be based on various factors, such as the device type, the length of the content, and the role of this component.

style(ComponentStyle | string | string("none"))

An inline ComponentStyle object that defines the appearance of this component, or a string reference to a ComponentStyle object that is defined at the top level of the document.

The none value is used for conditional design elements. Adding it here has no effect.

Mentioned in

Discussion

The BannerAdvertisement object spans the full width of your display. A range of different banner heights are available depending on the availability of advertising content through Advertising Platforms.(An advertisement can appear inside a Container component only if the container is full-width.)

Keep these points in mind when including a banner advertisement in your article:

  • Do not apply animations, scenes, or behaviors to advertisement components.

  • Advertisements placed on the first “screen” of the article will not be rendered—with one exception: short articles that are only one screen can render one ad.

  • The dimensions of visible areas vary with screen size and text size.

  • If two or more advertising components are placed on the same screen, only the first will be rendered.

  • Do not position advertising components immediately before or after images.

  • For the bannerType property, choose only one value. The default value, any, allows any standard, double-height or large-banner advertisement to serve within a specific placement, based on availability.

For information about medium, fixed-sized advertisements, see MediumRectangleAdvertisement.

Example

{
  "components": [
    {
      "role": "banner_advertisement",
      "bannerType": "standard"
    }
  ]
}

See Also

Advertisements