Product Bulletin

Welcome to the Yahoo Gemini 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 Gemini API partners, account managers and developers.

April, 2016

New Gemini Advertiser Guide Portal

  • The new Gemini Advertiser Guide portal has been introduced, replacing the existing Gemini Help Center. We’ve reworked/rewritten the entire content of the Gemini Help Center documentation with deeper levels of advertiser-specific content.
  • Gemini advertisers will benefit from richer engagement and more “robust” experience working with the UI and new content/topics. All the Gemini content has been expanded (at least 4x), with all new content for advertisers, including new videos, graphics, how-to’s, bulk tables, campaign creation, reporting, targeting, what’s new sections, and other technical content.
  • If you’re working with Bulk file fields and object types, refer to the section on Get Started with Gemini Bulk for detailed information on downloading and uploading bulk files, as well as navigating Bulk object types. The Gemini UI now points to the Advertiser Guide for Help & Guidelines.

WOEID Lookup by Zip Code

  • Support has been provided for looking up WOEIDs by Zip code. You can look up the WOEID for a location that may not be in the dictionary by passing in the location name as a parameter, as well as an optional type parameter, which can be Zip.
  • For more information, refer to Data dictionary.

Reminder: audience_stats cube was deprecated 2/29/16; use user_stats cube

  • [Reminder] In Custom Reporting, the Audience cube has been deprecated, as previously announced. Use the user_stats. Note that you’ll need to remove the audience-type filter for Geo (country, city, state, DMA, zip). Use the new Geo fields in your report instead.

Using the Gemini Sandbox Environment

  • The Gemini API lets you work with a sandbox environment to test campaigns you’ve created and managed. You use the same consumer key and consumer secret you obtained when you set up your OAuth to access the sandbox.
  • Resource URI: https://sandbox-api.admanager.yahoo.com/v1/rest/{resource}
  • The Gemini sandbox serves as a modified version of the production environment. While all operations are designed to function the same in the sandbox as in the production environment, the campaigns and ads you create in this environment do not actually serve. The sandbox environment is completely separate from your production environment.
  • All campaigns, ads, and keywords you create in the sandbox are available in the sandbox environment only. There is no possibility that the ads you create in the sandbox will be accidentally served. Nor will your production accounts be charged for any mock transactions in the sandbox environment.
  • You will need to create a sandbox account in order to test in this environment. You can do this by making a POST call to the sandbox signup endpoint and passing in the name you wish to call your test advertiser. The response will be a test advertiser object that will only be available in the sandbox environment. For more details, see Getting Started.

Required Fields by Ad Type Matrix

  • We’ve added a new matrix which details the required fields when serving different ad types. For more information, see Ad documentation > Matrix view of required fields.