Merge branch 'prebid:master' into master

Author: quietPusher

ADS - Acceso directo.lnk

@@ -531,6 +531,14 @@
   sectionTitle:
   subgroup: 5
 
+- sbSecId: 1
+  title: Loading modules separately
+  link: /dev-docs/modules/index.html#loading-modules-separately
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 5
+
 - sbSecId: 1
   title: External Interfaces
   link:

_data/sidebar.yml

@@ -1,6 +1,6 @@
 <script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script>
 <script type="text/javascript"> docsearch({
-  apiKey: '6f0eda209a805cfa66b415043ab5fbfc',
+  apiKey: '7777b1f98e980527606d00e705ff3d6f',
   appId: 'FN26QH8JE9',
   indexName: 'prebid',
   container: '.pb-header .c-search',

_includes/body-end.html

@@ -20,7 +20,7 @@ <h1><a target="_blank" href="hb_native_linkurl" class="pb-click">hb_native_title
 		      <div class="attribution">hb_native_brand</div>
 		    </div>
 		  </div>
-		  <script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/native-trk.js"></script>
+		  <script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist/native-trk.js"></script>
 		  <script>
 		    var pbNativeTagData = {};
 		    pbNativeTagData.uuid = "%%PATTERN:hb_cache_id%%";

_includes/mobile/gam-native-adops.html

@@ -116,6 +116,8 @@ If your ad server supports targeting creatives within the line item, it could co
 
 You’ve now added all fields required for targeting Prebid line items. You can add any other line item options you would normally use, such as additional targeting for geography. When you’ve filled in all the appropriate fields, save your line item.
 
+<a id="create-creatives" ></a>
+
 ## Create Your Creatives
 
 The process of creating your creatives will differ based on the type of creative.
@@ -131,7 +133,7 @@ We recommend using the [Prebid Universal Creative](/overview/prebid-universal-cr
 If you’re working with banner or in-renderer creatives, the HTML you’ll enter in the creatives will be similar to the following (utilizing whatever macro format is supported by your ad server):
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/%%PATTERN:hb_format%%.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist/%%PATTERN:hb_format%%.js"></script>
 <script>
   var ucTagData = {};
   ucTagData.adServerDomain = "";
@@ -157,6 +159,7 @@ If you’re working with banner or in-renderer creatives, the HTML you’ll ente
 * Replace `%%MACRO%%` with the appropriate macro for your 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.)
 * Replace BIDDERCODE with the appropriate code for the bidder your line item is targeting. For example, if you’re targeting BidderA, the macro variable for adId might look like `ucTagData.adId = "%%PATTERN:hb_adid_BidderA%%";`.
 * If you're hosting your own Prebid Universal Creative, make sure it's version 1.15 or later, or replace `%%PATTERN:hb_format%%.js` with `creative.js`.
+* The `hb_ver` targeting key, used above to construct the Prebid Universal Creative CDN URL, requires Prebid.js 10.11.0 or later. If that's not available, substitute `%%PATTERN:hb_ver%%` with a particular PUC version.   
 
 The example above uses the jsdelvr CDN as the domain from which the creative will serve. However, you may obtain the creative from a managed service or host it yourself. You might need to edit the creative and make adjustments to your creative settings depending on the CDN you're using.
 

adops/adops-general-sbs.md

@@ -66,8 +66,8 @@ the actual PUC.
 
 If you choose to use the Prebid Universal Creative, you'll need to decide where to load it from:
 
-1. Prebid hosts an always-up-to-date copy of the PUC code at `https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/*`. The upside of this location is that it's automatically updated so it contains new features automatically. The potential downside is that Prebid controls when it's upgrades.
-1. You can host the PUC at your own location. The upside of this option is that you can control when upgrades happen.
+1. Prebid hosts each PUC version at `https://cdn.jsdelivr.net/npm/prebid-universal-creative@${VERSION}/dist/*` - substitute `${VERSION}` with a version number. Using Prebid.js 10.11.0 or later, you may also use the `hb_ver` targeting key; see [create your creatives](/adops/adops-general-sbs.html#create-your-creatives).
+1. You can host the PUC at your own location. The upside of this option is more control over when upgrades happen.
 1. You can copy the body of the PUC into your ad server creative directly. This eliminates a browser fetch, but could make upgrades more difficult.
 
 ### Prebid.js 'dynamic creatives'
@@ -115,7 +115,7 @@ VAST URL required. See the [GAM Prebid Mobile Rendering Ad Ops](/adops/mobile-re
 {: .table .table-bordered }
 | :memo: Use Cases          |
 |:---------------------------|
-| - Prbeid.js Native |
+| - Prebid.js Native |
 
 Native ads require close collaboration between web designers, engineering, and ad ops. The primary decision to be made that affects ad ops is where to store the rendering template. The options are:
 

adops/creative-considerations.md

@@ -56,13 +56,18 @@ These instructions assume you're using the Prebid Universal Creative (PUC) after
 {: .alert.alert-warning :}
 Be sure to replace BIDDERCODE with the appropriate bidder. For example, if the bidder code is `PBbidder`, the `adid` would be `%%PATTERN:hb_adid_PBbidder%%`.
 
-Also, replace "PUCFILE" with:
+Replace "PUCFILE" with:
 
 - Prebid.js: "%%PATTERN:hb_format%%.js"
 - Prebid Mobile: "creative.js"
 
+Replace "VERSION" with:
+
+- Prebid.js 10.11.0 or later: "%%PATTERN:hb_ver%%"
+- Otherwise, a specific PUC version.
+
 ```html
-<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/PUCFILE"></script>
+<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@VERSION/dist/PUCFILE"></script>
 <script>
   var ucTagData = {};
   ucTagData.adServerDomain = "";
@@ -99,13 +104,18 @@ Warning: Be sure none of the attribute names are longer than 20 characters. See
 
 In top-price mode, you can make use of the GAM `TARGETINGMAP` feature instead of listing out each attribute.
 
-Be sure to replace "PUCFILE" with:
+Replace "PUCFILE" with:
 
 - Prebid.js: "%%PATTERN:hb_format%%.js"
 - Prebid Mobile: "creative.js"
 
+Replace "VERSION" with:
+
+- Prebid.js 10.11.0 or later: "%%PATTERN:hb_ver%%"
+- Otherwise, a specific PUC version.
+
 ```html
-<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/PUCFILE"></script>
+<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@VERSION/dist/PUCFILE"></script>
 <script>
   var ucTagData = {};
   ucTagData.adServerDomain = "";

adops/gam-creative-banner-sbs.md

@@ -104,7 +104,7 @@ Example creative HTML:
     <div class="attribution">##hb_native_brand##</div>
   </div>
 </div>
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/%%PATTERN:hb_format%%.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist/%%PATTERN:hb_format%%.js"></script>
 <script>
     var pbNativeTagData = {};
     pbNativeTagData.pubUrl = "%%PATTERN:url%%";

adops/gam-native.md

@@ -80,7 +80,7 @@ Follow the banner creative setup instructions in [Add Creatives](https://docs.xa
 * Self-Audit the creative and confirm compliance.
 
 ```html
-<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/#{HB_FORMAT}.js"></script>
+<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@#{HB_VER}/dist/#{HB_FORMAT}.js"></script>
 <script>
   var ucTagData = {};
   ucTagData.adServerDomain = window.location.host;

adops/setting-up-prebid-with-the-appnexus-ad-server.md

@@ -86,6 +86,8 @@
         $('#download-button').html('<i class="glyphicon glyphicon-send"></i> Sending Request...').addClass('disabled');
 
         var form_data = get_form_data();
+        const removedModules = form_data.removedModules;
+        delete form_data.removedModules;
         $.ajax({
             type: "POST",
             url: "https://js-download.prebid.org/download",
@@ -112,12 +114,12 @@
             triggerDownload(jsBlob, filename);
             triggerDownload(new Blob([configData], { type: "application/json" }), "prebid-config.json");
 
-            if (form_data["removedModules"].length > 0) {
+            if (removedModules.length > 0) {
                 alert(
                     "The following modules were removed from your download because they aren't present in Prebid.js version " +
                     form_data["version"] +
                     ": " +
-                    JSON.stringify(form_data["removedModules"])
+                    JSON.stringify(removedModules)
                 );
             }
         })
@@ -179,7 +181,7 @@
             });
 
         return {
-            modules: renameModules(version, modules),
+            modules: renameModules(version, modules).filter(mod => !removedModules.includes(mod)),
             version,
             removedModules,
         };