EWS V.7.0.0 Has Launched
Enterprise Web Services
Version 7.0.0 Has Launched
Yahoo! Search Marketing has launched
a new version of the Enterprise Web Services (EWS) Marketing API. EWS Version 7.0
is a major version release and includes features that are
backward-incompatible.
What Do I Need to Do?
We suggest
that you first experiment with Version 7.0 in the EWS sandbox, make any
required changes to your client application and test your implementation prior
to switching over to the production environment.
About this Release
• EWS Version 7.0.0 has been released to the production
• While EWS Version 6.x.x will continue to be available in production, we recommend that you switch to Version 7.0.0 as soon as possible.
• This release is backward-incompatible. To take advantage of the new features, you will need to re-compile your code against Version 7.0.0 WSDLs.
New Features
The new features and changes in EWS Version 7.0.0 are summarized below.
Enhanced Mobile Support
• Enhanced mobile support will allow mobile
advertisers to scale their campaign management activities similar to the web
offering.
• AccountService,
AdGroupService,
AdService,
BulkService,
CampaignService,
ExcludedWordsService,
KeywordService
and TargertingService
will now be available for Mobile Sponsored Search.
• Mobile APIs will be available in US, UK, DE and JP
markets.
Excluded Words at the Campaign Level
• Excluded words allows filtering unwanted user
queries when the Advanced match type is enabled.
• Excluded words will now be supported at the campaign
level, in addition to the existing availability of excluded words at the account
and ad group levels.
• Excluded words at the campaign level for web will be
supported in all markets. Excluded words at the campaign level in mobile will
be supported only for the JP market.
• For more
details, see ExcludedWordsService.
Advanced Match for Mobile
• Advanced match type tactic setting will be available
for mobile accounts in the JP market.
Enhanced
Reporting
• Campaign, ad group, ad and keyword summary reports can now be filtered for specific campaigns. A maximum of 25 Campaign IDs can be provided per request. See BasicReportRequest for more details.
Enhanced Bulk Service
•
BulkService now allows downloading ad groups using downloadAdGroups.
•
A new XML
Schema (version 2.5) is available for those who use the GENERIC_XML format.
With the new XML format, advertisers can additionally:
•
Manage campaign daily spend limit
• Manage geographical targeting of campaigns and ad groups
•
Manage network distribution targeting of campaigns
and ad groups
•
Manage excluded words at account and campaign level
in addition to the ad group level
Batch API to set keyword
urls
•
A new batch API setKeywordUrls
provides an easy way to set the url for one or many keywords.
New Operations and Data Objects
Please refer to the EWS
v7.0 release notes to get a complete list of all the new operations and
data objects added in EWS v7.0.
Removed Operations
KeywordService
• getKeywordsByAccountID - Alternate recommended APIs to use are getKeywordsByAdGroupID or downloadAccount.
•
getKeywordsByAdGroupByParticipatesInMarketplace - Alternate
recommended API to use is getKeywordParticipationStatusByAdGroupId.
BulkService
•
getBulkDownloadStatusInfo - Alternate recommended
API to use is getBulkDownloadStatus.
Changed Operations
AdGroupService
•
splitAdGroupBasedOnTactic
ForecastService
•
getHistoricalDataForKeywords
- Note: Historical data will now
be restricted to 18 months only. This also applies to users of EWS v6.x.
Changed Data Objects
•
AdGroup:
Optional attribute AdGroupCarrierConfig
•
Ad:
Optional attribute AdCarrierConfig
•
Campaign:
Optional attribute CampaignCarrierConfig
•
Keyword:
Optional attribute KeywordCarrierConfig
•
ExcludedWord
: Added new attribute campaignID
•
BasicReportRequest
: optional attribute campaignIDs.
•
BulkDownloadStatusResponse
: Contains estimate of timeRemaining
Questions
For more information about our versioning process, please read our Versioning
FAQs. If you have further questions, please contact your Technical Account
Manager or visit our support page here.