Skip to content

Commit

Permalink
Merge branch 'prebid:master' into master
Browse files Browse the repository at this point in the history
  • Loading branch information
mscottnelson authored Nov 17, 2023
2 parents d3c896c + 2a6979d commit fda12d7
Show file tree
Hide file tree
Showing 11 changed files with 388 additions and 332 deletions.
4 changes: 2 additions & 2 deletions _data/sidebar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -264,7 +264,7 @@
subgroup: 1

- sbSecId: 1
title: Using Prebid.js with AppNexus Publisher Ad Server
title: Using Prebid.js with Microsoft Monetize Ad Server
link: /dev-docs/examples/use-prebid-with-appnexus-ad-server.html
isHeader: 0
isSectionHeader: 0
Expand Down Expand Up @@ -1098,7 +1098,7 @@
subgroup: 2

- sbSecId: 3
title: "AppNexus Publisher"
title: "Microsoft Monetize Publisher"
link:
isHeader: 0
isSectionHeader: 0
Expand Down
6 changes: 3 additions & 3 deletions adops/price-granularity.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,11 +90,11 @@ The auto option contains a series of predefined buckets. Any bid over the cap fa
{: .table .table-bordered .table-striped }
| Increment | Cap | Number of Line Items Required per Bidder |
| --------- | --- | ---------------------------------------- |
| 0.05 | 5.00 | 51 |
| 0.05 | 5.00 | 101 |
| 0.10 | 10.00 | 50 |
| 0.50 | 20.00 | 10 |
| 0.50 | 20.00 | 20 |
| Any bid > 20.00 | 20.00 | n/a |
| | | Total: 111 |
| | | Total: 171 |

#### Dense

Expand Down
100 changes: 57 additions & 43 deletions adops/setting-up-prebid-with-the-appnexus-ad-server.md
Original file line number Diff line number Diff line change
@@ -1,42 +1,40 @@
---
layout: page_v2
title: Setting up Prebid with the Xandr Publisher Ad Server
head_title: Setting up Prebid with the Xandr Publisher Ad Server
description: Setting up Prebid with the Xandr Publisher Ad Server
title: Setting up Prebid with the Microsoft Monetize Ad Server
head_title: Setting up Prebid with the Microsoft Monetize Ad Server
description: Setting up Prebid with the Microsoft Monetize Ad Server
pid: 3

top_nav_section: adops
nav_section: tutorials
sidebarType: 3
---



# Setting up Prebid with the Xandr Publisher Ad Server
# Setting up Prebid with the Microsoft Monetize Ad Server

{: .no_toc}

This page describes how to set up the Xandr Publisher Ad Server to work with Prebid.js from an Ad Ops perspective.
This page describes how to set up the Microsoft Monetize Ad Server to work with Prebid.js from an Ad Ops perspective.

In some cases there are links to the [Xandr Help Center](https://monetize.xandr.com/docs/home) which require a customer login.
In some cases there are links to the [Microsoft Help Center](https://docs.xandr.com/).

Once the Ad Ops setup is complete, developers will need to add code to the page as shown in the example [Using Prebid.js with Xandr as your Ad Server]({{site.github.url}}/dev-docs/examples/use-prebid-with-appnexus-ad-server.html).
Once the Ad Ops setup is complete, developers will need to add code to the page as shown in the example [Using Prebid.js with Microsoft Monetize as your Ad Server]({{site.github.url}}/dev-docs/examples/use-prebid-with-appnexus-ad-server.html).

{: .alert.alert-success :}
**Xandr Publisher Ad Server Features**
Note that the functionality described on this page uses some features that are only available in the Xandr Publisher Ad Server product, such as [key-value targeting](https://monetize.xandr.com/docs/key-value-targeting). For more information, contact your Xandr representative.
**Microsoft Monetize Ad Server Features**
Note that the functionality described on this page uses some features that are only available in the Microsoft Monetize Ad Server product. For more information, contact your Microsoft Monetize representative.

{: .alert.alert-info :}
**Object Limits**
Note that using Prebid with Xandr as your ad server may cause you to
hit your Xandr [Object Limits](https://monetize.xandr.com/docs/viewing-your-object-limits).
**Object Limits**
Note that using Prebid with Microsoft Monetize as your Ad Server may cause you to
hit your [Object Limits](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/viewing-your-object-limits.html).

* TOC
{:toc}

## Step 1. Add Key-Values

In the [key-value targeting](https://monetize.xandr.com/docs/key-value-targeting) in Console, set up the keys and values shown below. Keep in mind that all of the keys described below should use string values (**not** numeric).
In the [key-value targeting](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/key-value-targeting.html) in Monetize, set up the keys and values shown below. Keep in mind that all of the keys described below should use string values (**not** numeric).

If you are only sending the winning bid to the ad server, set up your keys like so:

Expand Down Expand Up @@ -64,17 +62,22 @@ For more information about how to set up price bucket granularity in Prebid.js c
{: .alert.alert-success :}
You can only report on price bucket values if you provide them in the <a href="https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/key-value-targeting.html">Key-Value Targeting UI</a>.

## Step 2. Add Creatives
## Step 2. Add Advertiser

Depending on whether you are sending all bids or sending top bid you will need to create an Advertiser per bidder e.g. *Rubicon - Prebid Advertiser* vs *Prebid Advertiser*

You'll need one creative per ad size you'd like to serve. You can re-use a creative across any number of line items and campaigns.
Follow the advertiser setup instructions in [Create an Advertiser](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/create-an-advertiser.html)

Follow the creative setup instructions in [Add Creatives](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/add-a-creative.html) with the following setting:
## Step 3. Add Creatives

* Select **Show Template Selector**.
* Select a template with an HTML format.
* Paste the code snippet shown below into the code box.
You'll need one creative per ad size you'd like to serve. You can re-use a creative across any number of line items, as long as the creative belongs to the same advertiser as the line item.

![New creative]({{ site.github.url }}/assets/images/ad-ops/appnexus-setup/prebid-creative-appnexus.png) {: .pb-lg-img :}
Follow the banner creative setup instructions in [Add Creatives](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/add-a-creative.html), navigating the the Creative Manager and selecting the appropriate advertiser from the previous step, with the following setting:

* Paste the below universal creative code as the creative asset tag code.
* Name the creative e.g. *Rubicon - Prebid Creative 300x250*.
* Select the creative size e.g. *300x250*.
* Self-Audit the creative and confirm compliance.

```html
<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/#{HB_FORMAT}.js"></script>
Expand All @@ -99,54 +102,65 @@ Follow the creative setup instructions in [Add Creatives](https://docs.xandr.com
```

{: .alert.alert-warning :}
**Creative Expiration**
Note that creatives are automatically marked as inactive by the Xandr systems after 45 days of inactivity. This may happen to Prebid creatives since they are loaded relatively infrequently compared to other use cases. For help with mitigating this issue, please contact your Xandr representative.
**Creative Expiration**
Note that creatives are automatically marked as inactive by the Microsoft Monetize systems after 45 days of inactivity. This may happen to Prebid creatives since they are loaded relatively infrequently compared to other use cases. For help with mitigating this issue, please contact your Microsoft Monetize representative.

{: .alert.alert-warning :}
**SafeFrame**
If you want your creative to serve into a SafeFrame, this will need to be enabled on the site-side of the Prebid.js implementation rather than as a setting in the ad server. A developer can learn how to enable this setting for the publisher by referencing [Using Prebid.js with Xandr Publisher Ad Server]({{site.github.url}}/dev-docs/examples/use-prebid-with-appnexus-ad-server.html). Additionally if the Xandr ad server tags are configured to use SafeFrames, you **will** need to use the above creative template to properly render the creative. Earlier versions of the Prebid.js creative template may not be fully SafeFrame compliant (if they are still in-use from older setups), so it is recommended to switch to the above template in this scenario.
If you want your creative to serve into a SafeFrame, this will need to be enabled on the site-side of the Prebid.js implementation rather than as a setting in the ad server. A developer can learn how to enable this setting for the publisher by referencing [Using Prebid.js with Microsoft Monetize Ad Server]({{site.github.url}}/dev-docs/examples/use-prebid-with-appnexus-ad-server.html). Additionally if the Microsoft Monetize Ad Server tags are configured to use SafeFrames, you **will** need to use the above creative template to properly render the creative. Earlier versions of the Prebid.js creative template may not be fully SafeFrame compliant (if they are still in-use from older setups), so it is recommended to switch to the above template in this scenario.

## Step 4. Set up Insertion Order

You'll need to create an insertion order, belonging to your advertiser, for your line items.

## Step 3. Set up Line Items
Follow the insertion order setup setup instructions in [Create a Seamless Insertion Order (IO)](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/create-an-insertion-order.html), with the following settings:

You'll need to create one line item for every price bucket you intend to serve.
* Choose a flexible budget type.
* Set no end date.

## Step 5. Set up Line Items

You'll need to create one line item for every price bucket you intend to serve. These line items will need to be under the advertiser and insertion order in step 2 and 4.

For example, if you want to have $0.10 price granularity, you'll need 201 line items, one for each of your key-value targeting settings from Step 1.

For each line item, follow the line item setup instructions in [Create a Line Item](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/create-a-standard-line-item.html), with the following settings:
For each line item, follow the line item setup setup instructions in [Create an Augmented Line Item (ALI)](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/create-an-augmented-line-item-ali.html), with the following settings:

* Set the **Revenue Type** to *CPM*.
* Set the **Name** e.g., *€00.01 - Rubicon - Prebid Banner*.

* Set the **Revenue Value** to one of the price bucket key-values from Step 1, e.g., \$0.2.
* Set **Ad Type** Banner.

* Set the **Revenue Type** to *CPM*.

* Under **Associated Creatives**, choose to manage creatives at the line item level.
* Set the **Revenue Value** to one of the price bucket key-values from Step 1, e.g., *0.01*.

* Associate as many creative sizes with the line item as you need. Set the **Creative Rotation** to *Even*.
* Set the **Budget Setup** to *Unlimited Budget*.

* In your line item's targeting settings, use the key-value that matches the line item's price bucket, e.g. (you set these up in Step 1).
* Set the **End Date** sometime in the future e.g. *6/26/2033*.

* Still in the targeting settings, target the custom category `prebid_enabled`. This will allow you to turn targeting on and off for a placement (or an entire placement group) by adding it to the custom category, which you'll do in one of the later steps. This is useful for troubleshooting.
* Within **Inventory & Brand Safety Targeting** and for **Supply Source** select *Managed Inventory*.

For more information about targeting custom content categories, see [Content Category Targeting](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/content-category-targeting.html).
* Set the **Line Item Priority** for more information on line item priority see [Bidding Priority](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/bidding-priority.html)

## Step 4. Set up Campaigns
* Optional: Still in the targeting settings, target the custom category `prebid_enabled`. This will allow you to turn targeting on and off for a placement (or an entire placement group) by adding it to the custom category, which you'll do in one of the later steps. This is useful for troubleshooting. For more information about targeting custom content categories, see [Content Category Targeting](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/content-category-targeting.html).

For each line item, create one campaign to associate with it. The campaign should have an unlimited budget, start running right away, and run indefinitely.
* In your line item's targeting settings, set the **Key/Value Targeting** to match the line item's price bucket/revenue value.

You shouldn't have to do anything else. All other settings (such as budget and targeting) are inherited from the line item.
* Under **Creatives**, associate as many creative sizes with the line item as you need. Set the **Creative Rotation** to *Evenly weight creatives*.

For more information, see the full campaign setup instructions at [Create a Campaign](https://docs.xandr.com/bundle/monetize_monetize-standard/page/topics/create-a-campaign.html).
* Scroll back up to **Budgeting & Scheduling** and select *No daily budget* within **Pacing** (this can only be selected when managed invenotry is targeted).

## Step 5. Add the `prebid_enabled` Custom Category to Placements
## Step 6. Add the `prebid_enabled` Custom Category to Placements (Optional)

Make sure the placements you're using for Prebid are added to the following custom category: `prebid_enabled`.
If while setting up line items, you set custom category targety to `prebid_enabled`, make sure the placements you're using for Prebid are added to the custom category `prebid_enabled`.

This will make sure these placements are targeted by the line items you just set up.

It will also make it easy to turn the targeting on and off for a given placement (or placement group) by adding or removing it from the custom category. This can be very useful when troubleshooting.
It will also make it easy to turn the targeting on and off for a given placement (or placement group) by adding or removing it from the custom category. This can be useful when troubleshooting.

## Related Topics

* [Ad Ops and Prebid](/adops/before-you-start.html)
* [Ad Ops Planning Guide](/adops/adops-planning-guide.html)
* [Getting Started with Prebid.js for Developers](/dev-docs/getting-started.html)
* [Using Prebid.js with Xandr Publisher Ad Server](/dev-docs/examples/use-prebid-with-appnexus-ad-server.html) (Developer example)
* [Using Prebid.js with Microsoft Monetize Ad Server](/dev-docs/examples/use-prebid-with-appnexus-ad-server.html)(Developer example)
Loading

0 comments on commit fda12d7

Please sign in to comment.