Announcements

Friday, February 22, 2008

Enterprise Web Services Version 4.0.0 Sandbox Has Launched

In the first half of 2008, Yahoo! Search Marketing is planning to launch a new version of the Enterprise Web Services (EWS) Marketing API. EWS Version 4.0.0 is a major version release and includes features that are backward-incompatible.

We're pleased to announce that EWS Version 4.0.0 has been released to the EWS sandbox, and we encourage you to log in and get familiar with it.

What Do I Need to Do?

We suggest that you first experiment with Version 4.0.0 in the EWS sandbox, make any required changes to your client application, and test your implementation. Then, be ready to switch over to production when the product release is ready later this year.

About this Release

The Version 4.0.0 production release will occur approximately 30 days after the sandbox release.
While EWS Version 3.0.0 will continue to be available in production for 90 days after EWS Version 4.0.0 is released, we recommend that you switch to Version 4.0.0 as soon as possible.
EWS Version 3.0.0 will not be available after the 90-day transition period ends.
This release is backward-incompatible. To take advantage of the new features, you will need to re-compile your code against Version 4.0.0 WSDLs.

New Features

The new features and changes in EWS Version 4.0.0 are summarized below.

Variable Minimum Bids

In the next several weeks, we plan to change our system so that minimum bids will no longer be fixed for all keywords; they may be higher or lower than $.10. Minimum bids may vary by keyword, ad group and advertiser. EWS Version 4.0.0 is configured to work with variable minimum bids. Thus, if you do not upgrade to EWS Version 4.0.0, you may not have full control over your ads and keywords.

New EWS Service Operations

New operations have been added to the following services with the release of EWS Version 4.0.0:

AdGroupService

getContentMatchMinBidForAdGroupOptimizationGuidelines: Returns Content Match min bid for ad group optimization guidelines by ad group ID.
getSponsoredSearchMinBidForAdGroup: Returns Sponsored Search min bid for an ad group by adgroup ID.
getSponsoredSearchMinBidForAdGroupOptimizationGuidelines: Returns Sponsored Search min bid for ad group optimization guidelines by ad group ID.
getSponsoredSearchMinBidForAdGroups: Returns Sponsored Search min bid for multiple ad groups by multiple adgroup IDs.

AdService

getAdsByAdGroupByParticipatesInMarketplace: Returns ads by ad group by marketplace participation.
getReasonsForAdNotParticipatingInMarketplace: Returns reasons for an ad not participating in a marketplace.

CampaignService

getMinBidForCampaignOptimizationGuidelines: Returns minBid for Campaign Optimization Guidelines by campaign ID.

KeywordService

getKeywordsByAdGroupByParticipatesInMarketplace: Returns keywords by ad group by marketplace participation.
getKeywordsByAdGroupBySponsoredSearchBidStatus: Returns keywords by ad group by Sponsored Search bid status.
getReasonsForKeywordNotParticipatingInMarketplace: Returns reasons for a keyword not participating in a marketplace.
getSponsoredSearchMinBidForKeywordOptimizationGuidelines: Returns Sponsored Search min bid for keyword optimization guidelines.
getSponsoredSearchMinBidForKeywordString: Returns Sponsored Search min bid by keyword.
getSponsoredSearchMinBidForKeywordStrings: Returns Sponsored Search min bids for multiple keywords.
getSponsoredSearchMinBidUpdatesByAdGroupId: Returns the updates to Sponsored Search min bids by ad group.

New EWS Data Objects

The following new data objects have been added with the release of EWS Version 4.0.0:

BidStatus
BidUpdateInfo
NotParticipatingInMarketplaceReason
SponsoredSearchMinBidRequest
Warning

New EWS Data Object Elements

New elements have been added to the following data objects with the release of EWS Version 4.0.0:

Ad
AdGroup
Keyword
All response objects (AdGroupResponse, AdResponse, BasicResponse, and so on)

Deprecated Features

The Bid InformationService getMinBidForKeywordString operation has been deprecated in EWS Version 4.0.0 (refer to the new KeywordService getSponsoredSearchMinBidForKeywordString operation).

Questions?

For more information about our versioning process, please read our Versioning FAQs here.

If you have further questions, please contact your Technical Account Manager or ews-help@yahoo-inc.com.

Sincerely,

Your Partners at Yahoo! Search Marketing

Posted by William McNeal at 3:30 PM

Recent Entries