AdGroupUrls

Contains the methods for managing the ad group's URLs. For more information, see URL Tracking with Upgraded URLs.

Methods

Method Name	Return Type	Description
clearTrackingTemplate	void	Removes the tracking template from this ad group.
getCustomParameters	Object	Gets the ad group's custom parameters.
getTrackingTemplate	string	Gets the ad group's tracking template.
setCustomParameters(Object customParameters)	void	Sets the ad group's custom parameters.
setTrackingTemplate(string trackingTemplate)	void	Sets the ad group's tracking template.

clearTrackingTemplate

Removes the tracking template from this ad group. For information about tracking templates, see Tracking Templates.

Returns

Type	Description
void	Returns nothing.

getCustomParameters

Gets the ad group's custom parameters.

Custom parameters are helpful with sharing dynamic information across multiple URLs. For more information about its usage, see Custom Parameters.

Returns

Type	Description
Object	A map of the ad group's custom parameters. For example, {key1: 'value1', key2: 'value2', key3: 'value3'}, where key is the name of the custom parameter and value is the parameter's value.

getTrackingTemplate

Gets the ad group's tracking template.

Tracking templates are used with the keyword's FinalUrl to create the destination URL used by the ad. For more information, see What tracking or URL parameters can I use?

Returns

Type	Description
string	The ad group's tracking template.

setCustomParameters(Object customParameters)

Sets the ad group's custom parameters. Use this method if your final URL or tracking template includes custom substitution strings.

To use a customer parameter name in the final URL or tracking template, enclose the name in curly braces and add a leading underscore (_) to the name. For example, if the parameter name is foo, use {_foo} in the tracking template or final URL. Do not add a leading underscore to the parameter name when defining the custom parameters object.

Calling this method replaces the ad group's existing custom parameters.

To clear the custom parameters from the ad group, pass an empty object (for example, setCustomParameters({})). If you clear the ad group's custom parameters, the ad group inherits the URLs from its parent campaign (if the campaign specifies URLs). To completely clear custom parameters, clear the parameters at all levels.

Custom parameters are helpful with sharing dynamic information across multiple URLs. For more information about its usage, see Custom Parameters.

Arguments

Name	Type	Description
customParameters	Object	A map of up to three custom parameters to use in the ad group. For example, {key1: 'value1', key2: 'value2', key3: 'value3'}, where key is the name of the custom parameter and value is the parameter's value. The parameter's name may contain only alphanumeric characters and the parameter's value may not contain white space. The name may contain a maximum of 16 8-byte characters and the value may contain a maximum of 200 8-byte characters.

Returns

Type	Description
void	Returns nothing.

setTrackingTemplate(string trackingTemplate)

Sets the tracking template to use with this ad group.

Tracking templates are used with the keyword's FinalUrl to create the destination URL used by the ad. For more information, see What tracking or URL parameters can I use?

Arguments

Name	Type	Description
trackingTemplate	string	The tracking template to use with this ad group.

Returns

Type	Description
void	Returns nothing.