PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Properties specific to the description of gglAdWKeywordRequest variables
  • Functions that use the gglAdWKeywordRequest 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
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 gglAdWKeywordRequest type is used to describe the request for estimate regarding the traffic generated by keywords.
This type of variable can be used:
  • in an isolated way. In this case, the estimate will be performed by GglAdWEstimateKeyword.
  • to define the keywords associated with a campaign or with an ad group to estimate. In this case, this type of variable is used by the gglAdWAdGroupRequest type.
The characteristics of this type can be defined and modified by several WLanguage properties.
Note: See Declaring a variable for more details.
Example
// Connection to Google
Cnt is gglAdWConnection
Cnt..Email = "vince@gmail.com"
Cnt..Password = "azerty"
Cnt..UserAgent = "MyApp-01"
Cnt..SandboxMode = True

// Request for estimate
MyCampaign is gglAdWCampaignRequest
MyCampaign..Identifier = 789456
MyCampaign..LanguageTargeting = "en"

MyGroup is gglAdWAdGroupRequest
MyGroup..Identifier = 123456
MyKeyword is gglAdWKeywordRequest
MyKeyword..Identifier = 321654

Add(MyGroup..KeywordRequest, MyKeyword)
Add(MyCampaign..AdGroupRequest, MyGroup)

arrCampaign is array of gglAdWCampaignRequest
Add(arrCampaign, MyCampaign)

Estimate is array of gglAdWCampaignEstimate
Estimate = GglAdWEstimateCampaign(Cnt, arrCampaign)
Remarks

Properties specific to the description of gglAdWKeywordRequest variables

The following properties can be used to handle the request for estimate regarding the traffic generated by keywords:
Name Type used Effect
MaxCpcIntegerBid for the keyword (maximum cost per click in micro-units).

The following rules are used to define the value of MaxCpc that will be taken into account:
  • MaxCpc property of gglAdWKeywordRequest if it exists.
  • MaxCpc property of the keyword if it exists.
  • MaxCpc property of gglAdWAdGroupRequest if it exists.
  • MaxCpc property of the ad group if it exists.
IdentifierCharacter stringIdentifier of keyword.

This property must not be specified for a new keyword.
NegativeBoolean
  • True if the keyword must be excluded,
  • False otherwise.
By default, the keyword is not excluded.

This property is optional. If it is specified, it overloads the property of the existing keyword.

If the keyword is excluded, the ad will not be displayed when a search is performed on this word by the user.
TextCharacter stringText used to identify the keyword. If the keyword identifier is specified, this text will overload the text of the existing keyword.
This property is mandatory for a new keyword.
TypeCharacter stringType of correspondence for the keyword. The possible values are as follows:
  • "Broad": all the expressions containing the specified keyword will be proposed.
  • "Phrase": all the expressions containing the specified expression will be proposed.
  • "Exact": all the expressions exactly containing the specified keyword will be proposed.
Note: These properties can be handled by using one of the following syntaxes:
  • <Variable Name>..<Property Name>
  • <Variable Name>.<Property Name>

Functions that use the gglAdWKeywordRequest type

Versions 14 and later
GglAdWEstimateKeyword
New in version 14
GglAdWEstimateKeyword
GglAdWEstimateKeyword
Returns the estimated traffic generated by a set of Google AdWords keywords.
Minimum required version
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment