Saturday, November 07th, 2009
Enterprise Web Services Version 6.0 Has Launched
Yahoo! Search Marketing has launched a new version of the Enterprise Web Services (EWS) Marketing API to the production environment. EWS Version 6.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 6.0 in the EWS sandbox, make any required changes to your client application and test your implementation. Then switch over to production.
About this Release
• EWS Version 6.0 has been released to production.
• While EWS Version 5.x.x will continue to be available in production for 120 days after EWS Version 6.0 is released, we recommend that you switch to Version 6.0 as soon as possible.
• EWS Version 5.x.x will not be available after the 120-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 6.0 WSDLs.
New Features
The new features and changes in EWS Version 6.0 are summarized below.
Profile APIs Added for Network Distribution
• EWS APIs will allow setting network distribution using targeting service. In this release, profile APIs (typed APIs) will be available. Please note that framework APIs to support network distribution are already available in EWS v5.2.
• The network distribution feature is currently available in AU market, which includes Australia and New Zealand. It is tentatively scheduled for availability in the U.S. market in early Q1 2010
• For more information about the network distribution feature, please view our documentation here.
Domain Blocking in Japan (JP) Market
• Domain Blocking is now available in JP Market. See AccountService.
Reporting APIs
• A new API getBooksClosedTime will provide advertisers with the Books Closed Date and Time for a given report.
• The APIs used to retrieve reports have changed. See the section below on Changes to Services.
• The Targeting Reports will now have Conversion Metrics by default.
Provide country for VAT Number Registration
• Advertisers and Resellers can now optionally provide a country code for VAT (Value Added Tax) number of registration. If VAT country code is not provided, then the user’s country of residence is assumed to be the country assigned to the VAT number.
Modified Operations related to VAT number registration
• AccountService: Advertisers can optionally provide a country code where VAT number is registered, if that is different from country of residence
• VaultService: Resellers can optionally provide a country code where VAT number is registered, if that is different from country of residence
Changes to Services in v6.0
Removed Services
• UpgradeService
Changes to BasicReportService
New Operations:
• addReportRequest
• getReportDownloadUrl
• getReportDownloadUrls
• getBooksClosedTime
Removed Operations:
• addReportRequestForAccountID
• addReportRequestWithAccountAggregation
• getReportOutputUrl
• getReportOutputUrls
New Data Objects:
• ReportDownloadInfo
Details of new Operations and modified data objects in v6.0
Please refer to the EWS v6.0 release notes to get the full list of new operations and data objects added in EWS v6.0
Questions?
For more information about our versioning process, please read our Versioning FAQs. If you have further questions, please contact your Technical Solutions Manager or visit our support page here.
TopSaturday, November 07th, 2009
Enterprise Web Services Version 6.0 Sandbox Has Launched
In the fourth quarter of 2009, Yahoo! Search Marketing is planning to launch a new version of the Enterprise Web Services (EWS) Marketing API. EWS Version 6.0 is a major version release and includes features that are backward-incompatible. EWS Version 6.0 has been released to the EWS sandbox.
What Do I Need to Do?
We suggest that you first experiment with Version 6.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.
About this Release
• EWS Version 6.0 has been released to the EWS sandbox.
• The production release will occur approximately 30 days after the sandbox release.
• While EWS Version 5.x.x will continue to be available in production for 120 days after EWS Version 6.0 is released, we recommend that you switch to Version 6.0 as soon as possible.
• EWS Version 5.x.x will not be available after the 120-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 6.0 WSDLs.
New Features
The new features and changes in EWS Version 6.0 are summarized below.
Profile APIs Added for Network Distribution
• EWS APIs will allow setting network distribution using targeting service. In this release, profile APIs (typed APIs) will be available. Please note that framework APIs to support network distribution is already available in EWS v5.2.
• The network distribution feature is currently available in AU market, which includes Australia and New Zealand. It is tentatively scheduled for availability in the U.S. market in early Q1 2010
• For more information about Network Distribution, please visit our documentation here.
Domain Blocking in Japan (JP) Market
• Domain Blocking is now available in JP Market. See AccountService .
Reporting APIs
• A new API getBooksClosedTime is introduced that will provide advertisers with the Books Closed Date and Time for a given report.
• The APIs used to retrieve reports have changed. See Section below on Changes to Services.
• The Targeting Reports will now have Conversion Metrics by default.
Changes to Services
Removed Services
UpgradeService
Changes to BasicReportService
Following are changes to the BasicReportService
New Operations
addReportRequest
getReportDownloadUrl
getReportDownloadUrls
getBooksClosedTime
Removed Operations
addReportRequestForAccountID
addReportRequestWithAccountAggregation
getReportOutputUrl
getReportOutputUrls
New Data Objects
ReportDownloadInfo
New Operations and Modified Data Objects
Please refer to EWS v6.0 release notes to get the full list of new operations and data objects added in EWS v6.0
http://developer.searchmarketing.yahoo.com/docs/changelog.php
Questions?
For more information about our versioning process, please read our Versioning FAQs. If you have further questions, please contact your Technical Solutions Manager or visit our support page here.
TopSaturday, November 07th, 2009
Enterprise Web Services Version 6.0 Coming Soon
Yahoo! Search Marketing is planning to launch a new version of the Enterprise Web Services (EWS) Marketing API in the next 60 days. EWS Version 6.0 will be a major version release, and includes features that are backward-incompatible.
About this Release
• EWS Version 6.0 is expected to be released to the EWS sandbox early fourth quarter of 2009.
• The production release will occur approximately 30 days after the sandbox release.
• While EWS Version 5.x.x will continue to be available in production for 90 days after EWS Version 6.0 is released, we recommend that you switch to Version 6.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 6.0 WSDLs.
New Features — Network Distribution
Using Network Distribution, advertisers may set up campaigns or ad groups targeted to Yahoo! Search, Yahoo! Partners, or both. See: TargetingService. If advertisers choose to set up a campaign at Entire Network (i.e., both Yahoo! Search and Yahoo! Partners), they have the ability to fine-tune their bids by providing Discounts/Premiums on the Yahoo! Partners.
• EWS APIs will allow setting Network Distribution using targeting service. In this release, profile APIs (typed APIs) will be available. Please note that framework APIs to support Network Distribution is already available in EWS v5.2.
• APIs will provide you with the flexibility to discount lesser yield traffic and add premiums for the traffic with better ROIs.
• The Network Distribution feature is currently available in AU market, which includes Australia and New Zealand. It is tentatively scheduled for availability in the U.S. market in early Q1 2010.
What Do I Need to Do?
We suggest that you first experiment with Version 6.0 in the EWS sandbox when available, 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. Look for more detailed updates regarding this release soon.
Questions?
For more information about our versioning process, please read our Versioning FAQs. If you have further questions, please contact your Technical Solutions Manager or visit our support page here.
TopSaturday, November 07th, 2009
Enterprise Web Services Version 5.2.0 Has Launched
Yahoo! Search Marketing has released Enterprise Web Services (EWS) Marketing API Version 5.2.0 in our production and sandbox environment. EWS Version 5.2.0 is a minor-version release and includes features that are backward-compatible.
What Do I Need to Do?
We suggest that you first experiment with Version 5.2.0 in the EWS sandbox environment and test your implementation. If you are running a previous version, please recompile your code for v5.2.0 to use the new features. After completing your tests, you can then switch your application over to point to the EWS v5.2.0 production environment.
About this Release
• EWS Version 5.2.0 has been released in production and the sandbox.
• We recommend that you upgrade to Version 5.2.0 as soon as possible.
• This release is backward-compatible. You will not need to recompile the code to use the features of this release.
New Features
Network Distribution
The new network distribution feature is designed to give advertisers greater control over how they set their bids for different traffic sources and where their ads show. It allows advertisers to set up targeted campaigns and adjust bids relative to their bids for Yahoo! traffic. To help you optimize your campaigns, your reports will show performance based on distribution channel at the keyword, ad group and campaign level. This feature will be available only in the AU market in the second half of September.
Ad Delivery Report
The Ad Delivery Report (ADR) is designed to provide a clearer understanding of where your ads are being displayed and how they are performing. You can use this information to guide your decisions to block domains that do not perform for you. This feature is available in the US, UK, FR, DE, AU, IT and ES markets.
EWS APIs to Support Mobile Advertising
EWS APIs are enhanced to facilitate mobile advertising. Advertisers can use APIs to get historical and real-time forecasting, and to get bid information for mobile. Mobile aware reports will allow you to analyze the performance of mobile advertising. Mobile APIs are available in the US, UK, DE and JP markets.
New Operations
Please refer to the EWS v5.2 release notes to get a list of the new operations and data objects added in EWS v5.2.
Questions?
For more information about our versioning process, please read our Versioning FAQs. If you have further questions, please contact your Technical Solutions Manager or visit our support page here.
TopThursday, July 23rd, 2009
Enterprise Web Services Version 5.1.0 Has Launched
Yahoo! Search Marketing has released EWS Version 5.1.0 in our production and sandbox environment. EWS Version 5.1.0 is a minor version release, so all new features are backwards-compatible with EWS Version 5.0.0.
What Do I Need to Do?
We suggest that you first experiment with Version 5.1.0 in the EWS sandbox environment and test your implementation. If you are running a previous version, please recompile your code for v5.1.0 in order to use the new features. After completing your tests, you can then switch your application over to point to the EWS v5.1.0 production environment.
About this Release
• EWS Version 5.1.0 has been released in our production and sandbox environment.
• We recommend that you implement EWS Version 5.1.0 to use the new added functionality.
• This release is backwards-compatible with EWS v5.0.0.
New Features
Bulk service now allows for uploading a bulk file in TSV, XML and Excel XML formats. You can download an account or campaigns to make changes, and upload the bulk file when complete. This feature allows for asynchronous operations of bulk changes.
New Operations
New operations added to services in EWS Version 5.1.0 include:
BulkService
• getBulkDownloadStatusInfo
• getBulkUploadStatus
• getBulkUploadTokenUrl
New Data Objects
New data objects in EWS Version 5.1.0 include:
• BulkDownloadStatusInfo
• BulkFeedbackFileType
• BulkUploadStatusResponse
• BulkUploadTokenUrlResponse
TopWednesday, July 01st, 2009
Enterprise Web Services Version 4.3.0 to Sunset on 8/31/09
Important notice: EWS v4.3.0 will be deprecated on August 31,
2009. After this date, EWS v4.3.0 requests will not be serviced, so we
highly recommend that you migrate your applications to EWS v5.0 prior
to August 31.
What’s New in EWS v5.0
EWS v5.0 provides increased targeting options, including enhanced
geographical, demographic and dayparting. It also includes enhancements
to domain blocking and reporting functions.
What Do I Need to Do?
Prior to launching your new code into production, we strongly urge
you to start experimenting with Version 5.0.0 in the EWS sandbox, to
safely make any required changes to your client application and test
your implementation. Then, launch your new code into production as soon
as possible.
For more details on these changes, please review the EWS v5.0 release notes.
Questions?
For more information about our versioning process, please read our Versioning FAQs.
If you have further questions, please contact your Technical Solutions Manager or ews-help@yahoo-inc.com.
TopMonday, March 16th, 2009
EWS Version 5.0.0 Has Been Released in Production
On March 16, 2009, Yahoo! Search Marketing released EWS Version
5.0.0 in production environment. Version 5.0.0 is a major-version
release, and includes features that are backward-incompatible. We urge
you to complete your development on Version 5.0.0 as soon as possible,
as we plan to deprecate EWS Version 4.x.x 90 days after production
launch.
New Features
Take advantage of Yahoo!'s enhanced targeting capabilities in EWS Version 5.0.0:
Geo-targeting Enhancements
- Flexibility to control at the campaign or ad group levels
- Bid adjustment option
- Ability to geo-target at multiple levels within the same campaign/ad group
Demographic Preferences
- Under-age Filtering (age 17 and under)
- Bid adjustment options for specific age and gender audiences
Ad Scheduling (Dayparting)
- Day-of-week and time-of-day filtering based on audience or advertiser time zone
- Bid adjustment options for specific one-hour increments
Improved Forecasting
- Forecasting available per targeting dimension
- Content Match forecasting
What Do I Need to Do?
Prior to launching your new code into production, we strongly urge
you to start experimenting with Version 5.0.0 in the EWS sandbox, to
safely make any required changes to your client application and test
your implementation. Then, launch your new code into production as soon
as possible.
The major new features are explained in detail in the release notes available on our Technology Portal.
Questions?
For more information about our versioning process, please read our Versioning FAQs here.
If you have further questions, please contact your Technical Solutions Manager or ews-help@yahoo-inc.com.
TopWednesday, January 21st, 2009
Enterprise Web Services Version 5.0.0 Sandbox Has Launched
In the first half of 2009, Yahoo! Search Marketing is planning to launch a new
version of the Enterprise Web Services (EWS) Marketing API. EWS Version 5.0.0 is a
major version release, and includes features that are backward-incompatible. \
EWS Version 5.0.0 has now been released to the EWS sandbox.
What Do I Need to Do?
We suggest that you first experiment with Version 5.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.
About this Release
- EWS Version 5.0.0 has been released to the EWS sandbox.
- The production release will occur approximately 30 days after the sandbox release.
- While EWS Version 4.x.x will continue to be available in production for 90 days
after EWS Version 5.0.0 is released, we recommend that you switch to Version 5.0.0 as soon as possible.
- EWS Version 4.x.x 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 5.0.0 WSDLs.
New Features
The new features and changes in EWS Version 5.0.0 are summarized below.
Enhanced Targeting
- Demographic targeting based on population classifications like gender and age range.
- Dayparting targeting based on the audience time of the day
- Country level targeting is now supported for AU, CA and UK.
- Advertisers can now target varied geographical levels in one campaign/ad group.
More Domain Blocking
The number of domains that can be blocked at the account level has been increased from 250 to 500.
Account And Campaign Spend Caps
In addition to campaign spend limits for all markets, advertisers in the US market
can specify a tactic based cap on the daily spend limit.
Change in UK Credit Card Support
In the UK market, we've changed support for credit cards from SWITCH to MAESTRO.
More Domain Blocking
The number of domains that can be blocked at the account level has been increased from 250 to 500
Enhanced Documentation
- A wireframe-like UI, increased usability and easy-to-use navigation
- Site search includes suggestion capability
- Java and Perl sample code for selected APIs, which can be downloaded
For detailed release notes please refer to the change log page.
Questions?
If you have further questions, please contact your Technical Account Manager or ews-help@yahoo-inc.com.
Top
