Skip to content

added mopub set up for rewarded videos #2342

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Sep 17, 2020
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions _data/sidebar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -1104,6 +1104,22 @@
sectionTitle:
subgroup: 0

- sbSecId: 3
title: Setup Rewarded Video Line Items For MoPub
link: /prebid-mobile/adops-setup-rewarded-video-mopub.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 0

- sbSecId: 3
title: Setup Full Screen Video Line Items For MoPub
link: /prebid-mobile/adops-setup-full-screen-video-mopub.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 0

- sbSecId: 3
title: Setup Native Ads
link: /prebid-mobile/adops-native-setup.html
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
92 changes: 46 additions & 46 deletions guide.md

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions prebid-mobile/adops-line-item-setup-mopub.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,12 @@ sidebarType: 3



# Step by Step Line Item Setup for MoPub
# Step-by-Step Line Item Setup for MoPub

* TOC
{:toc }

This page describes step by step how to set up Prebid Mobile line items for MoPub to serve ads on app with the Prebid SDK. It is using the Universal Prebid Creative.
This page provides step-by-step instructions to set up Prebid Mobile line items for MoPub to serve ads on app with the Prebid SDK. It is using the Universal Prebid Creative.

## Step 1. Add a line item

Expand Down
57 changes: 57 additions & 0 deletions prebid-mobile/adops-setup-full-screen-video-mopub.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
---
layout: page_v2
title: Setup Rewarded Video for MoPub
description: Setup Full Screen Video for MoPub
pid: 1
top_nav_section: prebid-mobile
nav_section: prebid-mobile-adops
sidebarType: 3
---

# Step-by-Step Line Item Setup for Full-screen Video on MoPub

* TOC
{:toc }

This page provides step-by-step instructions to set up full-screen video line items on MoPub to be used with the Prebid Mobile SDK.

## Step 1. Create full screen adUnit
<img src="/assets/images/ad-ops/mopub/full/mopub-lineitem-full-adunit.png">&nbsp;&nbsp;

## Step 2. Add a line item
In the *Add a Line Item* section:
1. For the *Type and Priority* settings, select *Non-Guaranteed* as the type and set the priority to *12*. This ensures the line item will compete with all other demand.
2. Set the Rate to the price you want to target.&nbsp;
<img src="/assets/images/ad-ops/mopub/rewarded/mopub-lineitem-rewarded.png" width="1000" height="544" alt="MoPub Line Item Settings">&nbsp;&nbsp;
3. In the *Advanced Targeting* section, set the target for *Keywords* to `hb_pb:0.50`&nbsp;
<img src="/assets/images/ad-ops/mopub/rewarded/mopub-lineitem-advanced.png" width="1000" height="254" alt="MoPub Line Item Advanced Settings">&nbsp;&nbsp;

For each level of pricing granularity required, one line item/creative pairing will need to be set up.

Line items must be set up to target custom keywords that include bid price information. The bid price keywords will contain how much the buyer bid on the impression.

Prebid Mobile, by default, will send the highest bid price to MoPub using the keyword `hb_pb` but will also submit the key `hb_pb_BIDDERCODE` for each bidder. You can decide to create one set of line items for all bidders or one set of line items for each bidder.

## Step 3. Add creatives to your line item
Full-screen video creatives must have a *VAST tag* with the *Format* set to *Fullscreen* that includes the code below:
```
<VAST version="2.0">
<Ad id="1">
<Wrapper>
<AdSystem>MoPub</AdSystem>
<VASTAdTagURI><![CDATA[https://%%KEYWORD:hb_cache_host%%%%KEYWORD:hb_cache_path%%?uuid=%%KEYWORD:hb_uuid%%]]></VASTAdTagURI>
<Impression><![CDATA[{PATH TO CREATIVE}]]></Impression>
</Wrapper>
</Ad>
</VAST>
```
<br>
<img src="/assets/images/ad-ops/mopub/full/mopub_lineitem_full_vasttag.png" alt="MoPub VAST tag code">&nbsp;&nbsp;

The `hb_uuid` variable value is the cache id that will load the ad markup from the bid stored in Prebid Cache. Within each line item, for each ad unit size, there should be one creative with this content.

The XML can be constructed by providing the VAST tag URL as:
`https://%%KEYWORD:hb_cache_host%%%%KEYWORD:hb_cache_path%%?uuid=%%KEYWORD:hb_uuid%%`

## Step 4. Duplicate line items
Duplicate your line items according to your [price granularity](/prebid-mobile/adops-price-granularity.html) setting.
55 changes: 55 additions & 0 deletions prebid-mobile/adops-setup-rewarded-video-mopub.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
layout: page_v2
title: Setup Rewarded Video for MoPub
description: Setup Rewarded Video for MoPub
pid: 1
top_nav_section: prebid-mobile
nav_section: prebid-mobile-adops
sidebarType: 3
---

# Step-by-Step Line Item Setup for Rewarded Video on MoPub

* TOC
{:toc }

This page provides step-by-step instructions to set up rewarded-video line items on MoPub to be used with the Prebid Mobile SDK.

## Step 1. Add a line item

In the *Add a Line Item* section:
1. For the *Type and Priority* settings, select *Non-Guaranteed* as the type and set the priority to *12*. This ensures the line item will compete with all other demand.
2. Set the Rate to the price you want to target.&nbsp;
<img src="/assets/images/ad-ops/mopub/rewarded/mopub-lineitem-rewarded.png" width="1000" height="544" alt="MoPub Line Item Settings">&nbsp;&nbsp;
3. In the *Advanced Targeting* section, set the target for *Keywords* to `hb_pb:0.50`&nbsp;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We're only setting it to hb_pb:0.50 because we set the Rate to .50. Maybe clarify with something like this: "...set the target for Keywords to include the specified Rate: hb_pb:0.50"

<img src="/assets/images/ad-ops/mopub/rewarded/mopub-lineitem-advanced.png" width="1000" height="254" alt="MoPub Line Item Advanced Settings">&nbsp;&nbsp;

For each level of pricing granularity required, one line item/creative pairing will need to be set up.

Line items must be set up to target custom keywords that include bid price information. The bid price keywords will contain how much the buyer bid on the impression.

Prebid Mobile, by default, will send the highest bid price to MoPub using the keyword `hb_pb` but will also submit the key `hb_pb_BIDDERCODE` for each bidder. You can decide to create one set of line items for all bidders or one set of line items for each bidder.

## Step 2. Add creatives to your line item
Rewarded video creatives must have a *VAST tag* with the *Format* set to *Rewarded Video* that includes the code below:

```
<VAST version="2.0">
<Ad id="1">
<Wrapper>
<AdSystem>MoPub</AdSystem>
<VASTAdTagURI><![CDATA[https://%%KEYWORD:hb_cache_host%%%%KEYWORD:hb_cache_path%%?uuid=%%KEYWORD:hb_uuid%%]]></VASTAdTagURI>
</Wrapper>
</Ad>
</VAST>
```

<br>
<img src="/assets/images/ad-ops/mopub/rewarded/mopub_lineitem_vasttag2.png" alt="MoPub VAST tag code">&nbsp;&nbsp;
The `hb_uuid` variable value is the cache id that will load the ad markup from the bid stored in Prebid Cache. Within each line item, for each ad unit size, there should be one creative with this content.

The XML can be constructed by providing the VAST tag URL as:
`https://%%KEYWORD:hb_cache_host%%%%KEYWORD:hb_cache_path%%?uuid=%%KEYWORD:hb_uuid%%`

## Step 3. Duplicate line items
Duplicate your line items according to your [price granularity](/prebid-mobile/adops-price-granularity.html) setting.