Enterprise Web Services Version 2.0.0 Coming Soon
During mid- to late-May, Yahoo! Search Marketing is planning to launch a new version of the Enterprise Web Services (EWS) Marketing API. EWS Version 2.0.0 offers a new service, enhancements to the existing services and data objects, and 13 new reports. Please read this email carefully to understand all of the new features this release provides users like you.
About this Release
EWS Version 2.0.0 will be released to the EWS sandbox and production at the same time in mid- to late-May. At that time, we will also provide documentation about the new version. As with any new version, some features are not backwards-compatible. We suggest that you first experiment with the new version in the EWS sandbox, make any required changes to your client application and test your implementation. Then be ready to switch over to production before the old version is removed. The old version will be available in production for 60 days after the new version is released.
New Features
Here’s a summary of the new features in EWS V.2.0.0.
• Account Data Object: An existing element, vatCode, has been renamed vatRegistrationNumber. The VAT registration number is required for certain markets only.
• Ad Data Object: An existing element, shortDescription , has a new restriction. This element is now required.
• AccountService: A new parameter has been added to the addAccount operation, accountDailySpendLimit. Use this parameter to set the daily spend limit when creating a new account.
• AdService: A new operation has been added to the AdService, setAdUrl. Use this operation to conveniently change the URL for the ad.
• BidInformationService: Two new operations have been added to the BidInformationService, getMarketBidsForBestRank and getMinBidForKeywordString. The getMarketBidsForBestRank operation returns the highest and lowest keyword bid for a given ad group in a given market. The getMinBidForKeywordString operation returns the minimum bid for the specific keyword.
• CompanyService: A new service has been added to the Marketing API, CompanyService. This service returns information about a company.
• KeywordResearchService: Two new operations have been added to the KeywordResearchService, getCanonicalKeywords and getCommonKeywords. The getCanonicalKeywords operation returns the exact-canon form of a keyword for a given set of keywords. The getCommonKeywords operation returns the most popular phrase for a given set of keywords.
• KeywordService: A new operation has been added to the KeywordService, setKeywordUrl. Use this operation to conveniently change the URL for the keyword.
• MasterAccount Data Object: A new element has been added to the MasterAccount data object, marketID. Now you can use this element to access the marketID from either the MasterAccount object or the Account object.
• MasterAccountService: A new parameter has been added to the addNewCustomer operation, company . Use this parameter to provide company information for the new customer.
• RelatedKeywordRequestType Data Object: A new element has been added to the RelatedKeywordRequestType data object, offset. Use this element to specify the starting point for the next set of keywords.
New Reports
Additionally, we have added some new reports to the Marketing API. The majority of these are “ByDay” reports that aggregate data by day (rather than by reporting period). Another report, the BillingTransactionDetail report, provides information about billing transactions. We invite you to check out and use these new reports to take advantage of the more specific account data that is now at your fingertips.
What I really like is the KeywordResearchService call - something that is sorely missing from Google. This will be great for keyword research!
