Welcome to the Native & Search API Product Bulletin. This update includes a quick snapshot of recent and upcoming releases and is focused on features supported by the API. A summary of supported functionality is also included.
Product Bulletins are updated on a monthly cadence for Native & Search API partners, account managers and developers.
Tune into the September Product Bulletin podcast for the latest on Native & Search API features, changes and product enhancements released this month by the product development team.
Gemini Rebranding - Introducing the Native & Search API¶
Gemini has now been rebranded as Oath Ad Platforms Native & Search API. It is important to note that the endpoints in the API do not change with the rebranding. The new product brand represents Oath’s full suite of technology solutions for advertisers, agencies and publishers, and replaces BrightRoll, Gemini, ONE by AOL, and Yahoo for Publishers. For more details, see Introducing the Native & Search API and the overview in the Advertiser Guide.
Site Blocking For Brand Safety & Improved Performance¶
We’ve introduced the capability to block sites in supply targeting, available in the API, Bulk and UI. Note that Site block targeting is available for Native campaigns, and can only be set at the campaign level. Also note that bid modifiers are not allowed for site block targeting. Blocking sites is useful for ensuring the safety of your brand as well as improving the performance of your Native campaigns. For more details on how it works, see v3 Site Block Targeting for the endpoint and example representation, plus details on the new domain performance stats cube. Also see Bulk fields documentation and an overview of how it works in the Advertiser Guide.
New: Interest Segments Available in API and Bulk¶
We’ve introduced support for new Interest Segments (Oath Audience Segments), available in API and Bulk. Targeting is available for Native campaigns, and can be set at both the campaign and ad group levels. See the API Guide for more details on Interest Segments and the Available Attributes. For details on Bulk Fields and Object Types and how to create and manage them, see Segment Interests in Bulk documentation.
Oath Ad Platforms Glossary¶
The New Oath: Ad Glossary is now available for download and installation. This is a unified Oath Ad Platforms glossary built and implemented as an addition to the Apple Dictionary.app that resides in every user’s Applications folder on Mac OS X. As a glossary, it includes a broad set of searchable terms, illustrations, videos and embedded hyperlinks that are unique to the Native & Search API, UI and to the Oath Ad Platforms DSP. See details and a link to download and install in the Oath Ad Glossary.
Reminder: Updates to Error Codes in API¶
For reference, we’ve recently added new API error codes, including REQUEST_CONFLICT, HUGE_REQUEST, REQUEST_URI_TOO_LONG, and UNSUPPORTED_MEDIA_TYPE. Review the updated documentation for more details and error FAQs.
Reminder: How to Cancel API Job Processing¶
We’ve added the ability to cancel a job that is processing via the Native & Search API. To do this, make a PUT call in Bulk via the API while it is processing by adding cancel in the body of your request. For more details and an example response, see the brief technical note in Bulk Operations documentation.
Reminder: Dot DPA Setup Guides for Partners Using 3rd Party Tag Managers¶
Dot Setup guides are available for partners using 3rd Party Tag Managers for DPA Dot tags. The guides describe the steps required to set up and deploy Dot tags, if you work with Google, Signal or Sizmek for tag management. You can find links to these guides on the main Dynamic Product Ads page. Also see the Dot Tag Setup section of the Advertiser Guide to access these guides.
Reminder: Updated Postman to v3 Endpoint¶
Updated the Postman collection to the v3 endpoint for all API calls. Using Postman, you can test and verify the calls you make in the Native & Search API. See Postman API Toolkit.
Reminder: Guide: How To Utilize Dot Pixel & Conversion Rules¶
Step-by-step guide available on how to effectively utilize dot pixel and conversion rules, based on your particular needs and setup, i.e., whether your advertiser account contains either a single website or multiple websites. The API workflow described in this document involves, essentially, no more than five basic steps to set up your Dot Pixel tags and Conversion Rules.
Reminder: Bulk Downloads Performance¶
If you have a large account and notice your bulk downloads are taking longer over time, please consider deleting dormant or orphaned objects (Campaigns, Keywords, Ads, Ad Groups). See the Native & Search Guide for more details on Bulk operations.
Required Fields by Ad Type Matrix¶
A matrix is available which details the required fields when serving different ad types. For more information, see the Matrix view of required fields.