PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Properties specific to the description of gglAdWKeyword variables
  • Identifiers of available languages
  • Functions that use the gglAdWKeyword type
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
gglAdWKeyword (Type of variable)
In French: gglAdWMotClé (Type de variable)
Warning
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 gglAdWKeyword type is used to describe a keyword associated with an ad group for the AdWords Criterion service. The characteristics of this keyword can be defined and modified by several WLanguage properties.
Note: See Declaring a variable for more details.
Example
// 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
// Create a new criterion
Criterion is gglAdWKeyword
Criterion..GroupIdentifier = "123"
...
Criterion..MaxCcp = 500
// Check the criterion
ArrCriterion is array of Variants
Add(ArrCriterion, Criterion)
Target is gglAdWGeoTarget
Target..TargetAll = True
Err is array of gglAdWError
Err = GglAdWCheckCriterion(Cnt, ArrCriterion, "us", Target)
// Actually create the criterion on the server if the check is OK
IF Err..Occurrence = 0 THEN
        GglWrite(Cnt, ArrCriterion)
END
Remarks

Properties specific to the description of gglAdWKeyword variables

The following properties can be used to handle a "keyword" crietrion:
NameType usedEffect
MaxCpcIntegerMaximum bid of cost per click. This property is expressed in micro-units of currency.
ProxyMaxCpcIntegerIndicates whether an active proxy bid is found for this keyword (for example, when the budget optimizer is enabled for the campaign to which the keyword belongs). This property corresponds to the maximum cost per click of the proxy bid. This property is expressed in micro-units of currency.
This property is read-only.
FirstPageCpcIntegerEstimation of the cost bid per click required in order for the associated ads to reach the first page of the results of a Google search (when the search exactly corresponds to the keyword). This property is expressed in micro-units of currency.
ExemptionRequestCharacter stringText explaining why the ad does not comply with the use conditions of the service. This text can also be used to ask for an exception to this violation.
PausedBoolean
  • True if the "keyword" criterion is paused,
  • False if this criterion is enabled.
StateCharacter stringCurrent status of the "keyword" criterion. This property is available in read-only. The available values are:
  • gglActive: the criterion is enabled.
  • gglDeleted: the criterion is deleted.
  • gglDisapproved: the criterion is disapproved.
ExcludedBoolean
  • True if this criterion must be excluded from the search,
  • False otherwise. The ad will not be displayed via this criterion.
IdentifierCharacter stringIdentifier of the criterion.
This property is read-only.
GroupIdentifierCharacter stringIdentifier of the ad group to which the criterion belongs.
This property can be used in write mode when the creating the criterion only. In the other cases, this property is available in read-only.
LanguageCharacter stringLanguage of the criterion.
This property can be used in write mode when the keyword is created. In the other cases, this property is available in read-only.
QualityScoreIntegerInteger from 1 to 10 indicating the quality of the keyword (10 being the score corresponding to the best quality).
This property is available in read-only.
TextCharacter stringText of the keyword.
This property can be used in write mode when the keyword is created. In the other cases, this property is available in read-only.
TypeCharacter stringSearch mode available for this keyword:
  • "Broad"
  • "Phrase"
  • "Exact"
This property can be used in write mode when the keyword is created. In the other cases, this property is available in read-only.
TypeCriterionCharacter stringIndicates the type of criterion:
  • "website" for the Web site criteria
  • "keyword" for the keyword criteria.
This property is available in read-only.
DestinationURLCharacter stringDestination URL associated with the criterion. This URL will be displayed when the keyword is clicked by the user.
Note: These properties can be handled by using one of the following syntaxes:
  • <Variable Name>..<Property Name>
  • <Variable Name>.<Property Name>

Identifiers of available languages

The identifiers of languages are as follows:
Identifier - LanguageIdentifier - Language
"ar" - Arabic"bg" - Bulgarian
"ca" - Catalan"cs" - Czech
"da" - Danish"de" - German
"el" - Greek"en" - English
"es" - Spanish"et" - Estonian
"fi" - Finnish"fr" - French
"hi" - Hindi"hr" - Croatian
"hu" - Hungarian"id" - Indonesian
"is" - Icelandic"it" - Italian
"iw" - Hebrew"ja" - Japanese
"ko" - Korean"lt" - Lithuanian
"lv" - Latvian"nl" - Dutch
"no" - Norwegian"pl" - Polish
"pt" - Portuguese"ro" - Romanian
"ru" - Russian"sk" - Slovak
"sl" - Slovenian"sr" - Serbian
"sv" - Swedish"tl" - Filipino
"th" - Thai"tr" - Turkish
"uk" - Ukrainian"ur" - Urdu
"vi" - Vietnamese"zh_CN" - Simplified Chinese
"zh_TW" - Traditional Chinese
This list is the one supported when this documentation was published. To find out the exhaustive list of supported languages, see http://code.google.com/intl/en/apis/adwords/docs/developer/adwords_api_languages.html that presents the list of supported languages ("Target criteria" column).

Functions that use the gglAdWKeyword type

Versions 14 and later
GglDelete
New in version 14
GglDelete
GglDelete
Deletes data from the Google server.
Versions 14 and later
GglWrite
New in version 14
GglWrite
GglWrite
Creates and/or updates data on the Google server (addition or modification of data).
Minimum required version
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment