Skip to content

Commit

Permalink
DRAFT - User section (#2773)
Browse files Browse the repository at this point in the history
* Initial seutp of Laravel Mix for CSS/JS generation

* Inital webpack mix script

* Additional mix packages and build scripts

* Stub source files

* Adds bourbon and include-media for build

* Import sass from main site

* Initial import of required Bootstrap styling

Only bring in what we need to keep CSS size down

* Mark jQuery as an external

So that we can include it separately and still use it in webpack build pipeline

* Add Bootstrap and dependency

For styling and JS

* Ignore changes to build support files

* Setup support to automatically reload CSS when it changes

Via browsersync

Without this change I was having to wait for Jekyll to finish rebuilding the site in order to see CSS changes

* Initial setup for JS build

bootstrap import stubbed till we can figure out just which bits we need and can limit the import to keep JS size down

* Add new brand color token for dark colors

* Initial work styling header

* main CSS build entry point

* Initial build of CSS

* Initial work to update head for relaunch

Removing some unneeded CSS/JS dn prep work for new site fonts

* Review navigation markup to work with Bootstrap 4.x

* Regenerate production JS

* Copy JS with mix to support browsersync reloading

* Update nav to show proper main nav items

Use the same nav struct for mobile view as well

* Enable main nav JS functionality

* Load reset styles from Bootstrap

* Load the site in Chrome for development

* Load utility classes

Should see if we can trim this down at some point and not load _all_ of the utility classes

* Push nav to the right

* Reflow code for better readability

Also fix unbalanced tags and add comments to sort out unbalanced tag

* Reflow code for better readability

* Reload changes to HTML files

* Update width to match design comp

* Remove VC style helpers from WP

They’re not needed on this site

* Add another level of spacer

To keep with Bootstrap patterns but give us spacer to match the comp

* Implemented content and styling for homepage main content area.

* Update CNAME

* Can’t ignore CSS and JS files

The site won’t render correctly on GitHub Pages w/out them.

* Delete CNAME

* Create CNAME

* Delete trailing whitespace

* Close tags for better code

And so that browsersync integration works correclty

* Dev config file

So that we can ignore generated files w/out affecting the production process.

`bundle exec jekyll serve --config _config.yml,_config_development.yml`

* New token for divider color

* Initial work on interior page styling

* Reflow code to try to make indenting consistent

Added character names to conditionals/loops to keep them straight.

* In-progress work on left nav

Restructuring class handling to DRY up code and reduce complexity of if statements.
Tweaking classes to provide styling hooks.
Updates for showing active nav sections.

* Updating sidebar styling and markup to support comp

Still need to add carrot indicators

* Move content block to be child of column

To get more space between sidebar and content

* Don’t output cookie consent unless in production

To avoid the on-screen clutter during development

* Regenerate CSS

* Iterating on interior content styling

* Styling interior page bits

* Regenerate CSS

* Include bootstrap before bourbon

To let bourbon `size` mixin override the conflicting mixin from bootstrap

* Initial work on footer content and styling

* Cleanup nav styling

* Update logo to knockout version from comps

* Add carrots to sidebar elements

* Regenerate JS

* Tweak header to better match comp

* Iterating on dropdown styling

* Dropdown styling tweaks

To better match comp.
Added section classes to data for styling hooks.

* Regenerate CSS

* Enabled rollover styling for format tiles

Had to move svgs to be inline so we can change styling with CSS. Also changed the markup order so that we can change svgs on link hover.

* Card and hover treatment for source cards on medium banner

* Social media icons and styling

* Tweaks to “footer” on homepage

To better match comp.

* Regenerate CSS

* Don’t index content on review site.

* Tweaking font sizes and spacing

For better display of content on interior pages

* Get rid of wrapper element

Since it is preventing proper page width on some interior pages - content is spreading wider than the container

* Match table color in comp

* Properly mark nav items active that are simple nav items

* Get rid of &nbsp entities breaking sidebar layout

Any spacing/stying is being handled by CSS so no need for these layout bits in the sidebar config file.

* Rearrange content for better display in new design

* Add space below highlights

For better content display

* Tweak thead border width

To match comp

* Keep table looking decent if it overflows the container

* Include alert styles to match current site

* Regenerate CSS

* Better display of category groups in sidebar

* Prevent egregiously bad display with nested content blocks

* Breathing space above highlights

* Extract common head markup

Moving it to a single file makes it easy to share common asset include and setup details across all pages on the site.

This is a first setp to getting the `head` for video examples cleaned up.

* Update video examples to use common head include

To DRY up code

* Update video sample template

To use same design as other pages on the site.

* Style video example code like other code blocks

* Don’t add bullets to tab list items

* Expose standard BS alerts to brand-specific classes

squash

* Regenerate CSS

* Update template to get layout updates

To match new design.
Also remove trailing whitespace

* Reflow code for better readability

* Style common bidder tables

* Fix tags for proper footer display

Also, whitespace updates

* Delete trailing whitespace

* Update class for styling tweaks

* Update template structure for new design

Also, delete trailing whitespace

* Put margin below sidebar like pb-content

So that if sidebar is longer than content we still have the footer pushed down.

* Reflow code for better readability

* Fix missing closing tags

* 404 page layout and styling

* Regenerate CSS

* Fix button display on smaller screens

* Better display of social media on smaller screens

* Regenerate CSS

* Update README with changes for building assets

* Make Codes of Conduct and Policies into collapsible sections

* Add styling for custom table

By extending Bootstrap styles for ease of maintenance

* Make table responsive for example

Makes the table scrollable if it’s wider than the space.
Have to wrap the markdown in `div` tags and move the Inline Attribution List (https://kramdown.gettalong.org/syntax.html#inline-attribute-lists) to the bottom so that it doesn’t interfere with Markdown parsing of the table.
Also need to specify that the `div` contains markdown via `markdown=“1”` based on https://kramdown.gettalong.org/syntax.html#html-blocks

* Regenerate CSS

* Header padding on mobile

* Better mobile display of main nav

* Expose sidebar nav via toggle control on mobile

* Keep sidebar visible on larger screens

But collapse it behind the toggle on smaller screens.

* Move margin to footer

So that we don’t have extra margin below sidebar when left nav is collapsed on mobile

* Better spacing around sidebar on mobile

* Update other templates to show collapsed leftnav on mobile

* Update extra template to new design for completeness

* Regenerate CSS

* Use full bootstrap from CDN rather than limited local bootstrap

Since the local compiled bootstrap uses features of JS that aren’t supported in IE11 and aren’t being “fixed” by babel in testing.

* Tweak to fix hover behavior in IE11

* Regenerate CSS

* Adjust font sizes per feedback

Switching from sizes in design comp to Minor Thirds ratio to have more difference in font size between the levels.

* Add missing heading styling

h5 isn’t used in the content area on the site but adding it here so that it’s available in the future if an h5 is added.

* Make h4 italic per feedback

Required adding semi-bold italic font from Google for proper display in browsers.

* Revert italic for h4 after additional feedback

Leaving italic on h5 since h5 is same size as body copy and leaving italic-semi-bold include to support h5 styling.

* Regenerate CSS

* Tweaks to get more space for content

Make the overall page wider and the sidebar narrower, then give all that extra space to the content.

* Add padding to prevent nav text from running into icon

It didn’t in review/testing but this tweak will ensure it doesn’t in the future.

* Regenerate CSS

* Revert "Update CNAME"

Revert CNAME to be correct for production site before opening a PR.

This reverts commit 8c44d99.

* Remove no-index from headers

So that PR for production site doesn’t block search indexing.

* Delete old, unused references to JS build

Had to move away from JS build process due to issues generating a cross-browser JS file.

* Open marketing site link in new window

* Reduce top padding on code

Per request.

* Delete old, unused JS assets

* Better display of Download page

* Hide modal to match behavior on previous site design

* Merge styles for smaller CSS file

* Update bidders page to match main listing

* Better heading level for standalone page

* Make content area wider

For better display

* Link to standalone pages

So that the bidders page is an entryway, not a page with lots of content

* Delete old bidders content

Now being displayed on individual pages

* Placeholder for autocomplete

* Update CNAME for testing

* Don’t index staging site

* Setup new layout for individual API pages

Based on bidder layout

* Break apart main API page to sub-pages

For better UX and to get rid of long pages.

* Initial work to add search to site

* Don’t filter by tags for now

Testing site-wide search

* Initial basic autocomplete support

Link out to page on selection

* Classify bidders for grouping by name

* Text change per comp

* Setup bidder groupings

* Updated lockfile

* Add awesomplete package

So that we can pull in CSS without using CDN

* Add class for styling hook

* Remove CSS from CDN

We will be styilng via native site CSS

* Revise list output to prevent markdown from breaking generated markup

* Styling for bidder list and autocomplete

Per comp

* Reflow code

For more readable customizations

* Increase hits returned

Per feedback

* Only return 1 result per URL

* Hide facet groupings

Per feedback

* Regenerate CSS

* Simple cache busting

To get updated CSS to be used.

* Extract JS to external file

So that we can edit it w/out battling with Jekyll/Liquid parsing and formatting.

* Add support to sort results by name

For saner result display

* adding timeouts feature page (#2709)

* adding timeouts feature page

* minor edits

Co-authored-by: Jean Stemp <jstemp@appnexus.com>

* Pbm native in app (#2686)

* added android prebid native inapp

* Edited the first section.

* Cleaned up samples

* Fixed a step.

* minor edits

* Removed the create method

* Added iOS docs for in app native

Co-authored-by: Steve <ssuranie@appnexus.com>
Co-authored-by: Jean Stemp <jstemp@appnexus.com>

* logan adapter: add docs (#2700)

* add docs

* Update logan.md

Co-authored-by: Aiholkin <artem.iholkin@smartyads.com>

* update SDK timeout description (#2719)

* tweaked timeout diagram (#2721)

* AdHash Bidder Adapter: initial prebid.js integration (#2687)

* declare tcf2 support and add gvl id (#2715)

* ozone 2.5.0 docs update (#2716)

Co-authored-by: Afsheen Bigdeli <afsheenb@namecast.net>

* added ignoreBidderCacheKey docs (#2720)

* added ignoreBidderCacheKey docs

* edits and some general cleanup

Co-authored-by: Jean Stemp <jstemp@appnexus.com>

* GumGum: adds irisid and pubId for server side params (#2649)

* specifies us privacy is supported

* adds video support to gumgum md

* adds support for tcf 2

* adds new bid param to gumgum.md

* updates gumgum doc

* notes required mediaType for video products

* updates gumgum doc

* adds pubId and irisid params

* removes extra cell

* pangle bidder: add doc (#2694)

Co-authored-by: hcai <caihengsheng@bytedance.com>

* Epom Adapter Doc (#2667)

* Create epom.md

* Epom Adapter Doc: pull requests improvements

* Update epom.md

Co-authored-by: Vasyl Zarva <vasyan.z@gmail.com>
Co-authored-by: bretg <bgorsline@gmail.com>

* Add new prebid server adapter parameter (#2724)

* initial

* Update mobfoxpb.md

* Update mobfoxpb.md

* Update mobfoxpb.md

* Update mobfoxpb.md

Add `key` parameter

Co-authored-by: Aiholkin <artem.iholkin@smartyads.com>

* upgraded deployment target (#2728)

* Updates to PubWise Supported Bidder Features (#2712)

* add note about aliasSyncEnabled on outbrain adapter (#2725)

* Update userId.md (#2705)

* Update userId.md

removing reference to "TBD" in the Pubprovided documentation.

* Update userId.md

* Revert "Break apart main API page to sub-pages"

This reverts commit a6b9e8e.

These updates are not ready to launch yet - revert them so they’re not part of the PR for bidder updates

* Revert "Setup new layout for individual API pages"

This reverts commit 23d00e5.

These updates are not ready to launch yet - revert them so they’re not part of the PR for bidder updates

* Added supported userids module to criteo bid adapter documentation (#2732)

* Add helper script to find ungrouped bidders

Whenever bidders are added to the site they need to be assigned to a `list_group` from `dev-docs/bidders.md` via the individual bidder frontmatter. If a bidder isn’t assigned to a `list_group` then they won’t appear on the Bidders page.

This script checks all bidders and lists those that aren’t assigned to a `list_group`.

Exclude the script so it’s not included in the generated site.

* Assign new bidders to list groups

* Added axonix.md (#2711)

* Added axonix.md

* Changed to single quotes

* new adapter - iprom (#2708)

* iPROM bidder upload - docs

* Update iprom.md

added quotes around the string examples and made the link active

Co-authored-by: Gašper Žagar <gasper.zagar@iprom.si>
Co-authored-by: Jean Stemp <38964447+jeanstemp@users.noreply.github.com>

* Revert "Update CNAME for testing"

Restore expected CNAME for production site.

This reverts commit 0c0166c.

* Revert "Don’t index staging site"

Allow indexing of production site.

This reverts commit 543ea07.

* breaking analytics adapters out into separate files (#2727)

* breaking analytics adapters out into separate files

* new analytics adapter doc instructions

* new analytics adapter doc instructions

* giving specific guidance on the privacy policy flags

* Refactor grouping by name

This is a better approach do it by parsing the title rather than relying on a value in the frontmatter

* Better sort of bidder pages

Make them sorted by title in a case-insensitive manner

* Remove unneeded list_group

Now that we are grouping by parsing title, we no longer need the list_group in the frontmatter.

* Remove unneeded helper script

* Remove unneeded `list_group`

* Delete merge conflict tags

* Restore original line breaks

* revising britepool marketing (#2735)

* BCM adapter alias (#2726)

* Create bcm.md

* Fixed the file location

* Revert "Fixed the file location"

This reverts commit 0849daf.

* Moved to dev-docs/bidders

Co-authored-by: Gabriela Melendez <gabriela@adkernel.com>

* Marsmedia bid adapter (#2729)

* Change params, add description

* Add support for gdpr, schain and video

* change param from ZoneId to zoneId
remove rows: top_nav_section , nav_section

* change param from ZoneId to zoneId
remove rows: top_nav_section , nav_section

* New adapter - videofy

* add updated supported, add example

* Native: add Native Custom Assets section (#2713)

* Native: add Custom Assets section

* wordsmithing

* Update native-implementation.md

Co-authored-by: bretg <bgorsline@gmail.com>

* jixie: param updates (#2717)

* as we are adding the prebid-server adaptor and introduced a few extra params , they are added here too
(note: those 3 new params would also reach the headerbid adserver in the case of prebid "clientside HB" too. So all good)

* added quotes around string params

Co-authored-by: bretg <bgorsline@gmail.com>

* Add simple search icon on desktop

* Better display of search on mobile

Keep the icon visible.

* added coopSync option to s2sConfig (#2743)

* removing AnalyticsAdapter suffix from modulecode (#2745)

* Add back to Bidders links.

Per feedback

* describing opt-out (#2747)

* describing opt-out

* fixing pubcommon opt out

* wordsmithing

* Added bid adatper interface signals (#2748)

* update yuktamedia analytics (#2753)

* Discuss optional keys (#2738)

* Update publisher-api-reference.md

* wordsmithing

good improvement. made a few updates.

Co-authored-by: bretg <bgorsline@gmail.com>

* Add support pbs (#2710)

Co-authored-by: faithnh <fullpong@unicorn.inc>

* Updating seedtag adapter doc (#2740)

* added media_types to the seedtag docs

* Updating doc to include inArticle

* Adding again pbjs param.

Co-authored-by: Carlos Barreiro Mata <barreymata@gmail.com>

* Add Prebid server  compatibility to AdYouLike bidder (#2741)

* set usp supported for adyoulike bidder

* add native in mediatypes

* fix pbjs field

* add prebid server compatibility on AdYouLike bidder

* GumGum: adds description to bidfloor param (#2744)

* specifies us privacy is supported

* adds video support to gumgum md

* adds support for tcf 2

* adds new bid param to gumgum.md

* updates gumgum doc

* notes required mediaType for video products

* updates gumgum doc

* adds pubId and irisid params

* removes extra cell

* updates doc to include that bidfloor is in usd

* MediaNet analytics and adapter doc updates (#2749)

* Provide Better PBS-Go MakeBids Sample Code (#2751)

* Update the adot bidder documentation to add gvl_id (#2752)

* fixed pbs doc formatting (#2758)

* PBS-Java supports default request (#2763)

* adding link to prebid overview (#2764)

* Update yuktamedia.md (#2760)

Enable download and changed Registration info

* Update For GDPR Vendor ID Changes (#2750)

* Bidder params fix (#2767)

* renaming files to match bidder codes

* adding pbjs: true

* adding aliases to edge case bidders

* fixing aliasCode

* updates triplelift native info (#2768)

* removing tcf2 variable, general GDPR update (#2769)

* removing tcf2 variable, general GDPR update

* restoring gdpr_supported status

* fixed tcf2 column, added floors and member (#2770)

* First Party Data 2.0 doc updates (#2722)

* fpd2.0 updates

* minor edits

* table tuning

* removed diagram

* review comments from taxonomy team

* adding in version number

also added notes about PBJS 4.29 and before

Co-authored-by: Jean Stemp <jstemp@appnexus.com>

* adding user identity pages

* initial draft of identity section

Co-authored-by: Matt Vanderpol <matt@vanderpol.net>
Co-authored-by: Jean Stemp <jstemp@appnexus.com>
Co-authored-by: MartianTribe <steve@martiantribe.com>
Co-authored-by: Steve <ssuranie@appnexus.com>
Co-authored-by: WlsLogan <77974248+WlsLogan@users.noreply.github.com>
Co-authored-by: Aiholkin <artem.iholkin@smartyads.com>
Co-authored-by: Damyan <wyand@abv.bg>
Co-authored-by: jmjohansson <34456126+jmjohansson@users.noreply.github.com>
Co-authored-by: afsheenb <afsheenb@users.noreply.github.com>
Co-authored-by: Afsheen Bigdeli <afsheenb@namecast.net>
Co-authored-by: susyt <susan@fox.camp>
Co-authored-by: Hengsheng Cai <luke.hengshengcai@gmail.com>
Co-authored-by: hcai <caihengsheng@bytedance.com>
Co-authored-by: epomrnd <epomrnd@users.noreply.github.com>
Co-authored-by: Vasyl Zarva <vasyan.z@gmail.com>
Co-authored-by: mobfxoHB <74364234+mobfxoHB@users.noreply.github.com>
Co-authored-by: ppuviarasu <ppuviarasu@appnexus.com>
Co-authored-by: Stephen Johnston <stephenj@launchpowered.com>
Co-authored-by: Rok Sušnik <rsusnik@outbrain.com>
Co-authored-by: jdwieland8282 <wieland.jeff@gmail.com>
Co-authored-by: Léonard Labat <le.labat@criteo.com>
Co-authored-by: César Fernández <cfalonso@gmail.com>
Co-authored-by: iprom-adserver <79305981+iprom-adserver@users.noreply.github.com>
Co-authored-by: Gašper Žagar <gasper.zagar@iprom.si>
Co-authored-by: Jean Stemp <38964447+jeanstemp@users.noreply.github.com>
Co-authored-by: melendezgabbyz0 <77457257+melendezgabbyz0@users.noreply.github.com>
Co-authored-by: Gabriela Melendez <gabriela@adkernel.com>
Co-authored-by: vladi-mmg <vladi@m-m-g.com>
Co-authored-by: Olivier <osazos@adagio.io>
Co-authored-by: jxdeveloper1 <71084096+jxdeveloper1@users.noreply.github.com>
Co-authored-by: Bryan Szekely <49168870+bszekely1@users.noreply.github.com>
Co-authored-by: Patrick McCann <patmmccann@gmail.com>
Co-authored-by: faithnh <faithnh.stepmania.master@gmail.com>
Co-authored-by: faithnh <fullpong@unicorn.inc>
Co-authored-by: Laura Morillo-Velarde <laura.morillovelarde@gmail.com>
Co-authored-by: Carlos Barreiro Mata <barreymata@gmail.com>
Co-authored-by: guiann <guillaume.andouard@adyoulike.com>
Co-authored-by: Rahul Shandilya <67756716+c3p-0@users.noreply.github.com>
Co-authored-by: Scott Kay <noreply@syntaxnode.com>
Co-authored-by: Giudici-a <34242194+Giudici-a@users.noreply.github.com>
Co-authored-by: AbhijitBhosale23 <abhijit.bhosale23@gmail.com>
Co-authored-by: nllerandi3lift <75995508+nllerandi3lift@users.noreply.github.com>
  • Loading branch information
Show file tree
Hide file tree
Showing 232 changed files with 2,648 additions and 851 deletions.
64 changes: 63 additions & 1 deletion _data/sidebar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -506,6 +506,14 @@
sectionTitle:
subgroup: 8

- sbSecId: 1
title: Timeouts
link: /features/timeouts.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 8


#--------------Prebid Mobile--------------|

Expand Down Expand Up @@ -625,6 +633,14 @@
sectionTitle:
subgroup: 1

- sbSecId: 2
title: In App Native Ad Unit
link: /prebid-mobile/pbm-api/ios/pbm-native-inapp-ios.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 1

- sbSecId: 2
title: Video Outstream Ad Unit
link: /prebid-mobile/pbm-api/ios/pbm-videooutstreamadunit-ios.html
Expand Down Expand Up @@ -738,6 +754,14 @@
sectionTitle:
subgroup: 2

- sbSecId: 2
title: In App Native Ad Unit
link: /prebid-mobile/pbm-api/android/pbm-native-inapp-android.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 2

- sbSecId: 2
title: Banner Interstitial Ad Unit
link: /prebid-mobile/pbm-api/android/pbm-bannerinterstitialadunit-android.html
Expand Down Expand Up @@ -2007,7 +2031,7 @@
sbCollapseId: tools

- sbSecId: 8
title:
title:
link:
isHeader: 1
headerId: toolsinvis
Expand All @@ -2022,3 +2046,41 @@
isSectionHeader: 0
sectionTitle:
subgroup: 0

#-------------- Prebid Identity --------------|

- sbSecId: 9
title:
link:
isHeader: 0
isSectionHeader: 1
sectionTitle: Prebid Identity
sectionId: prebid-identity
subgroup: 1000
sbCollapseId: prebid-identity

- sbSecId: 9
title: invis
link:
isHeader: 1
headerId: invis
isSectionHeader: 0
sectionTitle:
subgroup: 0

- sbSecId: 9
title: Identity Overview
link: /identity/prebid-identity.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 0

- sbSecId: 9
title: SharedID and PubCommon ID
link: /identity/sharedIdPubCommon.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 0

22 changes: 16 additions & 6 deletions _includes/adops/adops-gam-video-setup.html
Original file line number Diff line number Diff line change
Expand Up @@ -36,19 +36,20 @@ <h2 id="line-item-setup">Line Item Setup</h2>
<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 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>

<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:
bidders, you will need to choose one of the following approaches:
<ul>
<li>a separate line item for each bidder, or</li>
<li>a creative for each cache service utilized by your implementation.</li>
<li>Create a separate line item for each bidder.</li>
<li>Include a creative for each cache service utilized by your implementation.</li>
<li>Use the <a href="/dev-docs/publisher-api-reference.html#setConfig-vast-cache">ignoreBidderCacheKey</a> option on setConfig({cache}).</li>
</ul>

<h3 id="creative-single-cache">Single Cache Location</h3>

If you only use bidders that provide full VAST responses, no special setup is needed. Otherwise, do the following:

<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>2. In the dialog that appears, choose <b>Redirect</b>.</p>
Expand All @@ -71,7 +72,7 @@ <h3 id="creative-single-cache">Single Cache Location</h3>

<p class="alert alert-info"><strong>Prebid Cache and the VAST creative URL warning</strong><br />
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
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 <b>Duration</b> to <b>1</b>.</p>
Expand All @@ -82,6 +83,15 @@ <h3 id="creative-single-cache">Single Cache Location</h3>

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

If you're utilizing any bidders that cache their own VAST, you have two options:

<ul>
<li>If you're using Prebid.js 4.28 or later, you can specify the <a href="/dev-docs/publisher-api-reference.html#setConfig-vast-cache">ignoreBidderCacheKey</a> option on setConfig({cache}). This will cause the browser to generate a VAST wrapper and cache it in your standard location. Then you can use the instructions
above for "Single Cache Location". The tradeoff is that this approach requires
the video player to unwrap one extra level of VAST.</li>
<li>Utilize creative-level targeting in the ad server. Keep reading for more details.</li>
</ul>

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/>
Expand Down
6 changes: 0 additions & 6 deletions _includes/send-all-bids-keyword-targeting.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,8 @@
{% capture infoNote %}
**Important:** Google Ad Manager has a key-value key character [limit](https://support.google.com/dfp_premium/answer/1628457?hl=en#Key-values) of up to **20 characters**. Some of the keys without truncation will exceed 20 chars. Prebid.js automatically truncates the key length to 20 characters. For example, `hb_adid_longBidderName` is truncated to `hb_adid_longBidderNa` (`me` is truncated). Note that the key is case-sensitive. To get the exact key-value keys for each bidder, find them at [Bidder Params](/dev-docs/bidders.html).
{% endcapture %}

{% include alerts/alert_note.html content=infoNote %}


{: .table .table-bordered .table-striped }
| Default Key | Scope | Description | Example |
| :---- |:---- | :---- | :---- |
| `hb_pb_BIDDERCODE` | Required | The price bucket. Used by the line item to target. Case sensitive and truncated to 20 chars. The `BIDDERCODE` is documented at [Bidder Params](/dev-docs/bidders.html). | `hb_pb_rubicon` = `2.10` |
| `hb_adid_BIDDERCODE` | Required | The ad Id. Used by the ad server creative to render ad. Case sensitive and truncated to 20 chars. The `BIDDERCODE` is documented at [Bidder Params](/dev-docs/bidders.html). | `hb_adid_longBidderNa` = `234234` |
| `hb_size_BIDDERCODE` | Optional | This is not required for adops. Case sensitive and truncated to 20 chars. | `hb_size_appnexus` = `300x250` |

64 changes: 64 additions & 0 deletions _layouts/analytics.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
{% include head.html %}

{% include nav.html %}


<div class="container pb-docs-container">

<div class="row ">

<div class="col-lg-3 sidebar" id="sidebar">

<div>
<button class="navbar-toggler d-lg-none" type="button" data-toggle="collapse" data-target="#sidebarContent" aria-controls="sidebarContent" aria-expanded="false" aria-label="Toggle Sidebar navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse d-lg-block" id="sidebarContent">
{% include left_nav.html %}
</div>
</div>

</div>

<div class="col-lg-9">
<div class="pb-content" markdown="1">

{% if page.is_full_screen %}
{{content}}
{% else %}

<div class="row">

<div class="col-md-9" role="main">
<div class="bs-docs-section">

<h3>{{ page.title }}</h3>

<h3>Features</h3>

{{content}}

</div>

</div>

</div>

{% endif %}


</div>


</div>
</div>
<!--end row-->
</div>
{% if page.title != "Credits" %}
{% if page.layout != "home" %}
{% include footer.html %}
{% endif %}
{% endif %}

</body>
</html>
10 changes: 5 additions & 5 deletions _layouts/bidder.html
Original file line number Diff line number Diff line change
Expand Up @@ -53,14 +53,14 @@ <h3>Features</h3>
<tr>
<th class="pbTh">Media Types</th>
<td class="pbTd">{% unless page.media_types contains 'no-display' %}display{% if page.media_types contains 'video' %},{% endif %}{% endunless %}{% if page.media_types contains 'video' %} video{% endif %}{% if page.media_types != "no-display, native" and page.media_types contains 'native' %}, native{% endif %}{% if page.media_types == "no-display, native" %}native{% endif %}</td>
<th class="pbTh">GDPR TCF1 Support</th>
<th class="pbTh">GDPR TCF Support</th>
<td class="pbTd">{% if page.gdpr_supported == true %}yes{% else %}no{% endif %}</td>
</tr>
<tr>
<th class="pbTh">User IDs</th>
<td class="pbTd">{% if page.userIds and page.userIds != '' %}{{page.userIds}}{% else %}none{% endif %}</td>
<th class="pbTh">GDPR TCF2 Support</th>
<td class="pbTd">{% if page.tcf2_supported == true %}yes{% else %}no{% endif %}</td>
<th class="pbTh">USP/CCPA Support</th>
<td class="pbTd">{% if page.usp_supported == true %}yes{% else %}no{% endif %}</td>
</tr>
<tr>
<th class="pbTh">SChain Support</th>
Expand All @@ -71,8 +71,8 @@ <h3>Features</h3>
<tr>
<th class="pbTh">Safeframes OK</th>
<td class="pbTd">{% if page.safeframes_ok == false %}no{% elsif page.safeframes_ok == true %}yes{% else %}check with bidder{% endif %}</td>
<th class="pbTh">USP/CCPA Support</th>
<td class="pbTd">{% if page.usp_supported == true %}yes{% else %}no{% endif %}</td>
<th class="pbTh"></th>
<td class="pbTd"></td>
</tr>
<tr>
<th class="pbTh">Supports Deals</th>
Expand Down
10 changes: 9 additions & 1 deletion _layouts/home.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
<div class="row justify-content-center text-center mt-6">
<div class="col-md-10">
<h1>Prebid Documentation</h1>
<p>Welcome to the Prebid.org technical documentation portal. Here you will find the help you need to work with the Prebid.org family of products. Visit <a href="https://prebid.org" target="_blank">Prebid.org</a> for general product overviews, blog updates, and additional information on membership and events.</p>
<p>Welcome to the Prebid.org technical documentation portal. Here you will find the help you need to work with the Prebid.org family of products. Visit <a href="https://prebid.org" target="_blank">Prebid.org</a> for general product overviews, blog updates, and additional information on membership and events. If you're wondering what Prebid and Header Bidding are all about, check out <a href="https://prebid.org/why-prebid/" target="_blank">Why Prebid?</a></p>
</div>
</div> <!-- row -->

Expand Down Expand Up @@ -42,6 +42,14 @@ <h1>Prebid Documentation</h1>
<p class="mt-4"><a href="/prebid-mobile/download.html">Download Mobile SDK</a></p>
</div>
</div>
<div class="card text-center">
<div class="card-body">
<div class="card-media"><img src="/assets/images/user-identity.png" width=100 alt="Prebid User Identity Icon"></div>
<div class="card-title"><h3>Prebid User Identity</h3></div>
<p class="mb-4">Supporting a thriving open web while respecting user privacy.</p>
<a href="/identity/prebid-identity.html" class="btn btn-outline-brand">View Docs</a>
</div>
</div>
</div>

<div class="row text-center mt-7">
Expand Down
19 changes: 10 additions & 9 deletions adops/send-all-bids-adops.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,23 +13,24 @@ sidebarType: 3

This page shows how to set up your ad server so that you can send all bids and report on them.

As a publisher, you may wish to have your ad server see **all** header bidding bids (instead of seeing only the winning bids in each auction). Reasons you might want this behavior include:
* TOC
{: toc }

## Overview

As a publisher, you may want to have your ad server see **all** header bidding bids (instead of seeing only the winning bids in each auction). Reasons you might want this behavior include:

+ You want your ad server to see all header bidding bids, so that your ad server can report on bid prices, instead of only winning prices
+ You want your ad server to see all header bidding bids so that your ad server can report on bid prices instead of only winning prices.

+ You have a contractual agreement with your header bidding partner
+ You have a contractual agreement with your header bidding partner.

{: .alert.alert-success :}
See the [Publisher API Reference]({{site.baseurl}}/dev-docs/publisher-api-reference.html#setConfig-Send-All-Bids) for more details.

* TOC
{: toc }

## Overview

+ Your developers may optionally add `enableSendAllBids: true` to `pbjs.setConfig()`. This is not strictly necessary, as `enableSendAllBids` defaults to `true`. For details, see the [Publisher API Reference]({{site.baseurl}}/dev-docs/publisher-api-reference.html#setConfig-Send-All-Bids).
If you decide to send all bids to the ad sever, your developers have the option of explicity adding `enableSendAllBids: true` to `pbjs.setConfig()`. However, since the default value is `true` this addition is not strictly necessary. For details, see the [Publisher API Reference]({{site.baseurl}}/dev-docs/publisher-api-reference.html#setConfig-Send-All-Bids).

+ From the ad ops side, you may choose to set up one order per bidder, so that each order can have a set of line items using targeting keywords that include the bidder's name. For example, if you are working with [Rubicon]({{site.baseurl}}/dev-docs/bidders.html#rubicon), you would use `hb_pb_rubicon` in your line item's key-value targeting, and `hb_adid_rubicon` in the creative.
From the ad ops side, you can choose to set up one order per bidder, which allows for each order to have a set of line items using targeting keywords that include the bidder's name. For example, if you are working with [Rubicon](/dev-docs/bidders.html#rubicon), you would use `hb_pb_rubicon` in your line item's key-value targeting, and `hb_adid_rubicon` in the creative.

{% include send-all-bids-keyword-targeting.md %}

Expand Down
Binary file added assets/images/dev-docs/prebid-timeouts.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/images/flowcharts/FirstPartyData-Detailed.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed assets/images/flowcharts/FirstPartyData-Summary.png
Binary file not shown.
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.
Binary file added assets/images/sharedid.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/user-identity.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 8 additions & 6 deletions dev-docs/adunit-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ See the table below for the list of properties on the ad unit. For example ad u
| `mediaTypes` | Optional | Object | Defines one or more media types that can serve into the ad unit. For a list of properties, see [`adUnit.mediaTypes`](#adUnit.mediaTypes) below. |
| `labelAny` | Optional | Array[String] | Used for [conditional ads][conditionalAds]. Works with `sizeConfig` argument to [pbjs.setConfig][configureResponsive]. |
| `labelAll` | Optional | Array[String] | Used for [conditional ads][conditionalAds]. Works with `sizeConfig` argument to [pbjs.setConfig][configureResponsive]. |
| `fpd` | Optional | Object | Similar to [global first party data configuration](/dev-docs/publisher-api-reference.html#setConfig-fpd), but specific to this adunit. |
| `ortb2Imp` | Optional | Object | Similar to [global first party data configuration](/dev-docs/publisher-api-reference.html#setConfig-fpd), but specific to this adunit. Note that the setConfig data is global to the logical OpenRTB object, but AdUnit-specific data is defined in the scope of a particular imp object. |

<a name="adUnit.bids" />

Expand Down Expand Up @@ -531,18 +531,20 @@ pbjs.addAdUnits({
sizes: [[300,250]]
}
},
fpd: {
context: {
pbAdSlot: "homepage-top-rect",
adUnitSpecificContextAttribute: "123"
ortb2Imp: {
ext: {
data: {
pbAdSlot: "homepage-top-rect",
adUnitSpecificContextAttribute: "123"
}
}
},
...
});
{% endhighlight %}

Notes:
- Only contextual data is supported on the AdUnit; user-related data goes in the [global first party data](/dev-docs/publisher-api-reference.html#setConfig-fpd).
- Only contextual data should be added on the AdUnit; user-related data goes in the [global first party data](/dev-docs/publisher-api-reference.html#setConfig-fpd) config.
- For additional help with analytics and reporting you can use the [Prebid Ad Slot](/features/pbAdSlot.html), a special type of first party data.

## Related Topics
Expand Down
11 changes: 11 additions & 0 deletions dev-docs/analytics/adWMG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
layout: analytics
title: adWMG
description: adWMG Analytics Adapter
modulecode: adWMG
---

#### Registration

Please visit [https://adwmg.com/](https://adwmg.com/) for more information.

12 changes: 12 additions & 0 deletions dev-docs/analytics/adagio.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
layout: analytics
title: Adagio
description: Adagio Analytics Adapter
modulecode: adagio
prebid_member: true
---

#### Registration

Please visit [https://adagio.io/](https://adagio.io/) for more information.

11 changes: 11 additions & 0 deletions dev-docs/analytics/adkernelAdn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
layout: analytics
title: Adkernel
description: Adkernel Analytics Adapter
modulecode: adkernelAdn
---

#### Registration

Please visit []() for more information.

12 changes: 12 additions & 0 deletions dev-docs/analytics/adomik.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
layout: analytics
title: Adomik
description: Adomik Analytics Adapter
modulecode: adomik
prebid_member: true
---

#### Registration

Please visit []() for more information.

Loading

0 comments on commit b4b23fa

Please sign in to comment.