diff --git a/_data/sidebar.yml b/_data/sidebar.yml index d8e532f729..88273058f9 100644 --- a/_data/sidebar.yml +++ b/_data/sidebar.yml @@ -460,7 +460,7 @@ - sbSecId: 1 title: Native Ads - link: /dev-docs/show-native-ads.html + link: /prebid/native-implementation.html isHeader: 0 isSectionHeader: 0 sectionTitle: @@ -959,7 +959,7 @@ subgroup: 0 - sbSecId: 3 - title: 'Guide to Ad Manager' + title: 'Guide to Prebid in Ad Manager' link: /adops/step-by-step.html isHeader: 0 isSectionHeader: 0 @@ -967,7 +967,7 @@ subgroup: 0 - sbSecId: 3 - title: 'Setting up for AMP' + title: 'Setting up for AMP in GAM' link: /adops/setting-up-prebid-for-amp-in-dfp.html isHeader: 0 isSectionHeader: 0 @@ -975,7 +975,7 @@ subgroup: 0 - sbSecId: 3 - title: 'Setting up Multi-Format' + title: 'Setting up Multi-Format in GAM' link: /adops/setting-up-prebid-multi-format-in-dfp.html isHeader: 0 isSectionHeader: 0 @@ -983,15 +983,15 @@ subgroup: 0 - sbSecId: 3 - title: 'Setting up Native (Alpha)' - link: /adops/setting-up-prebid-native-in-dfp.html + title: 'Setting up Native in GAM' + link: /adops/gam-native.html isHeader: 0 isSectionHeader: 0 sectionTitle: subgroup: 0 - sbSecId: 3 - title: 'Setting up Video' + title: 'Setting up Video in GAM' link: /adops/setting-up-prebid-video-in-dfp.html isHeader: 0 isSectionHeader: 0 @@ -999,7 +999,7 @@ subgroup: 0 - sbSecId: 3 - title: 'Setting up Long-Form Video' + title: 'Setting up Long-Form Video in GAM' link: /adops/setting-up-prebid-ott-video-in-gam.html isHeader: 0 isSectionHeader: 0 diff --git a/_includes/dev-docs/native-assets.md b/_includes/dev-docs/native-assets.md new file mode 100644 index 0000000000..912b0e62ee --- /dev/null +++ b/_includes/dev-docs/native-assets.md @@ -0,0 +1,21 @@ +{: .table .table-bordered .table-striped } +| Asset Code | Description | Macro | +|---------------+--------------------------------------------------------------------------------------|-----------------------| +| `title` | The title of the ad, usually a call to action or a brand name. | `##hb_native_title##` | +| `body` | Text of the ad copy. | `##hb_native_body##` | +| `body2` | Additional Text of the ad copy. | `##hb_native_body2##` | +| `sponsoredBy` | The name of the brand associated with the ad. | `##hb_native_brand##` | +| `icon` | The brand icon that will appear with the ad. | `##hb_native_icon##` | +| `image` | A picture that is associated with the brand, or grabs the user's attention. | `##hb_native_image##` | +| `clickUrl` | Where the user will end up if they click the ad. | `##hb_native_linkurl##` | +| `displayUrl` | Text that can be displayed instead of the raw click URL. e.g, "Example.com/Specials" | `##hb_native_displayUrl##`| +| `privacyLink` | Link to the Privacy Policy of the Buyer, e.g. http://example.com/privacy | `##hb_native_privacy##` | +| `privacyIcon` | Icon to display for the privacy link, e.g. http://example.com/privacy_icon.png | `##hb_native_privicon##` | +| `cta` | *Call to Action* text, e.g., "Click here for more information". | `##hb_native_cta##` | +| `rating` | Rating information, e.g., "4" out of 5. | `##hb_native_rating##` | +| `downloads` | The total downloads of the advertised application/product | `##hb_native_downloads##` | +| `likes` | The total number of individuals who like the advertised application/product | `##hb_native_likes##` | +| `price` | The non-sale price of the advertised application/product | `##hb_native_price##` | +| `salePrice` | The sale price of the advertised application/product | `##hb_native_saleprice##` | +| `address` | Address of the Buyer/Store. e.g, "123 Main Street, Anywhere USA" | `##hb_native_address##` | +| `phone` | Phone Number of the Buyer/Store. e.g, "(123) 456-7890" | `##hb_native_phone##` | diff --git a/_includes/dev-docs/native-image-asset-sizes.md b/_includes/dev-docs/native-image-asset-sizes.md index 9c8ad557af..269818b3ef 100644 --- a/_includes/dev-docs/native-image-asset-sizes.md +++ b/_includes/dev-docs/native-image-asset-sizes.md @@ -34,6 +34,3 @@ mediaTypes: { } {% endhighlight %} - -{: .alert.alert-success :} -NOTE: If you're using `aspect_ratios` in a native request sent to Prebid Server, the `min_width` and `min_height` fields become required instead of optional. If these fields are not included, that native request will be rejected. \ No newline at end of file diff --git a/adops/before-you-start.md b/adops/before-you-start.md index 6388405a29..cfd599506d 100644 --- a/adops/before-you-start.md +++ b/adops/before-you-start.md @@ -14,7 +14,7 @@ sbUUID: 3.2 Prebid products are designed to integrate with the ad ops line item configuration on the publisher's selected ad server. Whether using Prebid.js, Prebid Server or Prebid Mobile, bid targeting parameters are passed to the ad server. The ad server then attempts to match the targeting parameters to a preset line item. If successful, that line item is compared to other line items and if the Prebid bid wins the auction, the creative is returned to the web page or app for display. {% capture importantNote %} -This page assumes you have read [Getting Started with Prebid.js]({{site.baseurl}}/overview/getting-started.html), though it applies to Prebid SDK and Server as well. +This page assumes you have read [Getting Started with Prebid.js](/overview/getting-started.html), though it applies to Prebid SDK and Server as well. {% endcapture %} {% include alerts/alert_important.html content=importantNote %} @@ -29,14 +29,14 @@ The table below lists ad servers supported by Prebid and provides links to step {: .table .table-bordered .table-striped } | Server | Page | |--------------+-----------------------------------------------------------------------------------------------------------------------------------------| -| **Google Ad Manager** | [Step by step guide to Google Ad Manager setup]({{site.baseurl}}/adops/step-by-step.html) | -| | [Send all bids to the ad server]({{site.baseurl}}/adops/send-all-bids-adops.html) | -| | [Setting up Prebid for AMP in Google Ad Manager]({{site.baseurl}}/adops/setting-up-prebid-for-amp-in-dfp.html) | -| | [Setting up Prebid Video in Google Ad Manager]({{site.baseurl}}/adops/setting-up-prebid-video-in-dfp.html) | -| | [Setting up Prebid Native in Google Ad Manager]({{site.baseurl}}/adops/setting-up-prebid-native-in-dfp.html) | -| **AppNexus** | [Setting up Prebid with the AppNexus Publisher Ad Server]({{site.baseurl}}/adops/setting-up-prebid-with-the-appnexus-ad-server.html) | -| **Smart Ad Server** | [Setting up Prebid.js with Smart Ad Server]({{site.baseurl}}/adops/setting-up-prebidjs-with-Smart-Ad-Server.html) | -| **FreeWheel** | [FreeWheel Guide for Premium Long-Form Video]({{site.baseurl}}/adops/setting-up-prebid-video-in-freewheel.html) | +| **Google Ad Manager** | [Step by step guide to Google Ad Manager setup](/adops/step-by-step.html) | +| | [Send all bids to the ad server](/adops/send-all-bids-adops.html) | +| | [Setting up Prebid for AMP in Google Ad Manager](/adops/setting-up-prebid-for-amp-in-dfp.html) | +| | [Setting up Prebid Video in Google Ad Manager](/adops/setting-up-prebid-video-in-dfp.html) | +| | [Setting up Prebid Native in Google Ad Manager](/adops/gam-native.html) | +| **AppNexus** | [Setting up Prebid with the AppNexus Publisher Ad Server](/adops/setting-up-prebid-with-the-appnexus-ad-server.html) | +| **Smart Ad Server** | [Setting up Prebid.js with Smart Ad Server](/adops/setting-up-prebidjs-with-Smart-Ad-Server.html) | +| **FreeWheel** | [FreeWheel Guide for Premium Long-Form Video](/adops/setting-up-prebid-video-in-freewheel.html) | ## Decide on price bucket granularity @@ -125,6 +125,6 @@ Implementing header bidding requires much more collaboration with your dev team ## Related Topics -- [Getting Started with Prebid.js]({{site.baseurl}}/overview/getting-started.html): How Prebid.js works at a high level. -- [What is Prebid?]({{site.baseurl}}/overview/intro.html): Overview and history of header bidding and Prebid.js. -+ [Docs by Format]({{site.baseurl}}/dev-docs/docs-by-format.html): Engineering and ad ops docs arranged by ad format (video, native, etc.). +- [Getting Started with Prebid.js](/overview/getting-started.html): How Prebid.js works at a high level. +- [What is Prebid?](/overview/intro.html): Overview and history of header bidding and Prebid.js. ++ [Docs by Format](/dev-docs/docs-by-format.html): Engineering and ad ops docs arranged by ad format (video, native, etc.). diff --git a/adops/gam-native.md b/adops/gam-native.md new file mode 100644 index 0000000000..dbd2beb1b5 --- /dev/null +++ b/adops/gam-native.md @@ -0,0 +1,221 @@ +--- +layout: page_v2 +title: Setting up Prebid Native in Google Ad Manager +head_title: Setting up Prebid Native in Google Ad Manager +description: Setting up Prebid Native in Google Ad Manager +sidebarType: 3 +--- + +# Setting up Prebid Native in Google Ad Manager +{: .no_toc} + +This page describes how to set up native creatives in Google Ad Manager for use with Prebid.js. + +For more information about Google Ad Manager native ad setup, see the [Google Ad Manager native ads documentation](https://support.google.com/admanager/answer/6366845). + +{% capture version2 %} +This document replaces the [original documentation](/adops/setting-up-prebid-native-in-dfp.html) that described how to set up Prebid.js native for GAM. That documentation is still valid, but the approach described here is better in every way, so we recommend that all new and revised implementations follow this approach. Here are the key differences between the original approach and the preferred approach described in this document: +{::nomarkdown} +