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.
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
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.
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.
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“.
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“.
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”).
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”).
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.”