Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
76 commits
Select commit Hold shift + click to select a range
0cb513b
Nobid version 1.2.4 (#1859)
redaguermas Mar 19, 2020
20e4034
refactoring the video creative process (#1870)
bretg Mar 20, 2020
1831b69
Fix for wrong link in overview/getting-started (#1879)
bojandevic Mar 24, 2020
aae410d
add UNICORN bid adapter docs (#1827)
ctylim Mar 25, 2020
765641e
adding vast-cache explanation to video overview (#1884)
bretg Mar 25, 2020
886ad87
defaultGdprScope flag (#1880)
bretg Mar 26, 2020
9a0bf45
Adds Clicktripz bidder adapter to dev-doc notes (#1836)
apmitchell Mar 26, 2020
ff92172
Adnuntius Bidder documentation added (#1821)
mikael-lundin Mar 26, 2020
2bb6ac2
ORTB eids (#1831)
pm-harshad-mane Mar 26, 2020
efdee06
New evolution tech bid adapter (#1839)
e-volution-tech Mar 26, 2020
f817354
Adfinity: gdpr support - true (#1849)
adfinity-prebid Mar 26, 2020
a78b6c9
Add Valueimpression Bid Adapter docs (#1860)
thuyhq Mar 26, 2020
9e4ad02
VIS.X: update docs regarding schain & userId support (#1871)
mk0x9 Mar 26, 2020
2c02ba2
Media.net Adapter: Add support for userId modules in bidder-docs (#1872)
vedantseta Mar 26, 2020
9faa1e1
PubMatic tosupport NetId user id sub module (#1873)
pm-harshad-mane Mar 26, 2020
8e03f67
Index Exchange: Registering user syncs (#1874)
ix-prebid-support Mar 26, 2020
cc95668
Add a new param for LiveIntent Id module. Describe the LiveIntent ide…
melgenek Mar 26, 2020
7ca3310
Pbm tcf20 (#1887)
Mar 26, 2020
c874357
PBSDK 1.5: Added Rewarded video and corrected a few errors on other p…
bszekely1 Mar 26, 2020
694288a
Floors documentation update (#1895)
bszekely1 Mar 31, 2020
1e06486
Update floors.md
bszekely1 Mar 31, 2020
1b4866a
Document native support for adkernel adapter (#1893)
ckbo3hrk Mar 31, 2020
e442270
Index Exchange: Update documentation to include TCF 2.0 (#1891)
ix-prebid-support Mar 31, 2020
fa04a21
Added param documentation for sonobi bid request url (#1886)
jongo593 Mar 31, 2020
968578d
Update floors.md
bszekely1 Mar 31, 2020
f1f3236
Update floors.md
bszekely1 Mar 31, 2020
c9c4519
TCF2 docs (#1892)
bretg Apr 1, 2020
ccaca43
released PBJS purpose 1 support (#1900)
bretg Apr 1, 2020
d4cb7a1
Media.net : adds Analytics Adapter (#1888)
vedantseta Apr 1, 2020
2c48446
OpenX Adapter: Update user id modules (#1875)
jimee02 Apr 1, 2020
331bfb0
Smartadserver adapter supports TCF V2 and USP/CCPA. (#1885)
tadam75 Apr 1, 2020
cb0d2f6
Teads tcf2 supported (#1901)
Apr 1, 2020
2115402
Updated release status (#1903)
bretg Apr 2, 2020
dab855c
Onetag: video support (#1863)
onetag-dev Apr 2, 2020
c8ef40f
feature/alias-sync-config-option (#1810)
Apr 2, 2020
f21d71f
Fix bidder docs support for userid module (#1897)
smenzer Apr 2, 2020
1b22f78
OpenX: added tcf2 support (#1878)
jimee02 Apr 3, 2020
ec26108
GumGum: adds support for tcf 2.0 (#1882)
susyt Apr 3, 2020
0777662
rubicon: supports tcf2 (#1907)
bretg Apr 3, 2020
2e718fb
Update Readpeak Adapter Documentation (#1904)
kurrestahlberg Apr 3, 2020
945206d
Aardvark tcf2 (#1908)
bretg Apr 3, 2020
8b0c592
adform logo (#1912)
bretg Apr 6, 2020
16eb32a
yieldlift adapter docs (#1883)
yieldlift Apr 7, 2020
940f40d
Doc file for new TheMediaGridNM Bid Adapter (#1865)
TheMediaGrid Apr 7, 2020
ff2111d
Added doc file for Converge Bid Adapter (#1898)
Converge-Digital Apr 7, 2020
62c1130
Added documentation for Hybrid.ai Adapter (#1662)
hybrid-ai Apr 7, 2020
a2a36b7
initial (#1877)
bidlab Apr 7, 2020
785f27d
documenting usersync with GDPR
bretg Apr 7, 2020
c6b3b56
add adot bidder adapter documentation (#1846)
mlequain Apr 7, 2020
871b256
added automatad openRTB adapter doc (#1876)
Apr 7, 2020
021b0b0
Windtalker adapater docs (#1788)
degroat Apr 7, 2020
f2a62fb
Add Schain support (#1845)
onaydenov Apr 7, 2020
5e7b0a7
adagioBidAdapter: SChain, TCF2 support features (#1844)
osazos Apr 8, 2020
eabf8d7
Update platformio.md (#1889)
varashellov Apr 8, 2020
edeff2c
Smartadserver add schain_supported to bidder doc (#1902)
furbanowicz-smartadserver Apr 8, 2020
9096d2c
twin ad unit codes (#1909)
bretg Apr 8, 2020
2f58ec4
OneVideo TCF 2.0 Support (#1913)
DeepthiNeeladri Apr 8, 2020
32ffca1
update rubicon hosted PBS link (#1915)
bretg Apr 8, 2020
7862a2d
Changed left nav (#1918)
Apr 10, 2020
3a4982d
adding a test page (#1919)
Apr 10, 2020
331404b
adding meta object to bidder adapter docs (#1911)
bretg Apr 12, 2020
c282b74
Update aliases (#1910)
Apr 12, 2020
0b35b4c
TCF 2 support (#1924)
jaiminpanchal27 Apr 15, 2020
c3b2855
Add new bid adapter for ConnectAd (formerly ServerBid Alias) (#1785)
rtuschkany Apr 16, 2020
4661136
rakuten logo (#1927)
bretg Apr 16, 2020
a4b786d
User ids and gdpr support (#1920)
Apr 17, 2020
8747058
add relaido adapter (#1917)
relaido Apr 17, 2020
2148f49
WIPES adapter docs (#1894)
Tosh39 Apr 17, 2020
f2e0549
Added flags for TCF v2 and COPPA support. (#1890)
dpapworth-qc Apr 17, 2020
e7cb917
ocm logo (#1932)
bretg Apr 17, 2020
353da03
correct a few bid adapters' support of user id modules which were mis…
smenzer Apr 17, 2020
f0e8dbd
pub-api update for server-side aliases (#1933)
bretg Apr 18, 2020
fea5ddb
adding PBS privacy FAQ entry (#1931)
bretg Apr 20, 2020
b31d38b
Adagio: update required params and user guide url (#1916)
osazos Apr 20, 2020
7f1a658
add cache url to post ad data to cache (#1934)
sumit116 Apr 20, 2020
d7675ae
added cache url to prebid setConfig
Apr 20, 2020
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
Binary file not shown.
15 changes: 15 additions & 0 deletions _data/partners.yml
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,11 @@
imgURL: /assets/images/partners/tech/Pubnative-RGB-Logo.png
type: technology

- company: Rakuten Advertising
link: https://rakutenadvertising.com/
imgURL: /assets/images/partners/tech/rakuten_logo.png
type: technology

- company: StreamAMP
link: https://streamamp.com/
imgURL: /assets/images/partners/tech/StreamAMP_logo.png
Expand Down Expand Up @@ -118,6 +123,11 @@
imgURL: /assets/images/partners/publisher/News_Corp_logo.png
type: publisher

- company: Orange Click Media
link: https://orangeclickmedia.com/
imgURL: /assets/images/partners/publisher/orangeclickmedia_logo.png
type: publisher

- company: Publishers Clearing House
link: https://pch.com/
imgURL: /assets/images/partners/publisher/PCH-logo_v3.jpg
Expand All @@ -133,6 +143,11 @@
imgURL: /assets/images/partners/publisher/sortable.png
type: publisher

- company: AdForm
link: https://site.adform.com/
imgURL: /assets/images/partners/community/Adform-Logo.png
type: community

- company: Adomik
link: https://adomik.com/
imgURL: /assets/images/partners/community/Adomik-logo.png
Expand Down
133 changes: 74 additions & 59 deletions _data/sidebar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -431,6 +431,14 @@
sectionTitle:
subgroup: 5

- sbSecId: 1
title: GDPR Enforcement
link: /dev-docs/modules/gdprEnforcement.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 5

- sbSecId: 1
title: Consent Management - US Privacy (CCPA)
link: /dev-docs/modules/consentManagementUsp.html
Expand All @@ -439,6 +447,14 @@
sectionTitle:
subgroup: 5

- sbSecId: 1
title: Floors Module
link: /dev-docs/modules/floors.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 5

- sbSecId: 1
title: Supply Chain Object
link: /dev-docs/modules/schain.html
Expand Down Expand Up @@ -737,7 +753,6 @@
isSectionHeader: 0
sectionTitle:
subgroup: 1

- sbSecId: 2
title: Video interstitial Ad Unit
link: /prebid-mobile/pbm-api/ios/pbm-videointerstitialadunit-ios.html
Expand All @@ -746,6 +761,14 @@
sectionTitle:
subgroup: 1

- sbSecId: 2
title: Video Rewarded Ad Unit
link: /prebid-mobile/pbm-api/ios/pbm-video-rewarded-adunit-ios.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 1

- sbSecId: 2
title: Targeting Parameters
link: /prebid-mobile/pbm-api/ios/pbm-targeting-ios.html
Expand Down Expand Up @@ -851,6 +874,15 @@
sectionTitle:
subgroup: 2

- sbSecId: 2
title: Video Rewarded Ad Unit
link: /prebid-mobile/pbm-api/android/pbm-video-rewarded-adunit-android.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 2


- sbSecId: 2
title: Targeting Parameters
link: /prebid-mobile/pbm-api/android/pbm-targeting-params-android.html
Expand Down Expand Up @@ -883,64 +915,6 @@
sectionTitle:
subgroup: 2

- sbSecId: 2
title: For Ad Ops
link:
isHeader: 1
headerId: foradops
isSectionHeader: 0
sectionTitle:
subgroup: 3

- sbSecId: 2
title: Setup Line items For Google Ad Manager
link: /prebid-mobile/adops-line-item-setup-dfp.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 3

- sbSecId: 2
title: Setup Line items For Video
link: /prebid-mobile/adops-video-setup-dfp.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 3

- sbSecId: 2
title: Setup Line Items For MoPub
link: /prebid-mobile/adops-line-item-setup-mopub.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 3

- sbSecId: 2
title: Setup Native Ads
link: /prebid-mobile/adops-native-setup.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 3

- sbSecId: 2
title: Price Granularity
link: /prebid-mobile/adops-price-granularity.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 3

- sbSecId: 2
title: Dr. Prebid Validation App
link: /prebid-mobile/dr-prebid.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 3


- sbSecId: 2
title: For Contributors
link:
Expand Down Expand Up @@ -1136,6 +1110,47 @@
sectionTitle:
subgroup: 0

- sbSecId: 3
title: "<span style='color:#EA9622;'>Mobile</span>"
link:
isHeader: 0
isSectionHeader: 0
isCatHeader: 1
sectionTitle:
subgroup: 0

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

- sbSecId: 3
title: Setup Native Ads
link: /prebid-mobile/adops-native-setup.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 0

- sbSecId: 3
title: Price Granularity
link: /prebid-mobile/adops-price-granularity.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 0

- sbSecId: 3
title: Dr. Prebid Validation App
link: /prebid-mobile/dr-prebid.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 0

- sbSecId: 3
title: "<span style='color:#EA9622;'>Freewheel</span>"
link:
Expand Down
92 changes: 60 additions & 32 deletions _includes/adops/adops-gam-video-setup.html
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<div class="col-sm-9 pb-content" markdown="1">

<h1 id="setting-up-prebid-video-in-google-ad-manager">Setting up Prebid Video in Google Ad Manager</h1>

<p>This page describes how to set up video creatives in Google Ad Manager for use with Prebid.js.</p>
Expand All @@ -12,70 +12,100 @@ <h1 id="setting-up-prebid-video-in-google-ad-manager">Setting up Prebid Video in
<ul id="markdown-toc">
<li><a href="#line-item-setup" id="markdown-toc-line-item-setup">Line Item Setup</a></li>
<li><a href="#creative-setup" id="markdown-toc-creative-setup">Creative Setup</a></li>
<li><a href="#additional-setup-for-long-form-ad-pods" id="markdown-toc-additional-setup-for-long-form-ad-pods">Additional Setup for Long-Form (ad pods)</a> <ul>
<li><a href="#further-reading" id="markdown-toc-further-reading">Further Reading</a></li>
</ul>
</li>
<li><a href="#further-reading" id="markdown-toc-further-reading">Further Reading</a></li>
</ul>

<h2 id="line-item-setup">Line Item Setup</h2>

<ul>
<li>
<p>In the <strong>New line item</strong> dialog, under <strong>Inventory sizes</strong>, select the <strong>Video VAST</strong> radio button.</p>
</li>
<li>
<p>In the <strong>Master</strong> text area, add your video player size(s).</p>
</li>
</ul>
<ol>
<li>In the <b>New line item</b> dialog, choose "Video".</li>
<li>Select the appropriate Line Item Type, etc.</li>
<li>In the <b>Expected creatives</b> section, choose your video size, e.g., 640x480v.</li>
<li>Set the dates, rate, limit, and targeting as desired. For example, for <a href="/dev-docs/publisher-api-reference.html#setConfig-Send-All-Bids">SendAllBids</a> include targeting for "hb_bidder_rubicon=rubicon" as well as the hb_pb_rubicon targeting. This isn't needed if only creating one set of orders for all bidders.</li>
<li>Remember to set the hb_pb=BUCKET targeting for each line item, or hb_pb_BIDDER=BUCKET if using separate line items for each bidder.</li>
<li>Save the line item.</li>
</ol>
<p>Be sure to duplicate your line item and video creative for each Prebid price bucket you intend to create. </p>
<p class="alert alert-warning">By default, Prebid.js caps all CPMs at $20. As a video seller, you may expect to see CPMs higher than $20. In order to receive those bids, you’ll need to make sure your dev team implements custom price buckets as described in the <a href="/dev-docs/show-video-with-a-dfp-video-tag.html#implement-custom-price-buckets">engineering setup instructions</a>. Once those changes are made on the engineering side, there should be no changes required from the ad ops side to support CPMs over $20.</p>

<p><img src="/assets/images/ad-ops/dfp-creative-setup/dfp-creative-setup-03.png" alt="Google Ad Manager New Line Item" class="pb-md-img" /></p>
<p class="alert alert-success"><b>Multiple Cache Services</b><br>You might need separate video line items for each cache service being used. For example, if both AppNexus and Rubicon Project are bidders, you’ll either need to create separate line items to support the different cache URLs required or provide separately-targeted creatives, as described below.</p>

<p>Other line item settings and key/value targeting are the same as <a href="/adops/step-by-step.html#step-1-add-a-line-item">those recommended for Prebid display</a>, with one exception:</p>
<h2 id="creative-setup">Creative Setup</h2>

When setting up video creatives, it's important to understand where the VAST XML is stored for each of your bidders. The most common place to store VAST XML is AppNexus' cache, but some bidders (such as RubiconProject and SpotX) use their own cache services. To support such
bidders, you will need to have either:
<ul>
<li>By default, Prebid.js caps all CPMs at $20. As a video seller, you may expect to see CPMs higher than $20. In order to receive those bids, you’ll need to make sure your dev team implements custom price buckets as described in the <a href="/dev-docs/show-video-with-a-dfp-video-tag.html">engineering setup instructions</a>. Once those changes are made on the engineering side, there should be no changes required from the ad ops side to support CPMs over $20.</li>
<li>a separate line item for each bidder, or</li>
<li>a creative for each cache service utilized by your implementation.</li>
</ul>

<p class="alert alert-success">Be sure to duplicate your line item and video creative for each Prebid price bucket you intend to create. You may also need separate video line items for each cache service being used. For example, if both AppNexus and Rubicon Project are bidders, you’ll need separate line items to support the different cache URLs required.</p>
<h3 id="creative-single-cache">Single Cache Location</h3>

<h2 id="creative-setup">Creative Setup</h2>
<p>1. For each line item you create, click on the <b>Creatives</b> tab, click the <b>ADD CREATIVE</b> button, and choose the size you're entering.</p>

<p>1. For each line item you created above, select <strong>new creative set</strong>.</p>
<p>2. In the dialog that appears, choose <b>Redirect</b>.</p>

<p>2. In the dialog that appears, set the <strong>creative set type</strong> to <strong>“Redirect”</strong></p>

<p>3. Set the <strong>VAST tag URL</strong> to the cache location. Note that each bidder, e.g. Rubicon Project, may have a different cache location URL.</p>
<p>3. Set the <b>VAST tag URL</b> to the cache location.

<p>If you’re using a single order for all bidders, then the VAST URL will be the same for each bidder:</p>

<figure class="highlight"><pre><code class="language-html" data-lang="html"> https://prebid.adnxs.com/pbc/v1/cache?uuid=%%PATTERN:hb_uuid%%
or
[other bidder cache location]</code></pre></figure>

<p>If you’re using different orders for each bidder, the VAST URL for each will need to be different:</p>
<p>If you’re using different orders for each bidder, the VAST URL for each will include the bidder-specific targeting variable:</p>

<figure class="highlight"><pre><code class="language-html" data-lang="html"> https://prebid.adnxs.com/pbc/v1/cache?uuid=%%PATTERN:hb_uuid_BIDDERCODE%%
or
[other bidder cache location]</code></pre></figure>

<p class="alert alert-warning">This VAST tag URL is <strong>required</strong> in order to show video ads. It points to
a server-side cache hosted by your Prebid Server provider.</p>
<p class="alert alert-warning">This VAST tag URL is <b>required</b> in order to show video ads. It points to a server-side cache hosted by your Prebid Server provider.</p>

<p class="alert alert-info"><strong>Prebid Cache and the VAST creative URL warning</strong><br />
Google Ad Manager will show you a warning that fetching VAST from the creative
Google Ad Manager will show you a warning stating that fetching VAST from the creative
URL failed. This is expected, since the creative URL above points
to a server-side asset cache hosted by Prebid Server.</p>

<p>4. Set the <strong>duration</strong> to <strong>1</strong></p>
<p>4. Set the <b>Duration</b> to <b>1</b>.</p>

<p>The resulting creative should look something like the following:</p>

<p><img src="/assets/images/ad-ops/dfp-creative-setup/dfp-creative-setup-04.png" alt="Google Ad Manager Video Creative Setup" class="pb-md-img" /></p>
<p><img src="/assets/images/ad-ops/dfp-creative-setup/appnexus_vast_tag.png" alt="Google Ad Manager Video Creative Setup"/></p>

<h3 id="creative-multiple-cache">Multiple Cache Locations</h3>

To set up multiple video creatives in the same line item (i.e., to run AppNexus, Rubicon, and SpotX all together in the same video line item), you can utilize creative targeting.
<br/>
<br/>
<p>
1. In the line item's <b>Expected creatives</b> box, choose <b>Creative Targeting</b> and "Add New Targeting".

<p>
2. Give the targeting set a name like "Prebid Default Video Cache URL" and set <b>Custom Targeting</b> as appropriate, e.g., "hb_bidder is none of rubicon, spotx". Save the targeting.

<p>That’s it as far as Prebid setup is concerned. At this point you can add any other options you would normally use, e.g., labels or tracking URLs.</p>
<p>
3. For each bidder that uses their own cache, click <b>ADD SIZE</b> in the "Expected creatives" section. Again, choose <b>Creative Targeting</b> and "Add New Targeting".

<h1 id="additional-setup-for-long-form-ad-pods">Additional Setup for Long-Form (ad pods)</h1>
<p>
4. Give the targeting a name like "Prebid Rubicon Video Cache URL". Set <b>Custom Targeting</b> appropriately, e.g., "hb_bidder is any of rubicon". Save the targeting.

<p>
5. Save the line item.

<p>Now that the targeting is defined, we're going to add the creatives.</p>

<p>
6. Go to the line item's <b>Creatives</b> tab.

<p>
7. Make one creative for each of the targets. There are a couple of ways to do this on the GAM UI, but each approach will result in a creative entry screen similar to the screenshot above for the "Single Cache Location" process. Enter a name (e.g. "AppNexus VAST tag") and the VAST URL as described above.

<p>
8. The end result should look something like this:

<p><img src="/assets/images/ad-ops/dfp-creative-setup/video_creatives_final.png" alt="Google Ad Manager Video Creative Setup" /></p>

<p>That’s it as far as Prebid setup is concerned. At this point you can add any other options you would normally use, such as labels or tracking URLs.</p>

<h2 id="further-reading">Further Reading</h2>

Expand All @@ -85,5 +115,3 @@ <h2 id="further-reading">Further Reading</h2>
<li><a href="https://support.google.com/dfp_premium/answer/1080597">Add Key-Values to a Master Video Ad Tag</a> (Google Ad Manager)</li>
<li><a href="https://support.google.com/admanager/answer/2376981">Google Ad Manager Macros</a> (Google Ad Manager)</li>
</ul>

</div>
5 changes: 4 additions & 1 deletion _includes/video/pb-is-br.html
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,10 @@
pbjs.addAdUnits(videoAdUnit); // add your ad units to the bid request

pbjs.setConfig({
usePrebidCache: true
usePrebidCache: true,
cache: {
url: 'https://prebid.adnxs.com/pbc/v1/cache'
}
});

pbjs.requestBids({
Expand Down
Loading