Welcome to MSDN Blogs Sign in | Join | Help

Browse by Tags

All Tags » Top Issues   (RSS)

Webcast recording from adCenter API v5 update Live Meeting

 

In last week's webcast, Program Manager Shamit Patel  emphasized the deadline for API users to update code to use version 5 of the adCenter API. His point was that developers should update soon to allow time for testing and troubleshooting implementation of the new code. With summer vacations approaching, now is the time to move to V5.

The Live Meeting last week discussed some new questions from customers and included a walkthrough of the basic changes. View the Webcast below in Silverlight streaming media. Or download the video with the link below.

-Thanks

Chris

ReportAggregation.Summary Value Update: TimePeriod Column Removed

An update to the adCenter API was recently released to allow the ReportAggregation.Summary value to pull the aggregate reports without the TimePeriod column required.

We removed this extra column in the ReportAggregation.Summary value to help streamline your report request and simplify the data we need to create your report.

To use this updated value, you will need to remove the TimePeriod column from the ReportAggregation.Summary value. If you submit the ReportAggregation.Summary value with the TimePeriod column still in place, you may receive a 2034 error message: “The specified report request contains a TimePeriod column which is incompatible with the requested Summary report aggregation. Please submit a report request with valid report columns for a summary report.”

It is important to note that the TimePeriod is still required for all other reports. This only applies to the ReportAggregation.Summary value.

Please let us know if you have questions.

-Chris

Slides and Notes from adCenter API V5 Presentation

Those of you who attended the Live Meeting conference on Tuesday had a chance to talk with Shamit Patel, the program manager leading API development for adCenter. We appreciate your taking the time toAPIslidehomepage learn more about the new version and to share your questions and requests. I've attached the PowerPoint slides and notes from the presentation. I will upload the recording of Shamit's session in the next couple days.

 

 

 

 

 

 

Thank you,

-Chris

 

 

 

 

 

Recording of adCenter API V5 Live Meeting Webcast is Now Online

The recording of our February webcast with Gopal Madhavan, senior development lead, is now available for viewing online. Gopal discussed the upgrade to V5 in the first of a series of monthly webcasts. Our next Live Meeting is coming up March 18th . It's a good chance to talk with the development team and get helpful advice on the upgrade or other questions.

http://www.adcentercommunity.com/blogs/api/archive/2008/03/09/recording-of-adcenter-api-v5-live-meeting-webcast-is-now-online.aspx

Update on SSL Certificate Issue for Java Users

 

March 06

Beginning on February 14, Java users may have received an “SSLHandshakeException” when trying to connect to the API URL on HTTPS (SSL). As a short term solution, we recommended that all Java users update their local certificate repository by importing the adCenter API SSL certificate. We posted the step-by-step instructions on how to make this update on the adCenter Developer Forum. At this time, we are no longer recommending that Java users implement the short-term solution.
We are now actively researching a long-term solution for this same issue that will not require an additional coding update on your part. While investigating this issue and a long-term solution, we identified an issue that prevents Java users from building a full certificate chain back up to root CA.
We believe that we can find a solution to this issues, but will need additional time to test and verify our findings. The long-term solution will resolve any issues you are experiencing when it is released. Java users who have already implemented the short-term solution into their code, may be asked to remove the certificate when the long-term solution is released to prevent any future code from breaking. We will proactively notify you as soon as we have resolved this certificate issue. Please do not remove the recommended workaround coding update until you receive a notification from Microsoft adCenter.
We apologize for any inconvenience you may have experienced and thank you for your business.

The Microsoft adCenter Team

Double Http Issue in Destination URL when using both API and UI

 

Archived: February 25, 2008

The adCenter UI prepends an “http://” to the DestinationURL upon Save unless you choose Keyword destination URL in the Destination URL drop down when editing an ad. So if you already have an “http://” in Param1 for your keyword as set via the API for example, you now have two when the ad serves, and the link will be broken as it would look like http://http://company.com. There are workarounds through proper usage, however.

Here is a breakdown of the issue:

* Let’s say for “keyword1”, the SubstParam1 value is “http://a.com” (a perfectly valid and common usage)

* For Ad1, created via the API, the DestinationURL value is {Param1}&adlevelinfo=true (this is allowed, but not recommended. Should only contain {Param1})

* So when a user searches for “keyword1” and the ad displays, the URL would look like http://a.com&adlevelinfo=true (a valid URL)

* But if this ad is simply opened in the UI, then saved (making no changes at all, for example), the Ad1 DestinationURL now contains “http://{Param1}&adlevelinfo=true

* When this ad now displays again, it will have the double http://, and be broken

Currently, this is expected behavior, and is by design.  One workaround, if you choose to use ad-level additional parameters, is to not use “http://” in the keyword SubstParam1 field, and let the browser fill one in if it’s not there. You could update via the API or the UI without problems.  This would not work if any of your destination url’s are https (secure SSL) however, because Internet Explorer, for one, doesn’t try  https if you just type in “a.com”, but only attempts http.

The other option is to not make any updates via the UI once the ads are placed via the adCenter API.

adCenter API Support

API Report Aggregation

 

Archived: September 18, 2007

Q: When I run a performance report I see multiple entries for the same keyword and match type. Why is this happening?

A: In order to be able to return reports for big amounts of data in the shortest possible time, it’s possible that the data returned in a report might not be fully aggregated, and customers will see multiple rows with data for the same keyword and match. They can aggregate that data on their end if they wish. For example, they can sum up all the impression numbers for all rows for a specific keyword to get the aggregated impressions number, or average the avg position, etc. Please note that the average might be a little less straightforward to get. For example:

Row 1: 3 impressions; avg position is 3
Row 2: 1 impression, avg position is 1

The aggregated amount for the impressions is 4 (the sum), but the aggregated average is (3*3+1*1)/4=2.5, not the average of 3 and 1. Formula is (numImpr*avgPos + numImpr*avgPos + …)/sumImpr

The aggregated amounts then should match the ones in a UI report.

- Microsoft adCenter API Support Team

Debugging Web Service Calls

 

Archived: April 13, 2007

Fiddler2 is a useful tool for debugging and capturing HTTP and HTTPS SOAP headers when making web service calls. Sometimes web service calls fail because the SOAP header was formed improperly. Each SOAP/XML tag is case sensitive, for example.

You can download Fiddler2 from here:

http://www.fiddler2.com/fiddler2/

There is one trick to get Fiddler2 to work, as mentioned at:

http://www.fiddler2.com/fiddler2/faq.asp

You may need to add the Fiddler cert to the Trusted Root Cert Folder. When you follow these instructions on the FAQ, you may see the cert located in the Personal cert folder. Just drag it into the Trusted folder.

Also, if you are debugging a .NET client and get the following exception: System.Net.WebException: The underlying connection was closed: A connection that was expected to be kept alive was closed by the server, click Rules > Customize Rules. Scroll down to the OnBeforeResponse handler and uncomment as directed.

Happy debugging!

Jeff Dillon, Microsoft adCenter API Technical Support

Microsoft adCenter Editorial Guidelines

 

Archived: January 26, 2007

Hello,

Do you want more information about the Microsoft adCenter editorial guidelines such as:

  • Character limits
  • Content restrictions
  • Ad relevance
  • Grammar and punctuation
  • Trademarks
  • Technical requirements for URLs and landing pages

If so, check out the adCenter Help topic, Microsoft adCenter Editorial Guidelines.

You can get related information at Style and Grammar Examples.

Once you're in the adCenter Help topics, use the Table of Contents to navigate to other topics.

Thank you.

Walter Poupore
Programming Writer
Microsoft adCenter

 
Page view tracker