Native Integration Guide

Configure native Prebid inventory, rendering templates, and Google Ad Manager creatives in HB Manager.

Configure native inventory with ad-unit-defined creatives in Relevant Yield.

This guide uses the ad-unit-defined creative approach. It also covers the recommended Prebid Universal Creative for Google Ad Manager.

For general Native implementation guidance, see the Prebid Native documentation.

How native inventory works

Native inventory differs from banner inventory in three ways:

1. The Prebid ad unit includes a native mediaTypes object with requested OpenRTB assets.

2. The rendering template includes a macro for each requested asset.

3. A Prebid Universal Creative in Google Ad Manager populates those macros.

Relevant Yield also supports ad-server-defined creatives and custom renderers. Ad-unit-defined creatives usually provide more reliable rendering.

1. Configure native requests

Open Prebid Parameters → Native Settings at the placement, site, publisher, or placement type level.

Choose the delivery mode

Mode	Behavior
Disabled	Does not request native demand.
Enabled	Requests native and banner demand.
Native Only	Requests native demand without banner demand.

Select the OpenRTB format

Choose the OpenRTB format in Native Settings.

We recommend Legacy format with ORTB. It supports bidders using Native 1.1 and 1.2.

Set inventory metadata

Set Context and Placement type (plcmttype) to describe the inventory to bidders.

Context describes the page where the ad renders.

Placement type describes the position of the ad, such as within a feed or outside core content.

Select native assets

Select the assets you need under Native Settings.

For example, request Title, Body, Image, and Sponsor Link.

Confirm supported assets with your SSP account managers before finalizing the selection.

2. Create a native rendering template

The template receives bid assets through macros in its HTML.

For the selected assets above, use these macros:

hb_native_title
hb_native_body
hb_native_linkurl
hb_native_brand
hb_native_icon

Build the template with HTML and CSS that match your site.

3. Configure the Google Ad Manager creative

Native Prebid requires a Prebid Universal Creative.

The creative can target a 1x1 size in Google Ad Manager. Add size overrides matching your line-item sizes.

<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/native.js"></script>
<script>
    var pbNativeTagData = {};
    pbNativeTagData.pubUrl = "%%PATTERN:url%%";
    pbNativeTagData.adId = "%%PATTERN:hb_adid%%";

    pbNativeTagData.requestAllAssets = true;
    window.ucTag.renderAd(document, pbNativeTagData);
</script>

Target native line items with hb_format=native. Exclude that key-value from banner line items to prevent conflicts.

Get help

Contact your Solutions Engineer for help configuring Google Ad Manager line items.