Sandbox Maintenance, August 1st

Posted by Brian Kennish, Support Engineer, Ad* APIs

We're planning to refresh the Sandbox again tomorrow at 3 p.m. PDT. As a result, it'll be unavailable for several hours and all associated data cleared. You can regenerate your client accounts afterwards by sending any valid request to the Sandbox without a clientEmail header block.

FIXED: Unable to Access Certain Campaigns

The Campaign Access bug we reported earlier today was fixed at approximately 5pm PST.

We apologize for any inconvenience that this may have caused you, and thank you for your patience.

-- Jon Diorio, Product Marketing

Bug: Unable to Access Certain Campaigns

On Tuesday, July 24, we released some bug fixes that unfortunately prevented some advertisers from modifying campaigns that leverage the ‘position preference’ and ‘preferred cost bidding’ features. Our engineers diagnosed the issue yesterday and we plan to correct the issue today.

We apologize for any inconvenience this may have caused, and will notify you as soon as a fix is in place.

-- Jon Diorio, Product Marketing


Symptoms:

• GetAllCampaign requests do not return the campaign IDs of campaigns that have enabled the Position Preference and Preferred Cost Bidding advanced bidding features.
• Attempts to access one of these campaigns prompts a “The API does not support this type of campaign” error code.

AdWords System Maintenance – July 14

We will be performing routine AdWords system maintenance from 10 a.m. to 2 p.m. PDT on Saturday, July 14, 2007. While all AdWords advertisements will continue to run as normal, you may not be able to perform API operations during this maintenance period.

-Aaron Karp
AdWords API Team

Creating Local Business Ads with the AdWords API

Posted by Brian Kennish, Support Engineer, Ad* APIs

One of the shiny, new features exposed in v8 of the AdWords API is local business ads. Local business ads aren't your typical ad fare, so we thought we'd properly introduce you to them and how they work with the API.

What Are They?

Local business ads let you reach users looking for products and services locally, like pizza in London. They appear as enhanced text ads and map markers on Google Maps. E.g.:

They also appear as similar text ads on Google search results pages and those across the Google search network. You can advertise businesses with locations in the US, Canada, France, Germany, Italy, Japan, the Netherlands, Spain, and the UK. As usual, you only pay for clickthroughs. The AdWords Help Center has more about local business ads themselves.

How Do They Work with the API?

Creating local business ads requires an extra step compared to creating other types of AdWords ads. That's because every local business ad needs to be tied to a Google Maps business listing. With the API, you:

1. Fetch the keys of the businesses you want to promote from Maps.
2. Marshal the keys with your ad content.

Fetching Business Keys from Google Maps

Say you're booking the local business ad shown above. First, if you've registered the business in the Local Business Center (the place to go to update the Google Maps index), you can call getMyBusinesses. If not, you call findBusinesses with some descriptive query terms. The latter invocation in SOAP might read:

<findBusinesses xmlns="https://adwords.google.com/api/adwords/v10">
  <name>Domino's Pizza</name>
  <address>89 Charlwood St, London, SW1V 4PB</address>
  <countryCode>GB</countryCode>
</findBusinesses>

Either method should return an array of matching Business objects:

<findBusinessesResponse xmlns="https://adwords.google.com/api/adwords/v10">
  <findBusinessesReturn>
    <key>
      vbLhTOxEPjI4LNAw2GLNb9YZZZs=Business!d@A!d@Domino's Pizza!d@020 7834
      2211!d@89 Charlwood St!d@London!d@!n@!d@SW1V
      4PB!d@GB!d@-141199!d@51488094!d@1183705200000!d@
    </key>
    <name>Domino's Pizza</name>
    <phoneNumber>020 7834 2211</phoneNumber>
    <address>89 Charlwood St</address>
    <city>London</city>
    <region xsi:nil="true"/>
    <postalCode>SW1V 4PB</postalCode>
    <countryCode>GB</countryCode>
    <longitude>-141199</longitude>
    <latitude>51488094</latitude>
    <timestamp>1183705200000</timestamp>
  </findBusinessesReturn>
  <findBusinessesReturn>Business</findBusinessesReturn>
  <findBusinessesReturn>Business</findBusinessesReturn>
  <findBusinessesReturn>Business</findBusinessesReturn>
  <findBusinessesReturn>Business</findBusinessesReturn>
</findBusinessesResponse>

You grab the key of the relevant one.

Marshalling Ad Content

Next, you stuff the key (AKA businessKey) and the ad particulars into a LocalBusinessAd and hand it off to addAds:

<addAds xmlns="https://adwords.google.com/api/adwords/v10">
  <ad xsi:type="LocalBusinessAd">
    <adGroupId>xsd:int</adGroupId>
    <businessKey>
      vbLhTOxEPjI4LNAw2GLNb9YZZZs=Business!d@A!d@Domino's Pizza!d@020 7834
      2211!d@89 Charlwood St!d@London!d@!n@!d@SW1V
      4PB!d@GB!d@-141199!d@51488094!d@1183705200000!d@
    </businessKey>
    <description1>Choose from our delicious range now</description1>
    <description2>Pre-order or delivered to your door</description2>
    <destinationUrl>http://www.dominos.co.uk/</destinationUrl>
    <displayUrl>www.dominos.co.uk</displayUrl>
    <customIcon>
      <data>xsd:base64Binary</data>
    </customIcon>
    <businessImage>
      <data>xsd:base64Binary</data>
    </businessImage>
  </ad>
</addAds>

Yay! A successful response means your local business ad is ready to be served.

Thanks for taking the time to get to know a little about local business ads with us. Cheers from the Googleplex!

AdWords API Sandbox Maintenance, July 2nd

Posted by Brian Kennish, Support Engineer, Ad* APIs

We're planning to do our regular refresh of the AdWords API Sandbox tomorrow at 3 p.m. PDT. As a result, it'll be unavailable for several hours and all associated data cleared. You can regenerate your client accounts afterwards by sending any valid request to the Sandbox without a clientEmail header block.