Skip to content

Documentation update for msft.md #6512

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.

Sign up for GitHub

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

Open
jasonc721 wants to merge 2 commits into
base: master
Choose a base branch
from
+9 −0
Open

Documentation update for msft.md #6512

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
60098ee
Update msft.md
Mar 31, 2026
7d02a63
Update msft.md
Mar 31, 2026
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
9 changes: 9 additions & 0 deletions dev-docs/bidders/msft.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
sidebarType: 1
---

### Table of Contents

Check failure on line 24 in dev-docs/bidders/msft.md

View workflow job for this annotation

GitHub Actions / run markdownlint

Heading levels should only increment by one level at a time 

dev-docs/bidders/msft.md:24 MD001/heading-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md001.md

- [Table of Contents](#table-of-contents)
- [Bid Params](#bid-params)
Expand All @@ -48,7 +48,7 @@
{: .table .table-bordered .table-striped }

| Name | Scope | Description | Example | Type |
|------|-------|-------------|---------|------|

Check failure on line 51 in dev-docs/bidders/msft.md

View workflow job for this annotation

GitHub Actions / run markdownlint

Table column style 

dev-docs/bidders/msft.md:51:40 MD060/table-column-style Table column style [Table pipe is missing space to the right for style "compact"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md060.md

Check failure on line 51 in dev-docs/bidders/msft.md

View workflow job for this annotation

GitHub Actions / run markdownlint

Table column style 

dev-docs/bidders/msft.md:51:40 MD060/table-column-style Table column style [Table pipe is missing space to the left for style "compact"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md060.md

Check failure on line 51 in dev-docs/bidders/msft.md

View workflow job for this annotation

GitHub Actions / run markdownlint

Table column style 

dev-docs/bidders/msft.md:51:30 MD060/table-column-style Table column style [Table pipe is missing space to the right for style "compact"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md060.md

Check failure on line 51 in dev-docs/bidders/msft.md

View workflow job for this annotation

GitHub Actions / run markdownlint

Table column style 

dev-docs/bidders/msft.md:51:30 MD060/table-column-style Table column style [Table pipe is missing space to the left for style "compact"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md060.md

Check failure on line 51 in dev-docs/bidders/msft.md

View workflow job for this annotation

GitHub Actions / run markdownlint

Table column style 

dev-docs/bidders/msft.md:51:16 MD060/table-column-style Table column style [Table pipe is missing space to the right for style "compact"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md060.md

Check failure on line 51 in dev-docs/bidders/msft.md

View workflow job for this annotation

GitHub Actions / run markdownlint

Table column style 

dev-docs/bidders/msft.md:51:16 MD060/table-column-style Table column style [Table pipe is missing space to the left for style "compact"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md060.md

Check failure on line 51 in dev-docs/bidders/msft.md

View workflow job for this annotation

GitHub Actions / run markdownlint

Table column style 

dev-docs/bidders/msft.md:51:8 MD060/table-column-style Table column style [Table pipe is missing space to the right for style "compact"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md060.md

Check failure on line 51 in dev-docs/bidders/msft.md

View workflow job for this annotation

GitHub Actions / run markdownlint

Table column style 

dev-docs/bidders/msft.md:51:8 MD060/table-column-style Table column style [Table pipe is missing space to the left for style "compact"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md060.md

Check failure on line 51 in dev-docs/bidders/msft.md

View workflow job for this annotation

GitHub Actions / run markdownlint

Table column style 

dev-docs/bidders/msft.md:51:1 MD060/table-column-style Table column style [Table pipe is missing space to the right for style "compact"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md060.md
| `placement_id` | required (see note above) | The placement ID from Microsoft Monetize. You may identify a placement using the `inv_code` and `member` instead of a placement ID. | `11223344` | `integer` |
| `member` | required (see note above) | The member ID from Microsoft Monetize. Must be used with `inv_code`. | `1234` | `integer` |
| `inv_code` | required (see note above) | The inventory code from Microsoft Monetize. Must be used with `member`. | `'abc123'` | `string` |
Expand All @@ -67,6 +67,10 @@

If you are migrating from the AppNexus bid adapter, a number of the previously available AppNexus bid parameters have been deprecated as available options for the Microsoft bid parameters. These deprecated bid parameters are still available however, they're just read from other standarized locations offered within Prebid.js. This change was implemented to help us align better to the publisher-aligned features (such as First Party Data) to use a single setup for many bidders.

The Microsoft Bid Adapter connects to Microsoft's advertising exchange for bids. This adapter supports banner, video (instream and outstream), and native ad formats using OpenRTB 2.5 standards.

For reference, here is the IAB OpenRTB 2.5 [specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)

The following table shows how the bid parameters have changed between the two adapters:

{: .table .table-bordered .table-striped }
Expand All @@ -93,6 +97,11 @@
| `params.ext_inv_code` | `params.ext_inv_code` | External inventory code (unchanged) |
| `params.external_imp_id` | `params.ext_imp_id` | External impression ID (shortend to ext) |

#### Keywords
With the AppNexus adapter, keywords followed this format: keyname=keyvalue1,keyvalue2,keyvalue3

In the Microsoft Bid Adapter, the new required format is: keyname=keyvalue1,keyname=keyvalue2,keyname=keyvalue3

<a name="migration-from-appnexus-adserver-targeting"></a>

#### Migrating from the AppNexus Bid Adapter & Ad Server Targeting
Expand Down
Loading