GAM Creative Setup

This page explains the creative template used by Nexx360 line items in Google Ad Manager to render winning bids from n360ortb.

Overview

When a Nexx360 line item wins in the GAM auction, it renders a creative that:

1. Loads the n360ortb display library

2. Uses GAM macros to identify the winning bid

3. Renders the ad from Nexx360's servers

Creative Template

The following creative template is used by Nexx360 line items:

<script src="https://lib.nexx360.io/nexx360display/api.js"></script>
<script>
  var ucTagData = {
    bidId: '%%PATTERN:n360_bid%%',
    size: '%%PATTERN:n360_sz%%',
    pubUrl: '%%SITE%%'
  };
  n360ortbDisplay.renderAd(document, ucTagData);
</script>

How It Works

1. n360ortbDisplay Library

<script src="https://lib.nexx360.io/nexx360display/api.js"></script>

This lightweight library provides the renderAd() function that fetches and renders the ad creative.

2. GAM Macros

The template uses GAM macros to pass bid information:

Macro	Description
%%PATTERN:n360_bid%%	The unique bid identifier set by setDisplayBids()
%%PATTERN:n360_sz%%	The ad size (e.g., "300x250")
%%SITE%%	The page URL where the ad is served

3. renderAd() Function

n360ortbDisplay.renderAd(document, ucTagData);

This function:

• Fetches the ad creative using the bid ID

• Renders the ad into the current document (iframe)

• Handles impression and click tracking

Creative Setup in GAM

When you connect your GAM account, Nexx360 automatically creates the line items and creatives. You typically don't need to set these up manually.

If you need to verify or manually create the creative:

1. Go to Delivery > Creatives in GAM

2. Find or create a third-party creative

3. Set the creative type to Third party

4. Paste the creative template code

5. Set appropriate sizes (or use a 1x1 fluid creative)

Debug Mode

To troubleshoot creative rendering issues, you can enable debug mode by adding a query parameter to your page:

https://yoursite.com/page?n360debug=true

With debug mode enabled:

• Console logs show bid and render information

• Network requests to Nexx360 servers are visible

• Error messages are more descriptive

Troubleshooting

Ad not rendering

1. Check targeting: Verify the n360ortb targeting keys are being set

   • Use browser dev tools to inspect GPT targeting

   • Look for n360_bid, n360_pb, n360_sz keys

2. Check line item delivery: In GAM, verify the line item is:

   • Active and within flight dates

   • Not limited by frequency caps

   • Properly targeted

3. Check creative approval: Ensure creatives are approved in GAM

Blank creative

If the creative space appears but shows blank:

1. Check browser console for JavaScript errors

2. Verify the n360ortbDisplay library loaded successfully

3. Confirm the bid ID macro is populated (not empty)

Wrong size rendered

If the ad renders at an incorrect size:

1. Verify sizes match between GPT slot and n360ortb configuration

2. Check that the n360_sz targeting key contains the correct size

3. Ensure the creative in GAM supports the expected sizes

Advanced: Custom Creative

For advanced use cases, you can customize the creative template:

<script src="https://lib.nexx360.io/nexx360display/api.js"></script>
<script>
  var ucTagData = {
    bidId: '%%PATTERN:n360_bid%%',
    size: '%%PATTERN:n360_sz%%',
    pubUrl: '%%SITE%%'
  };

  // Optional: Add callback for render completion
  n360ortbDisplay.renderAd(document, ucTagData, function(success) {
    if (success) {
      console.log('Ad rendered successfully');
    } else {
      console.log('Ad render failed');
      // Show fallback content
    }
  });
</script>

Next Steps

• GAM Integration Example - Complete integration code

• Connect your GAM Account - Initial setup

• API Reference - Full API documentation