Direct-Sold Ads

Publishers can serve video ads (click to play or sound off), animated ads (provided animation says within the iframe) and banner ads that have been sold directly by their own sales team into their Instant Articles. For more details on ad formats, see the Instant Articles policies. Publishers keep 100% of the revenue generated by ads they sell themselves.

To display ads in Instant Articles, use the Ad element to designate the position for the ad within your article. The ad will be served from your designated URL and will be rendered inside the article with the “Sponsored” heading, indicating to the reader that the content is an advertisement.

Sizing

Facebook will dynamically size each ad to be responsive to different screen dimensions and add buffer space around the ad consistent with your article style.

The heights of your ads in relation to their widths cannot exceed a 2:3 ratio in Instant Articles. Any ads that exceed the 2:3 aspect ratio will be automatically cropped from the bottom.

For the best reader experience, we recommend that you specify the dimensions of the iframe to match the dimensions of the ad asset within. This will prevent text and other elements from shifting around on the page as the ad loads.

  • If you do not define the height and width for an ad, the ad will be automatically sized to fit the display screen based on the response from the ad server.

  • If a specific size is defined but the ad server returns a different size, the ad will be automatically sized.

<figure class="op-ad">
    <!-- Use this for your ads -->
    <iframe src="https://www.adserver.com/ss;adtype=banner300x250" height="300" width="250"></iframe>
</figure>

For more information on how to specify ad sizes, see the Ad entry in Instant Articles Code Samples.

Serving

Ads can be served into your Instant Articles through your existing ad server implementation, including through Google’s DFP solution.

To implement Google's DFP in Instant Articles, all code must be contained within a single <iframe> wrapped in a <figure class="op-ad"> element. This element should be placed in <head> for automatic ad placement or <body> for manual placement. See the Ad Placement section for more.

Google Publisher Tags (GPT) example:

<figure class="op-ad">
  <iframe height=“250 " style="border:0;margin:0;padding:0; " width="300”>
  <script async='async' src='https://www.googletagservices.com/tag/js/gpt.js'></script>
  <script>
      var googletag = googletag || {};
      googletag.cmd = googletag.cmd || [];
  </script>

  <script>
    googletag.cmd.push(function() {
      googletag.defineSlot('/[NETWORK_ID]/[AD_UNIT]', [300, 250], 'div-gpt-ad-12345').addService(googletag.pubads());
      googletag.enableServices();
    });
  </script>
  <div id='div-gpt-ad-12345' style='height:250px; width:300px;'>
    <script>
      googletag.cmd.push(function() { googletag.display('div-gpt-ad-12345'); });
    </script>
  </div>
  </iframe>
</figure>

Measurement

Since your ads are served into Instant Articles within an iframe and embedded web browser, you can employ your own existing techniques to measure and account for the viewability of these ads back to your advertisers. You may use JavaScript to track and measure ad viewability for these ads in your Instant Articles.

Targeting

For ads sold directly by your team, you will not have access to Facebook targeting within Instant Articles. You may still use your standard cookie or contextual data for targeting as you do for ads on your website.

Events

To help track behavior around direct sold ads, Instant Articles exposes several user interactions as JavaScript messages. For more information, see the Ad Events entry in Instant Articles Code Samples.