Skip to content
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

update based on new prebid.org site content #2321

Merged
merged 2 commits into from
Sep 10, 2020
Merged
Show file tree
Hide file tree
Changes from all 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
41 changes: 1 addition & 40 deletions _data/sidebar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -27,14 +27,6 @@
sectionTitle:
subgroup: 0

- sbSecId: 0
title: About Prebid.org
link: /overview/what-is-prebid-org.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 0

- sbSecId: 0
title: Project Principles
link: /principles.html
Expand All @@ -43,22 +35,6 @@
sectionTitle:
subgroup: 0

- sbSecId: 0
title: Membership
link: /partners/partners.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 0

- sbSecId: 0
title: Prebid Management Committees
link: /overview/prebid-management-committees.html
isHeader: 0
isSectionHeader: 0
sectionTitle:
subgroup: 0

- sbSecId: 0
title: Developers
link: /developers.html
Expand All @@ -83,13 +59,6 @@
sectionTitle:
subgroup: 0

- sbSecId: 0
title: '  Community'
link: /overview/community-code-of-conduct.html
isHeader: 0
isSectionHeader: 0
subgroup: 0

- sbSecId: 0
title: '  Module Rules'
link: /dev-docs/module-rules.html
Expand Down Expand Up @@ -137,14 +106,6 @@
isSectionHeader: 0
subgroup: 0

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

#--------------Prebid.js--------------|

Expand Down Expand Up @@ -2076,7 +2037,7 @@

- sbSecId: 7
title: Blog
link: /blog.html
link: https://prebid.org/blog/
isHeader: 0
isSectionHeader: 0
sectionTitle:
Expand Down
2 changes: 1 addition & 1 deletion dev-docs/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Nope. The only approval process is a code review. There are separate instruction
- [adding a bidder in Prebid.js](/dev-docs/bidder-adaptor.html)
- [adding an analytics adapter in Prebid.js](/dev-docs/integrate-with-the-prebid-analytics-api.html)

As for [membership](/partners/partners.html) in Prebid.org, that's entirely optional -- we'd be happy to have you join and participate in the various committees,
As for [membership](https://prebid.org/membership/) in Prebid.org, that's entirely optional -- we'd be happy to have you join and participate in the various committees,
but it's not necessary for contributing code as a community member.

## When starting out, what should my timeouts be?
Expand Down
2 changes: 1 addition & 1 deletion dev-docs/integrate-with-the-prebid-analytics-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -169,7 +169,7 @@ st of other analytics adapters.

### Step 6: Wait for Prebid volunteers to review

We sometimes get pretty busy, so it can take a couple of weeks for the review process to complete, so while you're waiting, consider [joining Prebid.org](/partners/partners.html) to help us out with code reviews. (!)
We sometimes get pretty busy, so it can take a couple of weeks for the review process to complete, so while you're waiting, consider [joining Prebid.org](https://prebid.org/membership/) to help us out with code reviews. (!)

## Further Reading

Expand Down
19 changes: 9 additions & 10 deletions faq/prebid-server-faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Nope. The only approval process is a code review. There are separate instruction
- [Prebid Server - Go](https://github.com/prebid/prebid-server/blob/master/docs/developers/add-new-bidder.md)
- [Prebid Server - Java](https://github.com/rubicon-project/prebid-server-java/blob/master/docs/developers/add-new-bidder.md)

As for [membership](/partners/partners.html) in Prebid.org, that's entirely optional -- we'd be happy to have you join and participate in the various committees,
As for [membership](https://prebid.org/membership/) in Prebid.org, that's entirely optional -- we'd be happy to have you join and participate in the various committees,
but it's not necessary for contributing code as a community member.

## How can I debug Prebid Server requests?
Expand Down Expand Up @@ -72,12 +72,12 @@ pbjs.setConfig({

There are 3 answers here. The easy answer is for requests coming into Prebid Server from the Prebid SDK - there's no concept of cookies there, so no syncing takes place in that scenario. ID in mobile is based on IDFA.

For other scenarios, Prebid Server sets up and manages a multi-vendor ID match table in the `uids` cookie in the host company's
domain. i.e. adnxs.com, rubiconproject.com, or whichever Prebid Server vendor you're utilizing. When the user has a `uids` cookie,
For other scenarios, Prebid Server sets up and manages a multi-vendor ID match table in the `uids` cookie in the host company's
domain. i.e. adnxs.com, rubiconproject.com, or whichever Prebid Server vendor you're utilizing. When the user has a `uids` cookie,
Prebid Server parses it and passes the vendor-specific IDs to the relevant server-side bid adapters.

Syncing in the AMP scenario uses the [load-cookie.html](/dev-docs/show-prebid-ads-on-amp-pages.html#user-sync) file that's part of
the Prebid Universal Creative package. When placed into an AMP-iframe, this file will call /cookie-sync and initiate a sync that
Syncing in the AMP scenario uses the [load-cookie.html](/dev-docs/show-prebid-ads-on-amp-pages.html#user-sync) file that's part of
the Prebid Universal Creative package. When placed into an AMP-iframe, this file will call /cookie-sync and initiate a sync that
creates or updates the `uids` cookie.

The most common source of requests for Prebid Server is from Prebid.js in a scenario where the user doesn't have any cookies for the Prebid Server domain.
Expand All @@ -93,9 +93,9 @@ The most common source of requests for Prebid Server is from Prebid.js in a scen


{: .alert.alert-info :}
Note: the company that's hosting Prebid Server can configure it to read and utilize their exchange's
native cookie. i.e. if you're using Rubicon Project's Prebid Server, it can read their 'khaos' cookie, and if you're using
AppNexus' Prebid Server, it can read their 'uuid2' cookie. In other words, if the host company is an exchange and the user
Note: the company that's hosting Prebid Server can configure it to read and utilize their exchange's
native cookie. i.e. if you're using Rubicon Project's Prebid Server, it can read their 'khaos' cookie, and if you're using
AppNexus' Prebid Server, it can read their 'uuid2' cookie. In other words, if the host company is an exchange and the user
has the exchange cookie, the host company will have an ID one page-view sooner than the other bidders. This gives a slight edge to
the hosting company in some scenarios, but it's technically unavoidable and better for both buyers and sellers to have one ID available rather than zero.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Has the branding changed on any of these - Appnexus and Rubicon?


Expand All @@ -107,7 +107,7 @@ See the [Prebid Server Privacy Feature Page](/prebid-server/features/pbs-privacy

For Prebid.js-initated server requests, we've found that cookie match rates are about what can be expected given the constraints:

- The [/cookie_sync](/prebid-server/developers/pbs-cookie-sync.html) process is initiated by Prebid.js the moment the [s2sConfig](https://docs.prebid.org/dev-docs/publisher-api-reference.html#setConfig-Server-to-Server) is parsed.
- The [/cookie_sync](/prebid-server/developers/pbs-cookie-sync.html) process is initiated by Prebid.js the moment the [s2sConfig](https://docs.prebid.org/dev-docs/publisher-api-reference.html#setConfig-Server-to-Server) is parsed.
- A limited number of bidders will be synced at once. PBS-Go will sync all the bidders listed in the `bidders` array. PBS-Java will sync all of them and possibly additional bidders. Publishers can change the number of syncs by specifying `userSyncLimit` on the s2sConfig.
- Privacy settings (e.g. GDPR) can affect sync rate. e.g. If a lot of your traffic is in the EEA, it's going to be harder to set cookies.

Expand All @@ -117,4 +117,3 @@ For Prebid.js-initated server requests, we've found that cookie match rates are
- Then AMP has to run this iframe. There are limitations as to where this amp-iframe can be on the page and possible how many amp-iframes there are on the page.
- The [/cookie_sync](/prebid-server/developers/pbs-cookie-sync.html) call is initiated from `load-cookie.html`, but there are many adapters on the server side, and a limited number of them will be synced at once. Consider setting `max_sync_count` higher to get all bidders synced faster,
- In a GDPR context, AMP doesn't supply the `gdprApplies` field. Prebid Server will determine for itself whether it can sync cookies, but it will not tell bidders whether the request is in GDPR-scope, so each bidder will have to determine scope for itself.

5 changes: 4 additions & 1 deletion overview/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,14 +12,17 @@ sidebarType: 0

## Overview

{: .alert.alert-info :}
If you're looking for a more high-level overview of Prebid.org, including product features, membership, events, and so on, visit [Prebid.org](https://prebid.org/).

Prebid is more than a product; it's a product suite, a community, and an organization.

- **Product Suite:** A free and open source suite of software products designed to enable publishers to implement header bidding on their websites and from within their apps. Our product line includes:
- <span style="color:#EA9622">**Prebid.js:**</span> The core of our codebase. Prebid.js provides a simple and easy-to-implement code set to improve header bidding for display and video ads on a publisher's website and within OTT applications.
- <span style="color:#EA9622">**Prebid Server:**</span> Provides a hosted or custom server-side solution for header bidding. Utilizing Prebid Server can reduce latency between bid request and ad selection, and speed the presentation of your site and ads.
- <span style="color:#EA9622">**Prebid Mobile:**</span> Our native iOS and Android solutions to enable header bidding within a mobile app.
- **Community:** The developers that maintain and improve our products.
- **Organization:** A collection of leaders within the ad tech industry that promotes our products, works with the ad tech community to expand the solutions our products can provide, and encourages the development of the platform.
- **Organization:** A collection of leaders within the ad tech industry that promotes our products, works with the ad tech community to expand the solutions our products can provide, and encourages the development of the platform. For more about the organization, see the [Prebid.org](https://prebid.org/) website.

{% include alerts/alert_note.html content="Our flagship product, Prebid.js, is sometimes referred to as simply *Prebid*, but please be aware that the Prebid product line supports header bidding for web, AMP, and mobile apps, using both client- and server-side project components." %}

Expand Down
6 changes: 3 additions & 3 deletions overview/what-is-prebid-org.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Formed in September of 2017, Prebid.org is an independent organization designed

Prebid.org is open to all companies who are part of the programmatic ecosystem, from ad tech vendors to publishers and others. We believe strongly that by working together, we can do some great things in the industry.

[Learn more](/partners/partners.html) about becoming a member of Prebid.org.
[Learn more](https://prebid.org/membership/) about becoming a member of Prebid.org.

## Operations
Managed through Product Management Committees (PMCs)
Expand Down Expand Up @@ -44,6 +44,6 @@ Prebid welcomes any contribution on these projects!

Read more here:

* [Prebid.org Members and Partners](/partners/partners.html)
* [Prebid.org Members and Partners](https://prebid.org/membership/)
* [The Drum reporting on Prebid.org](https://www.thedrum.com/news/2017/09/11/appnexus-and-rubicon-project-launch-prebidorg-hailing-open-source-approach-header)
* [Current members of Prebid.org]({{site.baseurl}}/partners/partners.html)
* [Current members of Prebid.org](https://prebid.org/membership/member-directory/)
2 changes: 1 addition & 1 deletion prebid-server/overview/prebid-server-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,4 +60,4 @@ If you're a demand source, we also have information about [creating your own ser
If you need help with Prebid Server, the best ways to communicate with us are:

- [Post an issue](https://github.com/prebid/prebid-server/issues) in the prebid-server GitHub repo.
- [Join prebid.org](/partners/partners.html) and get access to our Slack workspace.
- [Join prebid.org](https://prebid.org/membership/) and get access to our Slack workspace.
1 change: 1 addition & 0 deletions wrapper_code_of_conduct.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,3 +57,4 @@ This Wrapper Code of Conduct establishes the principles by which we believe head

+ [Project Principles]({{site.baseurl}}/principles.html)
+ [Getting Started]({{site.baseurl}}/overview/getting-started.html)
+ [Prebid.org Community Code of Conduct](https://prebid.org/code-of-conduct/)