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.

Podcast

Tune into the May Product Bulletin podcast for the latest on Gemini API features, changes and product enhancements released this month by the Gemini product development team.

May, 2018

New Flash Sale Countdown Timer Added to Ad Object

  • We’ve introduced a new Countdown Timer for flash ad sales. The Countdown Timer lets you increase CTR for native ads by enabling users to take quick and decisive action to purchase your product before a sale ends. For API users, we’ve added the new Flash Sale Countdown Timer to the Ad object as a new field, called flashSaleConfig. See Ad object fields for details about how to create a flash sale ad using this new field. For more details on how it works, see the Advertiser Guide.

Also see Bulk and ad assets resources in the Gemini Guide.

New Dot DPA Setup Guides for Partners Using 3rd Party Tag Managers

  • We’ve added new Dot Setup guides for partners who are using 3rd Party Tag Managers for DPA Dot tags. The guides describe the steps required to set up and deploy Gemini 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 Gemini Advertiser Guide to access these guides.

New Shared Structured Snippet RESTful Objects Added

  • We’ve added new RESTful objects for Shared Structured Snippet. You can use the Shared Structured Snippet service, which is new in the v3 Gemini API, for creating, updating, and retrieving shared structured snippets at the advertiser account level. For details and example representations, see shared structured snippet and shared structured snippet settings.

New Video: Native Ad Formats

  • To view the different available types of Gemini ad formats and some of their key features, check out our new 3-minute video on native ad formats, with examples that illustrate native ad types. (Note that there is no voice-over audio narration.)

Reminder: New Bidding Strategy: Maximize Conversions

  • New bidding strategy, Maximize Conversions, introduced. It’s ideal for advertisers looking to spend their budget in full, getting the most conversions at the lowest CPA possible.
  • Note: With this update, setting bidding strategies has moved from the ad group level to the campaign level, and campaign-level bidding strategies override ad group bidding strategies. Bidding strategies set at the ad group level via the Gemini API or Bulk are now deprecated as of v3. As a best practice, we recommend setting bid strategies at the campaign level, which has been exposed for v3 and above. For descriptions of bidding strategies described in API objects, see Campaigns and Ad Group documentation. For updated information on Bulk, refer to Bulk Campaign Fields. For more details on how each bidding strategy works, see Use New Bidding Strategies For Greater Control & Flexibility in the Gemini Advertiser Guide.

Reminder: New Chrome extension to validate Dot tags for Dynamic Product Ads (DPA)

  • Gemini now provides you with a Chrome extension that you can use to inspect, validate and troubleshoot Dot tags that you’ve instrumented on your website. See the DPA Dot Instrumentation documentation for details on installing and using this new extension. Also, see the Dynamic Product Ads section of the Gemini Guide for more information including key benefits and other topics.
  • As a reminder, Dynamic Product Ads (DPA) became available in the Gemini API in May 2017. DPA are feed-based ads that can be shown on a native Gemini platform. Use DPAs as retargeting ads from your product feed that scale to promote your products to users who have visited your product websites. To get started, see Dynamic Product Ads for integration steps, product feed operations, creation of product sets and Dot Tag Instrumentation. For additional guidance, see the FAQs.
  • Also, Dynamic Products Ads became available in the Gemini UI in December 2017. Check out the new Dynamic Product Ads video and overview in the Gemini Advertiser Guide for quickstart on how you can take advantage of Dynamic Product Ads in Gemini.

Reminder: New Guide: Integrate Tumblr with Gemini

  • This new guide describes how you can integrate Tumblr Sponsored Posts with your existing Gemini API account. The advantage for Gemini partners and developers is that you can create Tumblr posts programmatically via the Tumblr Ads API and then manage those post campaigns via the Gemini API. For prerequisites and more details, see Integrate Tumblr with Gemini.

Reminder: Gemini v3 API Roadmap

  • To stay current on the latest version of the Gemini API, check out details of the Gemini v3 API Roadmap. Taking advantage of the Gemini v3 API is straightforward and easy to navigate.

Reminder: Glossary of Gemini Terms

Reminder: Updated Postman to v3 Endpoint

  • Updated the Postman collection to the v3 endpoint for all Gemini API calls. Using Postman, you can test and verify the calls you make in the Gemini 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 Gemini Guide for more details on Bulk operations.

Reminder: Migration to Gemini v2 API or v3 API - Action May Be Required

Please be aware that starting on September 1, 2017, the Gemini v1 API was relegated to End of Life (EOL) status; the Gemini v3 API was released on July 25, 2017. The Gemini v2 API is still supported post-release. Official deprecation for the v2 API has not yet occurred. Partners and developers will be notified once this has been officially determined, and a schedule provided. Please note that new features will not be added to v1, and v1 will not be supported. For details on the v3 release schedule, as well as dates for the v1 deprecation, see the Release Schedule and Gemini API Versioning.

Important

Action may be required: Gemini API users may choose to migrate to either v2 API or v3 API.

To migrate to v2 API:

To migrate to v3 API:

  • Users are encouraged to migrate to the new Gemini v3 API directly. v3 is backward compatible with v2, and users may continue using the current landing/display URL structure on v3 without Upgraded URLs migration for the time being. The new Gemini v3 API has been released as of July 25, 2017. This release provides partners and developers with multiple new features and capabilities. For details, see Versioning.

Gemini Native Ads Specs and Resources

Gemini API Video Tutorials

Getting Started Guide: OAuth 2.0 Authentication Steps

Check Out What’s New

  • To stay current with changes, updates and new features in the v2 Gemini API, you’ll want to read this section. What’s New is updated on a weekly cadence for Gemini API partners and developers. Resources includes a link to archived Gemini Release Notes.

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.gemini.yahoo.com/v2/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 Testing - Sandbox.
  • Be sure to check out the video tutorial describing How to set up your Sandbox Environment in the Programmatic Gemini API - Episode 3.

Required Fields by Ad Type Matrix

  • A matrix is available which details the required fields when serving different ad types. For more information, see Ad documentation > Matrix view of required fields.