EWS Announcements

Enterprise Web Services Version 6.0 Has Launched

Sat, 07 Nov 2009 02:55:16 GMT

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.

Enterprise Web Services Version 6.0 Sandbox Has Launched

Sat, 07 Nov 2009 02:55:15 GMT

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.

Enterprise Web Services Version 6.0 Coming Soon

Sat, 07 Nov 2009 02:55:14 GMT

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.

Enterprise Web Services Version 5.2.0 Has Launched

Sat, 07 Nov 2009 02:55:14 GMT

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.

Enterprise Web Services Version 5.1.0 Has Launched

Thu, 23 Jul 2009 12:00:00 GMT

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

Enterprise Web Services Version 4.3.0 to Sunset on 8/31/09

Wed, 01 Jul 2009 12:00:00 GMT

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.

EWS Version 5.0.0 Has Been Released in Production

Mon, 16 Mar 2009 12:00:00 GMT

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?

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.

Enterprise Web Services Version 5.0.0 Sandbox Has Launched

Wed, 21 Jan 2009 12:00:00 GMT

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.