From ed22b47205c682688767fba10d912d632985ac85 Mon Sep 17 00:00:00 2001 From: lizzieelliotms <129770338+lizzieelliotms@users.noreply.github.com> Date: Thu, 16 Nov 2023 18:49:24 +0000 Subject: [PATCH] MSFT/Xandr updates (#4964) * MSFT/Xandr updates * Remove trailing space and blank lines * added [EOF] * new line * typo, dev-docs amend and sidebar --------- Co-authored-by: bretg --- _data/sidebar.yml | 4 +- ...g-up-prebid-with-the-appnexus-ad-server.md | 100 ++++++++++-------- .../use-prebid-with-appnexus-ad-server.md | 8 +- 3 files changed, 63 insertions(+), 49 deletions(-) diff --git a/_data/sidebar.yml b/_data/sidebar.yml index d89d267be7..7ed6590992 100644 --- a/_data/sidebar.yml +++ b/_data/sidebar.yml @@ -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 @@ -1098,7 +1098,7 @@ subgroup: 2 - sbSecId: 3 - title: "AppNexus Publisher" + title: "Microsoft Monetize Publisher" link: isHeader: 0 isSectionHeader: 0 diff --git a/adops/setting-up-prebid-with-the-appnexus-ad-server.md b/adops/setting-up-prebid-with-the-appnexus-ad-server.md index f3876acfba..43aa5ca4c1 100644 --- a/adops/setting-up-prebid-with-the-appnexus-ad-server.md +++ b/adops/setting-up-prebid-with-the-appnexus-ad-server.md @@ -1,8 +1,8 @@ --- 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 @@ -10,33 +10,31 @@ 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: @@ -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 Key-Value Targeting UI. -## 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 @@ -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) 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 3b68747f7d..a5d3980f5f 100644 --- a/dev-docs/examples/use-prebid-with-appnexus-ad-server.md +++ b/dev-docs/examples/use-prebid-with-appnexus-ad-server.md @@ -1,15 +1,15 @@ --- layout: example -title: Using Prebid.js with Xandr Publisher Ad Server -description: Using Prebid.js with Xandr Publisher Ad Server +title: Using Prebid.js with Microsoft Monetize Ad Server +description: Using Prebid.js with Microsoft Monetize Ad Server sidebarType: 1 about: -- This example shows how to use Prebid.js with Xandr Publisher Ad Server. +- This example shows how to use Prebid.js with Micosoft Monetize 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 ---- +--- \ No newline at end of file