type is used to describe a Google AdWords marketing ad whose type is "Image ad". The image ads are graphic AdWords ads. They are displayed on some sites of the Google network. The image ads can be related to the content of the pages on which they are displayed.
The characteristics of this image ad can be defined and modified by several WLanguage properties.
: See Declaring a variable
for more details on the declaration of this type of variable and the use of WLanguage properties.
// Connection to Google AdWords
Cnt is gglAdWConnection
Cnt..Email = "email@example.com"
Cnt..Password = "azerty"
Cnt..UserAgent = "MyApp-01"
Cnt..DeveloperToken = "ABcdeFGH93KL-NOPQ_STUv"
Cnt..ApplicationToken = "ZYXwvu-TSR123_456ABCDE"
Cnt..SandboxMode = True
// Retrieve an ad according to its identifier
MyVariant is Variant
MyVariant = GglAdWGetAd(Cnt, "5545")
MyAd is gglAdWImageAd = MyVariant
// Modify the ad
MyAd..DestinationURL = "http://newurl.com"
// Apply the changes to the server
MyArray is array of Variant
Properties specific to the description of gglAdWImageAd variables
The following properties can be used to handle an image ad:
|Property name||Type used ||Effect |
|ExemptionRequest||Character string||Text used to explain why the ad does not comply with the use conditions of the service (up to 300 characters). This text can also be used to ask for an exception to this violation.|
|Disapproved||Boolean||True if the ad was disapproved by Google, False otherwise. This property is available in read-only.|
|Report||String constant||Current status of ad.|
The available values are:
- gglActive: The ad is active.
- gglPaused: The ad is paused.
- gglDeleted: The ad is deleted.
|Identifier||Character string||Identifier of the ad. This identifier is associated with the ad by the Google AdWords service when creating the ad. This property is available in read-only.|
|GroupIdentifier||Character string||Identifier of ad group to which the ad belongs. This property can be used in write mode when creating the ad only. In the other cases, this property is available in read-only.|
|Image||gglAdWImage||Characteristics of image associated with the image ad.|
The name and the image are mandatory.
|Type||Character string||Type of the ad. This property is available in read-only.|
The type of an image ad is "ImageAd".
|DisplayedURL||Character string||URL displayed in the ad (up to 35 characters). In this URL, there is no need to specify "http://". For example: "mysite.com".|
|DestinationURL||Character string||URL associated with the ad (up to 1024 characters). This URL must have the following format: http://Name-of-domain. For example: "http://www.mysite.com". When the URL is clicked, the corresponding page will be displayed in the browser of Web user.|
: These properties can be handled by using one of the following syntaxes:
- <Variable name>..<Property name>
- <Variable name>.<Property name>
Image formats that will be used for the image ads
For the campaigns that perform a targeting by platform of the desktop and laptop computers, the accepted image formats are as follows: .gif, animated.gif, .jpg, .swf, .png (portable network graphics) and Flash.
The following sizes are supported:
- Square (250 x 250)
- Small square (200 x 200)
- Banner (468 x 60)
- Leaderboard (728 x 90)
- Embedded rectangle (300 x 250)
- Large rectangle (336 x 280)
- Skyscraper (120 x 600)
- Large skyscraper (160 x 600)
For the campaigns that perform a targeting by platform of iPhones an other mobile devices of the same type equipped with a full browser, the accepted models are the Leaderboard ad models for mobile devices of 300 x 50 in .gif, .jpg and .png formats.
Caution: the size of image files must not exceed 50 KB.
See the Google AdWords help for more details.