Targeting Ads on OneCMS Apps with Google Ad Manager

Apps Trafficking Ads to your App using GoogleAd Manager Targeting Ads on OneCMS Apps with Google Ad Manager

Below are the targeting parameters for running advertisements on OneCMS apps using Google Ad Manager using Key Values.

Key-values are parameters included in the ad request that allow you to define custom targeting.

Need a bit more info on Key Values? Check out this short tutorial.

Views

Each screen in your app is associated with a unique view value. You can use these values to place your line item in specific areas of your app.

When targeting a view, your advertisement will appear on the corresponding screen, unless you specify additional parameters such as key values for content, category, or other criteria.

The available view values are:

  • home
  • post
  • gallery
  • podcast
  • stream
  • video
  • chat
  • app-open (used for interstitial on app open)

TARGETING CONTENT SCREENS OR CATEGORIES

You can target display banners to specific screens or categories with the app.  This will display advertisements from the Ad Unit associated with Ad Banners within your App Manager.

ad banners settings app

All custom targeting options are listed below. You only need to use the key-value pairs that are relevant to the content you want the advertisement to display on, not all the values listed.
Action Description Custom Targeting Options
Home Screen There are four 320×50 ad slots on the home screen (between each category carousel / listing)
view=home

optional parameters:

pos=1
pos=2
pos=3
pos=4
Posts Displays one 320X50 advertisement at the top of articles
view=post

optional parameters:

categories=category1-slug,category2-slug
title=page-name-slug
id=post-id
Podcast & Podcast Episode Screens Displays one 320X50 advertisement at the top of the Podcast screen as well as each individual episode screens
view=podcast


optional parameters:

title=podcast-name-slug
id=podcast-id
Gallery & Slideshow Screens Displays one 320X50 advertisement at the top of a Gallery screen and at the bottom of a gallery slideshow
view=gallery

optional parameters:

title=gallery-name-slug
id=gallery-id
OneCMS Video Screens Displays one 320X50 advertisement at the top of  individual OneCMS video episode screens
view=video

optional parameters:

playlist=playlist-title-slug
title=video-name-slug
Expanded Player Screen When opening the Playerbar to get more details (swipe up on player) a 300X250 banner can display in expanded view
view=stream

or

view=podcast

optional parameters:

title=stream-name-slug or podcast-name-slug
Category Listing Screens Displays one 320X50 advertisement at the top of category
categories=category1-slug,category2-slug
All Other Views / Screens No Targeting available, load 320×50 banner Ad None

STREAMING / PODCAST PLAYER

You can traffic video or audio ads (with a companion display banner) to play before a podcast episode or stream begins. The advertisement will serve from the Ad Unit associated with the Video Ads Vast Tag within your App Manager.

IMPORTANT! If you do not target a view when trafficking VAST line items, the item will be Run of Site, meaning it will play before every podcast episode, every stream and also on all push notifications. Be sure to select a view!

videos ads app setting

Action Description Custom Targeting Options
Play Stream When playing the live stream a video or audio ad can play before the stream begins
view=stream

optional parameters:

title=stream-name-slug
Play podcast When playing a podcast episode, a video or audio ad can play before the episode begins
view=podcast

optional parameters:

title=podcast-name-slug
id=podcast-id

PUSH NOTIFICATION INTERSTITIALS

For each of the following scenarios, the interstitial is triggered from a push notification. The advertisement will serve from the Ad Unit associated with the Video Ads Vast Tag within your App Manager.

videos ads app setting

Action Description Custom Targeting Options
Push notification received for a POST When a user clicks a push notification and is brought to the app, an interstitial ad can be displayed before they access the content.
view=post

optional parameters:

categories=category1-slug,category2-slug
title=page-name-slug
id=post-id
Push notification received for a GALLERY When a user clicks a push notification and is brought to the app, an interstitial ad can be displayed before they access the content.
view=gallery

optional parameters:

title=gallery-name-slug
id=gallery-id
Push notification received for a YOUTUBE OR ONECMS VIDEO When a user clicks a push notification and is brought to the app, an interstitial ad can be displayed before they access the content.
view=video

optional parameters:

playlist=playlist-title-slug
title=video-name-slug
Push notification received for an AUDIO EPISODE When a user clicks a push notification and is brought to the app, an interstitial ad can be displayed before they access the content.
view=podcast

optional parameters:

title=podcast-name-slug
id=podcast-id

Some Targeting Examples

Home screen 320 X 50 (between categories)

  • If you wish to specifically target the homepage with an ad and you are not particular about its placement, you can target “view=home.” The ad slots will fill with available inventory you have that matches in no particular order.
  • However, if I want to target the first ad slot on the home screen, you can also target “pos=1“.

homescreen pos 1

Posts Detail Screen 320X50

  • If your aim is to target all post pages, you can target “view=post.”
  • However, if I wish to exclusively target specific post categories, for example, news and sports, you can also target “categories=news,sports“.

ad above post app

Gallery Detail Screen and Slideshow (320X 50)

  • If you want to target all galleries, you should target “view=gallery.”
  • However, if you want to target a particular gallery, you have two options: You can target it using the gallery title slug (e.g., “title=she-rock-awards”) or its gallery ID (e.g., “id=34566”).

gallery ads

Podcast Listing Screen / Podcast Screen / Podcast Episode Screen (320X50)

  • If you wish to target all podcasts,  use “view=podcast.”
  • However, if you want to target a particular podcast, you have two options: You can target it using the podcast title slug (e.g., “title=the-youjoint-podcast”) or its podcast ID (e.g., “id=98745”).

app podcast display ad

 

Expanded Player Screen (300×250)

  • To target the 300×250 display banner in the expanded slide out player while streams and podcasts play, you should use “view=stream” and “view=podcast.”
  • For specific targeting of a stream or podcast, use the respective stream or podcast slug, such as “title=donut-media-stream” or “title=my-podcast-name.”

ad in expanded player

Loading...