MobileAd
Data associated with a mobile ad. This data is used by
AdService.
An ad can contain a click-to-call phone number, a link to a website,
or both. You specify which you want by filling in the fields
corresponding to the type of ad you want to place in the following
table. For example, for a click-to-call mobile ad, you must fill
in the fields in the "Click-to-call" column. A hyphen means
don't set the corresponding field.
Note:
For statically typed languages, such as Java, create an instance of MobileAd.
For dynamically typed languages such as Perl and Python,
create an Ad data object. Then either specify the xsi:type attribute as
MobileAd or set the adType field to MobileAd.
For guidelines about mobile ads, see
Editorial Guidelines in the AdWords Help Center. Also see
Mobile
Ad FAQ.
Fields
Inherited Fields
| Field name | Field type | Field description |
|---|
adGroupId |
long |
The id of the AdGroup associated with this Ad.
This field is not mutable. |
adType |
AdType |
The concrete type of this ad. Generally, this attribute is
read only, but may be set by scripting languages to indicate a concrete
type.
Values are:
- TextAd
- ImageAd
- LocalBusinessAd
- MobileAd
- CommerceAd
- VideoAd
|
businessName |
string |
The business name of the mobile ad.
Must not exceed 20 characters except for ads targeted
to Japan which must not exceed 10 Japanese characters. |
countryCode |
string |
The country code
for the phone number in the click-to-call mobile ad.
The click-to-call ad will appear only in this country.
The countryCode will be used to verify the phone number
format, as well validate the targeted mobile carriers. |
description |
string |
The description of the mobile ad.
Must not exceed 18 characters or 9 Japanese characters
except for campaigns targeted only to Japan where
the field must not exceed 12 Japanese characters. |
destinationUrl |
string |
The destination URL associated with this Ad. May be overridden
on a per-keyword basis by Keyword.destinationUrl.
Must not exceed 1024 characters, or 200 characters for mobile ads.
Must be in the full "http://" URL format. Example: http://www.google.com |
disapproved |
boolean |
Whether this Ad has been disapproved by Google.
Disapproved Ads will not be served.
Ads might be disapproved for a variety of reasons, see the
AdWords Help Center for more information about
disapproved ads. |
displayUrl |
string |
The URL shown in an Ad. Must not exceed 35 characters, or
20 characters for mobile ads. Mobile
ads targeted to Japan must not exceed 10 Japanese characters.
The full "http://" URL format is not required. Example: www.google.com |
exemptionRequest |
string |
(Optional) Specifies a reason for allowing submission of
an Ad or Keyword that violates the ad policies described by
Google's AdWords Editorial Guidelines. Maximum length of the
exemptionRequest string is 300 characters.
If you want to submit an Ad or Keyword that violates an
ad policy, you can specify a string explaining
why you want an exemption to the policy in question.
For example, if the headline of an Ad violates the policy for
excessive punctuation, you might request an exemption such as
"Ad for a board game that teaches correct punctuation."
Specifying an exemptionRequest prevents an operation that adds
a policy-violating Keyword or Ad from throwing an exception, but
does not guarantee that the ad will ultimately be approved.
For more information about Ad Violation policies, see
the
Google AdWords Editorial Guidelines. |
headline |
string |
The headline of the mobile ad.
Must not exceed 18 characters or 9 Japanese characters
except for campaigns targeted only to Japan where
the field must not exceed 12 Japanese characters. |
id |
long |
The numeric ID associated with this Ad.
This is set by the AdService when the ad is created and it is not mutable. |
markupLanguages |
string[] |
The list of markup languages to use for the mobile ad.
Values are:
|
mobileCarriers |
string[] |
The list of mobile carriers to use for the mobile ad. Each string
must be of the form 'CarrierName@CountryCode'. To specify that
all available carriers are to be used, use the reserved keyword
'ALLCARRIERS'.
Values are:
CarrierName CountryCode
NTT DoCoMo JP
KDDI/au JP
Vodafone JP
T-Mobile DE
Vodafone DE
E-Plus DE
O2 DE
T-Mobile GB
Vodafone GB
O2 GB
Orange GB
Cingular US
Sprint US
Verizon US
T-Mobile US
Nextel US
China Mobile CN |
phoneNumber |
string |
The phone number for use in click-to-call.
Must not exceed 20 characters. |
status |
AdStatus |
The current status of this ad.
Values are:
|
API Reference
