Product Bulletin

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.

Podcast

Tune into the November Product Bulletin podcast for the latest on Native & Search API features, changes and product enhancements released this month by the product development team.

November, 2018

New API Endpoints Documentation

Updated Native Feed Ads (NFA) Dot Tag Setup Guide

  • We’ve now added Tealium Tag Manager to our suite of Dot Setup Guides for Native Feed Ads, or NFA. This means that if you already have an account with Tealium Tag Manager and are familiar their UI, you may want to take advantage of this tag manager to set up your Native & Search Dot tags for NFA. The setup steps are described in the new Tealium Tag Manager Guide for Native & Search NFA Dot tags. For more details and to review the other supported 3rd party tag manager vendors, including Google, Signal, Adobe, and Sizmek, see the section on using third party tag managers in the NFA Dot Tag Instrumentation section of the API Guide. Each guide describes the steps required to set up and deploy Dot tags.

Reminder: Zip Code Targeting Available via API for Native Campaigns

  • As a reminder, the API now supports zip code targeting for Native campaigns. For available attributes, see the WOEID section of the Targeting Attributes documentation. Also see the Data Dictionary for details and valid values on how to look up WOEIDs by location name as well as by Zip code.

Reminder: Use Conversion Counting To Control & Optimize Your Campaigns

  • We recently introduced a new campaign-level setting that allows you to control how you want a conversion to be counted for your campaigns. The feature is supported in the API, Bulk and UI, along with a new reporting column specifying the conversion model used. For more details on setup and available options, see Dimensions, Cubes, Campaigns API Fields, and Bulk Campaigns Fields in the UI. For an overview of how it works in the UI, see the Advertiser Guide.

Reminder: Dynamic Product Ads (DPA) Now Known as Native Feed Ads (NFA)

  • Native Feed Ads (previously known as Dynamic Product Ads, or DPA) enable you to target customers with ads for specific products that those customers have already viewed. Your ads then appear on customers’ desktop, tablet or smartphone devices. With this update, please note that the endpoints and documentation URLs in the API and Advertiser Guides remain the same. For details on topics which describe how to work with NFAs, see Native Feed Ads API documentation and the Advertiser Guide.

  • Also, a reminder that we’ve added new macros supported for Native Feed Ads.

Reminder: Account Change History API

  • The account history API provides advertisers with change history data for an account within the last three months. You can view information on the objects changed and the old and new values associated with those changes. The API lets you view and monitor a wide range of changes – for example, when a campaign was paused, who changed budgets, specfics of bid changes, and so on. For more details on the endpoint, fields and example representations, see Account Change History.

Reminder: Oath: Ad Glossary

  • The New Oath: Ad Glossary now is 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 API Guide.

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: Glossary of Native & Search Terms

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

Important

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.