Home | Sign in | French EN
  • Properties specific to the description of gglAdWImageAd variables
  • Image formats that will be used for the image ads
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Stored procedures
gglAdWImageAd (Type of variable)
In french: gglAdWAnnonceIllustrée (Type de variable)
From version 17, this feature is not available anymore. To use Google AdWords, see the corresponding Google API: https://developers.google.com/adwords/api/docs/guides/start
The gglAdWImageAd 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.
Remark: 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 = "vince@gmail.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
Add(MyArray, MyAd)
GglWrite(Cnt, MyArray)

Properties specific to the description of gglAdWImageAd variables

The following properties can be used to handle an image ad:
Property nameType used Effect
ExemptionRequestCharacter stringText 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.
DisapprovedBooleanTrue if the ad was disapproved by Google, False otherwise. This property is available in read-only.
ReportString constantCurrent status of ad.
The available values are:
  • gglActive: The ad is active.
  • gglPaused: The ad is paused.
  • gglDeleted: The ad is deleted.
IdentifierCharacter stringIdentifier 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.
GroupIdentifierCharacter stringIdentifier 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.
ImagegglAdWImageCharacteristics of image associated with the image ad.
The name and the image are mandatory.
TypeCharacter stringType of the ad. This property is available in read-only.
The type of an image ad is "ImageAd".
DisplayedURLCharacter stringURL displayed in the ad (up to 35 characters). In this URL, there is no need to specify "http://". For example: "mysite.com".
DestinationURLCharacter stringURL 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.
Remark: 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.
Minimum version required
  • Version 14
This page is also available for…
Click [Add] to post a comment