Struct AdGroup

pub struct AdGroup {

    pub resource_name: String,
    pub id: i64,
    pub name: String,
    pub status: i32,
    pub type: i32,
    pub ad_rotation_mode: i32,
    pub base_ad_group: String,
    pub tracking_url_template: String,
    pub url_custom_parameters: Vec<CustomParameter>,
    pub campaign: String,
    pub cpc_bid_micros: i64,
    pub effective_cpc_bid_micros: i64,
    pub cpm_bid_micros: i64,
    pub target_cpa_micros: i64,
    pub cpv_bid_micros: i64,
    pub target_cpm_micros: i64,
    pub target_roas: f64,
    pub percent_cpc_bid_micros: i64,
    pub fixed_cpm_micros: i64,
    pub target_cpv_micros: i64,
    pub optimized_targeting_enabled: bool,
    pub exclude_demographic_expansion: bool,
    pub display_custom_bid_dimension: i32,
    pub final_url_suffix: String,
    pub targeting_setting: Option<TargetingSetting>,
    pub audience_setting: Option<AudienceSetting>,
    pub effective_target_cpa_micros: i64,
    pub effective_target_cpa_source: i32,
    pub effective_target_roas: f64,
    pub effective_target_roas_source: i32,
    pub labels: Vec<String>,
    pub excluded_parent_asset_field_types: Vec<i32>,
    pub excluded_parent_asset_set_types: Vec<i32>,
    pub primary_status: i32,
    pub primary_status_reasons: Vec<i32>,
}

An ad group.

Fields

resource_name: String

Immutable. The resource name of the ad group. Ad group resource names have the form:

customers/{customer_id}/adGroups/{ad_group_id}

id: i64

Output only. The ID of the ad group.

name: String

The name of the ad group.

This field is required and should not be empty when creating new ad groups.

It must contain fewer than 255 UTF-8 full-width characters.

It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.

status: i32

The status of the ad group.

type: i32

Immutable. The type of the ad group.

ad_rotation_mode: i32

The ad rotation mode of the ad group.

base_ad_group: String

Output only. For draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null.

For base ad groups, this field equals the ad group resource name.

This field is read-only.

tracking_url_template: String

The URL template for constructing a tracking URL.

url_custom_parameters: Vec<CustomParameter>

The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.

campaign: String

Immutable. The campaign to which the ad group belongs.

cpc_bid_micros: i64

The maximum CPC (cost-per-click) bid.

effective_cpc_bid_micros: i64

Output only. Value will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null.

cpm_bid_micros: i64

The maximum CPM (cost-per-thousand viewable impressions) bid.

target_cpa_micros: i64

The target CPA (cost-per-acquisition). If the ad group’s campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign’s bidding strategy. Otherwise, this value is ignored.

cpv_bid_micros: i64

The CPV (cost-per-view) bid.

target_cpm_micros: i64

Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.

target_roas: f64

The target ROAS (return-on-ad-spend) override. If the ad group’s campaign bidding strategy is TargetRoas or MaximizeConversionValue (with its target_roas field set), then this field overrides the target ROAS specified in the campaign’s bidding strategy. Otherwise, this value is ignored.

percent_cpc_bid_micros: i64

The percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction].

fixed_cpm_micros: i64

The fixed amount in micros that the advertiser pays for every thousand impressions of the ad.

target_cpv_micros: i64

Average amount in micros that the advertiser is willing to pay for every ad view.

optimized_targeting_enabled: bool

True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion.

exclude_demographic_expansion: bool

When this value is true, demographics will be excluded from the types of targeting which are expanded when optimized_targeting_enabled is true. When optimized_targeting_enabled is false, this field is ignored. Default is false.

display_custom_bid_dimension: i32

Allows advertisers to specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search.

final_url_suffix: String

URL template for appending params to Final URL.

targeting_setting: Option<TargetingSetting>

Setting for targeting related features.

audience_setting: Option<AudienceSetting>

Immutable. Setting for audience related features.

effective_target_cpa_micros: i64

Output only. The effective target CPA (cost-per-acquisition). This field is read-only.

effective_target_cpa_source: i32

Output only. Source of the effective target CPA. This field is read-only.

effective_target_roas: f64

Output only. The effective target ROAS (return-on-ad-spend). This field is read-only.

effective_target_roas_source: i32

Output only. Source of the effective target ROAS. This field is read-only.

labels: Vec<String>

Output only. The resource names of labels attached to this ad group.

excluded_parent_asset_field_types: Vec<i32>

The asset field types that should be excluded from this ad group. Asset links with these field types will not be inherited by this ad group from the upper levels.

excluded_parent_asset_set_types: Vec<i32>

The asset set types that should be excluded from this ad group. Asset set links with these types will not be inherited by this ad group from the upper levels. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this ad group, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this ad group. Only LOCATION_SYNC is currently supported.

primary_status: i32

Output only. Provides aggregated view into why an ad group is not serving or not serving optimally.

primary_status_reasons: Vec<i32>

Output only. Provides reasons for why an ad group is not serving or not serving optimally.

Implementations

impl AdGroup

pub fn status(&self) -> AdGroupStatus

Returns the enum value of status, or the default if the field is set to an invalid enum value.

pub fn set_status(&mut self, value: AdGroupStatus)

Sets status to the provided enum value.

pub fn type(&self) -> AdGroupType

Returns the enum value of type, or the default if the field is set to an invalid enum value.

pub fn set_type(&mut self, value: AdGroupType)

Sets type to the provided enum value.

pub fn ad_rotation_mode(&self) -> AdGroupAdRotationMode

Returns the enum value of ad_rotation_mode, or the default if the field is set to an invalid enum value.

pub fn set_ad_rotation_mode(&mut self, value: AdGroupAdRotationMode)

Sets ad_rotation_mode to the provided enum value.

pub fn display_custom_bid_dimension(&self) -> TargetingDimension

Returns the enum value of display_custom_bid_dimension, or the default if the field is set to an invalid enum value.

pub fn set_display_custom_bid_dimension(&mut self, value: TargetingDimension)

Sets display_custom_bid_dimension to the provided enum value.

pub fn effective_target_cpa_source(&self) -> BiddingSource

Returns the enum value of effective_target_cpa_source, or the default if the field is set to an invalid enum value.

pub fn set_effective_target_cpa_source(&mut self, value: BiddingSource)

Sets effective_target_cpa_source to the provided enum value.

pub fn effective_target_roas_source(&self) -> BiddingSource

Returns the enum value of effective_target_roas_source, or the default if the field is set to an invalid enum value.

pub fn set_effective_target_roas_source(&mut self, value: BiddingSource)

Sets effective_target_roas_source to the provided enum value.

pub fn excluded_parent_asset_field_types( &self, ) -> FilterMap<Cloned<Iter<'_, i32>>, fn(_: i32) -> Option<AssetFieldType>>

Returns an iterator which yields the valid enum values contained in excluded_parent_asset_field_types.

pub fn push_excluded_parent_asset_field_types(&mut self, value: AssetFieldType)

Appends the provided enum value to excluded_parent_asset_field_types.

pub fn excluded_parent_asset_set_types( &self, ) -> FilterMap<Cloned<Iter<'_, i32>>, fn(_: i32) -> Option<AssetSetType>>

Returns an iterator which yields the valid enum values contained in excluded_parent_asset_set_types.

pub fn push_excluded_parent_asset_set_types(&mut self, value: AssetSetType)

Appends the provided enum value to excluded_parent_asset_set_types.

pub fn primary_status(&self) -> AdGroupPrimaryStatus

Returns the enum value of primary_status, or the default if the field is set to an invalid enum value.

pub fn set_primary_status(&mut self, value: AdGroupPrimaryStatus)

Sets primary_status to the provided enum value.

pub fn primary_status_reasons( &self, ) -> FilterMap<Cloned<Iter<'_, i32>>, fn(_: i32) -> Option<AdGroupPrimaryStatusReason>>

Returns an iterator which yields the valid enum values contained in primary_status_reasons.

pub fn push_primary_status_reasons(&mut self, value: AdGroupPrimaryStatusReason)

Appends the provided enum value to primary_status_reasons.

Trait Implementations

impl Clone for AdGroup

fn clone(&self) -> AdGroup

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AdGroup

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AdGroup

fn default() -> Self

Returns the “default value” for a type.

impl Message for AdGroup

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode<B>(&self, buf: &mut B) -> Result<(), EncodeError>

where B: BufMut, Self: Sized,

Encodes the message to a buffer.

fn encode_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited<B>(&self, buf: &mut B) -> Result<(), EncodeError>

where B: BufMut, Self: Sized,

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode<B>(buf: B) -> Result<Self, DecodeError>

where B: Buf, Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited<B>(buf: B) -> Result<Self, DecodeError>

where B: Buf, Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge<B>(&mut self, buf: B) -> Result<(), DecodeError>

where B: Buf, Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited<B>(&mut self, buf: B) -> Result<(), DecodeError>

where B: Buf, Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq for AdGroup

fn eq(&self, other: &AdGroup) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for AdGroup