Third-party ad tag technical specs
Third-party ad tags should only be used for creative rendering on Apple News. Any uses beyond the display of advertising, such as the the creation and/or operation of an ad network is strictly prohibited and is subject to review by Apple and may be removed at its sole discretion.
Standard, double, large, MREC, IAB 300x250, IAB 320x50, IAB 320x320, IAB 300x600, IAB 728x90, IAB 970x250, and interstitial ads can utilize third-party tags which can be served on:
iOS 10.3 and later
macOS 10.14 and later
Pre-roll video and outstream video ads can use their third-party VAST tags which can be served on iOS 12.0 and later.
Google Campaign Manager supports banner ads listed above, but doesn’t support interstitial ads, and requires iOS 12.0 and later. See Google Campaign Manager technical specs.
Third-party served ads should adapt to changes in point size for portrait and landscape orientations. With the exception of MREC, all Apple ad formats require one ad tag for portrait and landscape orientations on each device.
Each interstitial ad should be coded as a banner rather than a typical MRAID interstitial. Apple News Ad SDK will always return inline when MRAID.getPlacementType method is called. Apple News interstitial ads don’t have a standard close button to exit out of the ad experience. Users can exit out of the interstitial ad on Apple News by swiping left or right to the next article.
In order to prevent non-user initiated navigation, all tap methods should be associated with a tap in a timely manner. Delays in tap method calls may cause the ad destination to be blocked. Therefore, all tap action methods including MRAID.open(), MRAID.expand(), and MRAID createCalendarEvent() should be called upon immediately on tap.
Note that fourth-party tracking tags are not supported.
Apple News Advertising SDK implements a subset of MRAID 1.0 as a standard MRAID that can be called by the ad. All tags must be MRAID compliant. Supported methods and events below.
Note that custom close buttons aren’t supported. Apple will supply a standard close button displayed in the upper-right corner of the expanded ad experience.
Ads requested by Apple News will be routed through an Apple-hosted proxy server for privacy purposes. This means that all ads served on Apple News will come from Apple IP addresses, therefore we need to make sure that the traffic isn’t identified as bots/DDOS by your servers. The ideal way for this to be solved would be for you to allowlist all IP addresses beginning with 17 (for example, 17.*.*.*), which are all owned by Apple.
Additional development details
Ads are loaded in a fairly standard web view (WKWebView). But there are important details that should be taken in to consideration when using third-party ad tags for ads on Apple News.
The following Google Campaign Manager tag types are supported:
All paths to resources that the ads load must be absolute (complete) URLs, not relative paths.
Note that Google Campaign Manager can support both absolute and relative paths.
Use of iFrames isn’t supported. When ads are loaded in Apple News, they can’t create or use iFrames at any time; the ad will fail loading. The MRAID object is only accessible via the document’s mainframe.
Note that Google Campaign Manager can support the use of iFrames.
SSL serving is required. All ads must be SSL compliant.
Taps are supported using MRAID.open method or anchor tags <ahref>. Use of Window.open will cause the clicks to fail.
A maximum of 100 requests per impression is allowed. This includes all pixels, JS, image, etc. Any requests beyond the allowed limit will be ignored.
Supported in-banner features
HTML5 JS/CSS Animation
Tap: Activates a control or selects an item
Flick: Scrolls or pans quickly
Drag: Move an element from side to side or drag an element across the display banner’s interaction space
To optimize user experience and ensure security and privacy, the following device features are blocked by Apple News Ad SDK.
Tap to SMS/Call/Email
Supported vendors (display)
Google Campaign Manager
Third-party ad tag (display) checklist
Absolute URLs only
Note that Google Campaign Manager tags can support absolute or relative paths.
URLs must use HTTPS protocol
Apple IPs (17.*) Allow Listed or not blocked
Note that Google Campaign Manager tags can support the use of iFrames.
All clicks using MRAID.open() or <ahref>
Note that use of Window.open will cause the clicks to fail.
No fourth-party tracking
< 100 requests per impression
All ads are to spec in portrait and landscape mode
No custom close
Two-part expand only
Expandable ads (No custom close, Two-part expand only)