%%PATTERN:hb_native_title%%
-%%PATTERN:hb_native_body%%
-%%PATTERN:hb_native_brand%%
- 
In Google Ad Manager, create a new order with a $0.50 line item.
- -Enter all of the inventory sizes that your website has.
- -
Because header bidding partners return prices, set the Line Item Type to Price priority to enable them to compete on price.
- -
Set the Rate to $0.50 so that this line item will compete with your other demand sources at $0.50 ECPM.
- -
Set Display Creatives to One or More since we’ll have one or more creatives attached to this line item.
- -Set Rotate Creatives to Evenly.
- -
Choose the inventory that you want to run header bidding on.
- -By default, prebid.js will send the highest bid price to Google Ad Manager using the keyword hb_pb.
This line item will capture the bids in the range from $0.50 to $1 by targeting the keyword hb_pb set to 0.50 in the Key-values section.
You must enter the value to two decimal places, e.g., 1.50. If you don’t use two decimal places, header bidding will not work.
Next, add a creative to this $0.50 line item; we will duplicate the creative later.
- -Choose the same advertiser we’ve assigned the line item to.
- -Note that this has to be a Third party creative. The “Serve into a Safeframe” box can be UNCHECKED or CHECKED (Prebid universal creative is SafeFrame compatible).
- -Copy this creative code snippet and paste it into the Code snippet box.
- -Send All Bids scenario (where every bidder has a separate
-order), the creative and targeting will be different from the example shown here. See Send All Bids for details.
-<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/creative.js"></script>
-<script>
- var ucTagData = {};
- ucTagData.adServerDomain = "";
- ucTagData.pubUrl = "%%PATTERN:url%%";
- ucTagData.targetingMap = %%PATTERN:TARGETINGMAP%%;
- ucTagData.hbPb = "%%PATTERN:hb_pb%%";
-
- try {
- ucTag.renderAd(document, ucTagData);
- } catch (e) {
- console.log(e);
- }
-</script>
-
Make sure the creative size is set to 1x1. This allows us to set up size override, which allows this creative to serve on all inventory sizes.
- -Note that safeframes don’t work with older versions of Prebid.js (v1.23 and before) in combination with recent versions of Prebid Universal Creative.
- -As of August 2020, privacy regulations have changed such that new creatives entered -in GAM may require a [declaration of the ad technology provider](https://support.google.com/admanager/answer/9972771?hl=en). The first step -is to note the domain you serve the creative from. The examples above offer the -use of the jsdelvr.com CDN. However, you may obtain the creative from a managed -service or you may host it yourself. If you receive a warning from ad manager -about "declaring self-created ad technology", you should be able to work around -this by editing the creative and filling out the "Associated Ad Technology Providers" section as shown in this screen capture: - -
Next, let’s attach the creative to the $0.50 line item you just created. Click into the Line Item, then the Creatives tab.
- -There will be yellow box showing each ad spot that you haven’t uploaded creatives for yet. Since you’ve already made the creatives, click use existing creatives next to each size.
- -
In the pop-up dialog that appears, click Show All to remove the default size filters and see the 1x1 creatives. Include the prebid creative and click Save.
- -
Back in the line item, go into the Creatives tab again, and click into the creative you just added.
- -Then, in the creative’s Settings tab, enable the Size overrides field and set all your line item’s potential sizes.
- -Save the creative and go back to the line item.
- -Google Ad Manager has a constraint that one creative can be served to at most one ad unit in a page under GPT’s single request mode.
- -Let’s say your page has 4 ad slots. We need to have at least 4 creatives attached to the line item in case more than 2 bids are within the $0.50 range.
- -Therefore, we need to duplicate our Prebid creative 4 times.
- -Once that’s done, we have a fully functioning line item with 4 creatives attached that can potentially fill 4 ad slots of varying sizes during a single pageview.
- -Now let’s duplicate our line item for bids above $0.50.
- -In the Prebid order page, copy the line item with shared creatives.
- -This way you only have 4 creatives to maintain, and any updates to those creatives are applied to all pre-bid line items.
- -For example, we can duplicate 3 more line items:
- -Let’s go into each of them to update some settings. For each duplicated line item:
- -Change the name to reflect the price, e.g., “Prebid_1.00”, “Prebid_1.50”
-Change the Rate to match the new price of the line item.
-In Key-values, make sure to target hb_pb at the new price, e.g., $1.00. Again, be sure to use 2 decimal places.
(Optional) Set the start time to Immediate so you don’t have to wait.
-Repeat for your other line items until you have the pricing granularity level you want.
- -This page describes how to set up video creatives in Google Ad Manager for use with Prebid.js.
- -For general Google Ad Manager line item setup instructions, see the other pages in this section.
- -For engineering setup instructions, see -Show Video Ads with a Google Ad Manager Video Tag.
- - - -Be sure to duplicate your line item and video creative for each Prebid price bucket you intend to create.
-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 engineering setup instructions. 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.
- -1. For each line item you create, click on the Creatives tab, click the ADD CREATIVE button, and choose the size you're entering.
- -2. In the dialog that appears, choose Redirect.
- -3. Set the VAST tag URL to the cache location. - -
If you’re using a single order for all bidders, then the VAST URL will be the same for each bidder:
- - https://prebid.adnxs.com/pbc/v1/cache?uuid=%%PATTERN:hb_uuid%%
-or
- [other bidder cache location]If you’re using different orders for each bidder, the VAST URL for each will include the bidder-specific targeting variable:
- - https://prebid.adnxs.com/pbc/v1/cache?uuid=%%PATTERN:hb_uuid_BIDDERCODE%%
-or
- [other bidder cache location]This VAST tag URL is required in order to show video ads. It points to a server-side cache hosted by your Prebid Server provider.
- -Prebid Cache and the VAST creative URL warning
- 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.
4. Set the Duration to the max length of video ads you serve. If you don't know what the max length is, set it to 30.
- -In the past Prebid used to recommend setting duration to 0 or 1, but GAM now requires that this field reflect the actual video ad length. Since ads flowing through header bidding are going to differ in length, choose a value that matches a common ad length like 15 or 30.
- -The resulting creative should look something like the following:
- -
-1. In the line item's Expected creatives box, choose Creative Targeting and "Add New Targeting". - -
-2. Give the targeting set a name like "Prebid Default Video Cache URL" and set Custom Targeting as appropriate, e.g., "hb_bidder is none of rubicon, spotx". Save the targeting. - -
-3. For each bidder that uses their own cache, click ADD SIZE in the "Expected creatives" section. Again, choose Creative Targeting and "Add New Targeting". - -
-4. Give the targeting a name like "Prebid Rubicon Video Cache URL". Set Custom Targeting appropriately, e.g., "hb_bidder is any of rubicon". Save the targeting. - -
-5. Save the line item. - -
Now that the targeting is defined, we're going to add the creatives.
- --6. Go to the line item's Creatives tab. - -
-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. - -
-8. The end result should look something like this: - -
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.
- -
- For tips and troubleshooting info, see: -
- On the JSFiddle example below: -
+
pbjs.setConfig()
-- See the the API reference for more detail.
+- This example shows custom price granularity buckets using pbjs.setConfig().
+- See the API reference for more detail.
jsfiddle_link: jsfiddle.net/Prebid_Examples/vq05dhnj/embedded/html,result
diff --git a/dev-docs/examples/instream-banner-mix.md b/dev-docs/examples/instream-banner-mix.md
index 2a315ef437..0394bafa15 100644
--- a/dev-docs/examples/instream-banner-mix.md
+++ b/dev-docs/examples/instream-banner-mix.md
@@ -5,6 +5,9 @@ description: An example of displaying both instream video and banner ads using P
sidebarType: 1
+about:
+- This example shows how to display instream video and banner ads within the same configuration.
+
jsfiddle_link: jsfiddle.net/Prebid_Examples/nowfejh7/embedded/html,result/
code_height: 3050
diff --git a/dev-docs/examples/legacy-browser-example.md b/dev-docs/examples/legacy-browser-example.md
index 253e67c547..cae6e4c6c0 100644
--- a/dev-docs/examples/legacy-browser-example.md
+++ b/dev-docs/examples/legacy-browser-example.md
@@ -8,8 +8,8 @@ sidebarType: 1
about:
- In Prebid 6.0, support for legacy browsers is no longer assured.
- Publishers may conditionally deploy the 5.x branch and add polyfills
-- One strategy to do this is simply the module/nomodule approach discussed here https://philipwalton.com/articles/deploying-es2015-code-in-production-today/
-- Another strategy is to detect the user agent or the 'currentScript' mechanism as described here https://stackoverflow.com/questions/29987969/how-to-load-a-script-only-in-ie
+- One strategy to do this is simply the module/nomodule approach discussed here https://philipwalton.com/articles/deploying-es2015-code-in-production-today/
+- Another strategy is to detect the user agent or the 'currentScript' mechanism as described here https://stackoverflow.com/questions/29987969/how-to-load-a-script-only-in-ie
- Another strategy is to conditionally serve one file or another based on instructions to your cdn
jsfiddle_link: jsfiddle.net/Prebid_Examples/kqe8L2jf/embedded/html,result
diff --git a/dev-docs/examples/meta-bid-filtering.md b/dev-docs/examples/meta-bid-filtering.md
index 0d6433a202..f31e6bcd0c 100644
--- a/dev-docs/examples/meta-bid-filtering.md
+++ b/dev-docs/examples/meta-bid-filtering.md
@@ -6,8 +6,8 @@ description: Bid filtering on meta object example
sidebarType: 1
about:
-- Bidders can supply metadata about the bid such as advertiser domain. See the "meta" fields in the bid response for the full list.
- This is an example that filters bid responses based on the metadata object.
+- Bidders can supply metadata about the bid such as advertiser domain. See the "meta" fields in the bid response for the full list of metadata.
jsfiddle_link: jsfiddle.net/Prebid_Examples/0s4eug1d/embedded/html,result
diff --git a/dev-docs/examples/multi-format-example.md b/dev-docs/examples/multi-format-example.md
index 4869e1e6a4..781c7bf5c9 100644
--- a/dev-docs/examples/multi-format-example.md
+++ b/dev-docs/examples/multi-format-example.md
@@ -6,10 +6,10 @@ description: Multi-Format Ad Units
sidebarType: 1
about:
-- A multi-format ad unit allows you receive any combination of banner, video, or native demand
+- A multi-format ad unit allows you to receive any combination of banner, video, or native demand
- Any bidder that supports at least one of the listed media types can participate in the auction for that ad unit
- For engineering setup instructions, see Show Multi-Format Ads
-- For ad ops setup instructions, see Setting up Prebid Multi-Format in Google Ad Manager
+- For ad ops setup instructions, see Google Ad Manager with Prebid Step by Step
jsfiddle_link: jsfiddle.net/Prebid_Examples/yxsgcj71/embedded/html,result
diff --git a/dev-docs/examples/native-ad-example.md b/dev-docs/examples/native-ad-example.md
index 89beabd189..63eca29a7d 100644
--- a/dev-docs/examples/native-ad-example.md
+++ b/dev-docs/examples/native-ad-example.md
@@ -8,7 +8,7 @@ sidebarType: 1
about:
- Native advertising is where the ad experience follows the natural form and function of the user experience in which it is placed.
- For engineering setup instructions, see Show Native Ads
-- For ad ops setup instructions, see Setting up Prebid Native in Google Ad Manager (Alpha)
+- For ad ops setup instructions, see GAM Step by Step - Native Creatives
jsfiddle_link: jsfiddle.net/Prebid_Examples/s5L7p3yd/embedded/html,result/
diff --git a/dev-docs/examples/no-adserver.md b/dev-docs/examples/no-adserver.md
new file mode 100644
index 0000000000..70fb772aac
--- /dev/null
+++ b/dev-docs/examples/no-adserver.md
@@ -0,0 +1,16 @@
+---
+layout: example
+title: No Adserver Example
+left_nav_override: Examples
+description: Running Prebid.js without an ad server
+sidebarType: 1
+
+about:
+- This example demonstrates running an auction and rendering without an ad server.
+
+jsfiddle_link: jsfiddle.net/Prebid_Examples/svumodbe/embedded/html,result
+
+code_height: 2300
+
+pid: 10
+---
diff --git a/dev-docs/examples/postbid.md b/dev-docs/examples/postbid.md
index 9552400247..2a64381aa2 100644
--- a/dev-docs/examples/postbid.md
+++ b/dev-docs/examples/postbid.md
@@ -10,7 +10,7 @@ why_link: /overview/what-is-post-bid.html
about:
- Postbid is a third-party tag creative you setup in your ad server that loads the whole Prebid.js package. Create a line item in the ad server targeting each ad unit on your page. The creative will contain the code below.
-- If the ad unit supports multiple sizes, you'll need to do one of two things -- either create a Postbid creative for each desired size with that size hardcoded in the PBJS adunit, or use ad server macros to pass the size through to the creative. e.g. in GAM, there are HEIGHT and WIDTH macros.
+- If the ad unit supports multiple sizes, you'll need to do one of two things -- either create a Postbid creative for each desired size with that size hardcoded in the PBJS adunit, or use ad server macros to pass the size through to the creative. For example, in Google Ad Manager there are HEIGHT and WIDTH macros.
- There is no need to create line items for each price bucket as the postbid creative is served after the ad server has chosen the line item.
- This postbid creative supports passback. See how this works below.
diff --git a/dev-docs/examples/size-mapping.md b/dev-docs/examples/size-mapping.md
index fc96faeefe..eb87f20109 100644
--- a/dev-docs/examples/size-mapping.md
+++ b/dev-docs/examples/size-mapping.md
@@ -7,7 +7,7 @@ sidebarType: 1
about:
-- Dynamic filtering on ad unit sizes
+- This example demonstrates dynamic filtering on ad unit sizes
- Ad unit labels applied based on CSS media queries
jsfiddle_link: jsfiddle.net/Prebid_Examples/qourvse1/embedded/html,result
diff --git a/dev-docs/examples/sync-tid.md b/dev-docs/examples/sync-tid.md
index 16b173aa13..acba990c8d 100644
--- a/dev-docs/examples/sync-tid.md
+++ b/dev-docs/examples/sync-tid.md
@@ -8,7 +8,7 @@ sidebarType: 1
about:
- imp.ext.tid sync
-- This example demonstrates sending the same impression transaction identifier (imp.ext.tid) to two on page libraries
+- This example demonstrates sending the same impression transaction identifier (imp.ext.tid) to two on page libraries.
jsfiddle_link: jsfiddle.net/50aqtrck/1/embedded/html,result
diff --git a/dev-docs/examples/use-prebid-with-appnexus-ad-server.md b/dev-docs/examples/use-prebid-with-appnexus-ad-server.md
index dba3c03674..3b68747f7d 100644
--- a/dev-docs/examples/use-prebid-with-appnexus-ad-server.md
+++ b/dev-docs/examples/use-prebid-with-appnexus-ad-server.md
@@ -6,9 +6,9 @@ description: Using Prebid.js with Xandr Publisher Ad Server
sidebarType: 1
about:
-- An example showing how to use Prebid.js with Xandr Publisher Ad Server
-- See the Seller Tag (AST) documentation for more information
-- To configure the Seller Tag to use SafeFrames, refer to the SafeFrame API Reference.
+- This example shows how to use Prebid.js with Xandr Publisher Ad Server.
+- See the Seller Tag (AST) documentation for more information.
+- To configure the Seller Tag to use SafeFrames, refer to the SafeFrame API Reference.
jsfiddle_link: jsfiddle.net/Prebid_Examples/tr1djf9e/embedded/html,result
code_height: 2404
diff --git a/dev-docs/getting-started.md b/dev-docs/getting-started.md
index caa754d56b..1b030ea3bf 100644
--- a/dev-docs/getting-started.md
+++ b/dev-docs/getting-started.md
@@ -1,35 +1,50 @@
---
layout: page_v2
-title: Getting Started
+title: Getting Started for Developers
description: Dev docs for getting started with Prebid.js for header bidding
sidebarType: 1
---
-
# Getting Started for Developers
{: .no_toc }
* TOC
{: toc }
-### Quick Start
+## Overview
+
+To run heading bidding on your site with Prebid.js you need to [download the Prebid.js package](/download.html), including your selected bidders and adapters, and add the code to your page. This code will gather bids from your selected demand sources (bidders) and pass the information on to your ad server. For full details on how Prebid.js works, see [What is Prebid.js?](/prebid/prebidjs.html).
+
+Developers should work with their ad ops team to plan out your Prebid configuration. You'll need to add information to your code regarding things such as:
+
+- Whether you're sending all bids or only the top price bid to the ad server
+- What level of price granularity you'll be using
+- What key-value pairs do you need to pass to the ad server
+
+See the [Ad Ops Planning Guide](/adops/adops-planning-guide.html) for details.
+
+
+## Quick Start
+
+The easiest way to get started with Prebid.js is to look at an example. Start with our [Basic Example](/dev-docs/examples/basic-example.html), then explore other examples under **Prebid.js > Examples** to find what you need.
+
+## Next Steps
-The easiest way to get started with Prebid.js is to use the example code below.
+For more developer resources, see:
-{% include dev-docs/build-from-source-warning.md %}
+- [Publisher API Reference](/dev-docs/publisher-api-reference.html)
+- [Prebid.js Module Overview](/dev-docs/modules/)
+- [Prebid.js Analytics Adapters](/overview/analytics.html)
-
-| Bidder | IDs Supported |
|---|---|
| {{item.biddercode}} | {{item.userIds}} |