diff --git a/adops/send-all-bids-adops.md b/adops/send-all-bids-adops.md index c43017d6a1..a15b912571 100644 --- a/adops/send-all-bids-adops.md +++ b/adops/send-all-bids-adops.md @@ -33,7 +33,7 @@ See the [Publisher API Reference]({{site.baseurl}}/dev-docs/publisher-api-refere + 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. -{% include send-all-bids-keyword-targeting.md %} +{% include send-all-bids-keyword-targeting.md %} {: .bg-info :} In this example we will use DFP setup to illustrate, but the steps are basically the same for any ad server. @@ -90,25 +90,22 @@ Next, add a creative to this $0.50 line item; we will duplicate the creative lat Choose the same advertiser we've assigned the line item to. -Note that this has to be a **Third party** creative. The **"Serve in Safeframe"** box has to be **UNCHECKED** (there are plans to make the below creative safeframe compatible). +Note that this has to be a **Third party** creative. The **"Serve into a Safeframe"** box can be **UNCHECKED** or **CHECKED** (Prebid universal creative is SafeFrame compatible). Copy this creative code snippet and paste it into the **Code snippet** box. -Edit the `hb_adid_BIDDERCODE` to replace `BIDDERCODE` with the name of the bidder that will serve into this creative, e.g., `hb_adid_rubicon`. - + {: .pb-img.pb-lg-img :} @@ -116,6 +113,49 @@ Edit the `hb_adid_BIDDERCODE` to replace `BIDDERCODE` with the name of the bidde Make sure the creative size is set to 1x1. This allows us to set up size override, which allows this creative to serve on all inventory sizes. +**Prebid universal creative code for other ad servers** + +If you're using an ad server other than DFP, your code snippet will look similar to one of the following: + +For Mopub: + + + + +For other ad servers: + + + + +Replace `MACRO` with the appropriate macro for the ad server. (Refer to your ad server's documentation or consult with a representative for specific details regarding the proper macros and how to use them.) + ## Step 4. Attach the Creative to the Line Item Next, let's attach the creative to the $0.50 line item you just created. Click into the Line Item, then the **Creatives** tab. 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 09a5ff5d86..c7116821ce 100644 --- a/adops/setting-up-prebid-with-the-appnexus-ad-server.md +++ b/adops/setting-up-prebid-with-the-appnexus-ad-server.md @@ -10,31 +10,31 @@ nav_section: tutorials ---
- + # Setting up Prebid with the AppNexus Publisher Ad Server {: .no_toc} This page describes how to set up the AppNexus Publisher Ad Server to work with Prebid.js from an Ad Ops perspective. -In some cases there are links to the [AppNexus wiki](https://wiki.appnexus.com) which may require a customer login. +In some cases there are links to the [AppNexus Console Help Center](https://console.appnexus.com/docs/home) which require a customer login. 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 AppNexus as your Ad Server]({{site.github.url}}/dev-docs/examples/use-prebid-with-appnexus-ad-server.html). {: .alert.alert-success :} **AppNexus Publisher Ad Server Features** -Note that the functionality described on this page uses some features that are only available in the AppNexus Publisher Ad Server product, such as [key-value targeting](https://wiki.appnexus.com/x/-PQdBQ). For more information, contact your AppNexus representative. +Note that the functionality described on this page uses some features that are only available in the AppNexus Publisher Ad Server product, such as [key-value targeting](https://console.appnexus.com/docs/key-value-targeting). For more information, contact your AppNexus representative. {: .alert.alert-info :} **Object Limits** Note that using Prebid with AppNexus as your ad server may cause you to -hit your AppNexus [Object Limits](https://wiki.appnexus.com/x/CwIWAg). +hit your AppNexus [Object Limits](https://console.appnexus.com/docs/viewing-your-object-limits). * TOC {:toc} ## Step 1. Add Key-Values -In the [key-value targeting](https://wiki.appnexus.com/x/-PQdBQ) 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://console.appnexus.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). If you are only sending the winning bid to the ad server, set up your keys like so: @@ -51,7 +51,7 @@ Otherwise, if you are [sending all bids to the ad server]({{site.github.url}}/de |------------------+----------------| | `hb_pb_rubicon` | `0.1` | -Depending on the price granularity you want, you may find one of the following CSV files helpful. Each file has the buckets for that granularity level predefined. You can avoid manually setting up key-value targeting by uploading the appropriate CSV file on the [key-values screen](https://wiki.appnexus.com/x/-PQdBQ): +Depending on the price granularity you want, you may find one of the following CSV files helpful. Each file has the buckets for that granularity level predefined. You can avoid manually setting up key-value targeting by uploading the appropriate CSV file on the [key-values screen](https://console.appnexus.com/docs/key-value-targeting): + [10cent-prebid-buckets.csv]({{site.github.url}}/assets/csv/10cent-prebid-buckets.csv) + [25cent-prebid-buckets.csv]({{site.github.url}}/assets/csv/25cent-prebid-buckets.csv) @@ -60,41 +60,42 @@ Depending on the price granularity you want, you may find one of the following C For more information about how to set up price bucket granularity in Prebid.js code, see the API documentation for [`pbjs.setPriceGranularity`]({{site.github.url}}/dev-docs/publisher-api-reference.html#module_pbjs.setPriceGranularity). {: .alert.alert-success :} -You can only report on price bucket values if you provide them in the Key-Value Targeting UI. +You can only report on price bucket values if you provide them in the Key-Value Targeting UI. ## Step 2. Add Creatives 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 creative setup instructions in [Add Creatives](https://wiki.appnexus.com/x/GoGzAQ) with the settings described below. - -- The creative **Type** should be **Third-party creative**. +Follow the creative setup instructions in [Add Creatives](https://console.appnexus.com/docs/add-creatives) with the following setting: -- The **Creative format** should be **Third-party tag**. +- Select **Show Template Selector**. -- The **Tag type** is HTML. +- Select a template with an HTML format. -- Make sure the **Serve in iFrame** box is not checked. +- Paste the code snippet shown below into the code box. -- The creative content should be the HTML and JavaScript shown below. - -{: .alert.alert-success :} -If you are using "send all bids" mode, the macro in the call to `renderAd` below should match the header bidding partner associated with that creative, e.g., `'#{HB_ADID_RUBICON}'`, `'#{HB_ADID_PARTNER}'`, etc. +{: .pb-img.pb-lg-img :} +![New creative]({{ site.github.url }}/assets/images/ad-ops/appnexus-setup/prebid-creative-appnexus.png) {% highlight html %} + {% endhighlight %} @@ -108,7 +109,7 @@ You'll need to create one line item for every price bucket you intend to serve. 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://wiki.appnexus.com/x/MYCzAQ), with the following settings: +For each line item, follow the line item setup instructions in [Create a Line Item](https://console.appnexus.com/docs/create-a-standard-line-item), with the following settings: - Set the **Revenue Type** to *CPM*. @@ -122,7 +123,7 @@ For each line item, follow the line item setup instructions in [Create a Line It - 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://wiki.appnexus.com/x/XAEcB). +For more information about targeting custom content categories, see [Content Category Targeting](https://console.appnexus.com/docs/content-category-targeting). ## Step 4. Set up Campaigns @@ -130,7 +131,7 @@ For each line item, create one campaign to associate with it. The campaign shou You shouldn't have to do anything else. All other settings (such as budget and targeting) are inherited from the line item. -For more information, see the full campaign setup instructions at [Create a Campaign](https://wiki.appnexus.com/x/04KUAg). +For more information, see the full campaign setup instructions at [Create a Campaign](https://console.appnexus.com/docs/create-a-campaign). ## Step 5. Add the `prebid_enabled` Custom Category to Placements diff --git a/adops/step-by-step.md b/adops/step-by-step.md index 1c05b373ce..8277a5ddbc 100644 --- a/adops/step-by-step.md +++ b/adops/step-by-step.md @@ -72,23 +72,22 @@ Next, add a creative to this $0.50 line item; we will duplicate the creative lat Choose the same advertiser we've assigned the line item to. -Note that this has to be a **Third party** creative. The **"Serve in Safeframe"** box has to be **UNCHECKED** (there are plans to make the below creative safeframe compatible). +Note that this has to be a **Third party** creative. The **"Serve into a Safeframe"** box can be **UNCHECKED** or **CHECKED** (Prebid universal creatve is SafeFrame compatible). Copy this creative code snippet and paste it into the **Code snippet** box. + {: .pb-img.pb-lg-img :} @@ -100,7 +99,7 @@ Make sure the creative size is set to 1x1. This allows us to set up size overri Next, let's attach the creative to the $0.50 line item you just created. Click into the Line Item, then the **Creatives** tab. -There will be yellow box showing each ad spot that you haven't uploaded creatives for yet. Since you've already made the creatives, click the **use existing creatives** next to each size. +There will be yellow box showing each ad spot that you haven't uploaded creatives for yet. Since you've already made the creatives, click **use existing creatives** next to each size. ![Use existing creatives list]({{ site.github.url }}/assets/images/demo-setup/use-existing-creatives-01.png) diff --git a/assets/images/ad-ops/appnexus-setup/prebid-creative-appnexus.png b/assets/images/ad-ops/appnexus-setup/prebid-creative-appnexus.png new file mode 100644 index 0000000000..b459ab8c97 Binary files /dev/null and b/assets/images/ad-ops/appnexus-setup/prebid-creative-appnexus.png differ diff --git a/dev-docs/show-prebid-ads-on-amp-pages.md b/dev-docs/show-prebid-ads-on-amp-pages.md index a7c1e850dc..037d1c7124 100644 --- a/dev-docs/show-prebid-ads-on-amp-pages.md +++ b/dev-docs/show-prebid-ads-on-amp-pages.md @@ -149,18 +149,37 @@ For Mopub: {% highlight javascript %} - + + +{% endhighlight %} + +For all other ad servers: + +{% highlight javascript %} + + + +