Share your feedback about the Google Ads (AdWords) API. Take the 2021 AdWords API and Google Ads API Annual Survey.

bidding_seasonality_adjustment

Represents a bidding seasonality adjustment. See "About seasonality adjustments" at https://support.google.com/google-ads/answer/10369906.

Attributed resources
customer

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

bidding_seasonality_adjustment.advertising_channel_types

Field descriptionThe seasonality adjustment will apply to all the campaigns under the listed channels retroactively as well as going forward when the scope of this adjustment is CHANNEL. The supported advertising channel types are DISPLAY, SEARCH and SHOPPING. Note: a seasonality adjustment with both advertising_channel_types and campaign_ids is not supported.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

bidding_seasonality_adjustment.campaigns

Field descriptionThe seasonality adjustment will apply to the campaigns listed when the scope of this adjustment is CAMPAIGN. The maximum number of campaigns per event is 2000. Note: a seasonality adjustment with both advertising_channel_types and campaign_ids is not supported.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

bidding_seasonality_adjustment.conversion_rate_modifier

Field descriptionConversion rate modifier estimated based on expected conversion rate changes. When this field is unset or set to 1.0 no adjustment will be applied to traffic. The allowed range is 0.1 to 10.0.
CategoryATTRIBUTE
Data TypeDOUBLE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_seasonality_adjustment.description

Field descriptionThe description of the seasonality adjustment. The description can be at most 2048 characters.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_seasonality_adjustment.devices

Field descriptionIf not specified, all devices will be included in this adjustment. Otherwise, only the specified targeted devices will be included in this adjustment.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.DeviceEnum.Device
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

bidding_seasonality_adjustment.end_date_time

Field descriptionRequired. The exclusive end time of the seasonality adjustment in yyyy-MM-dd HH:mm:ss format. The length of [start_date_time, end_date_time) interval must be within (0, 14 days].
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_seasonality_adjustment.name

Field descriptionThe name of the seasonality adjustment. The name can be at most 255 characters.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_seasonality_adjustment.resource_name

Field descriptionImmutable. The resource name of the seasonality adjustment. Seasonality adjustment resource names have the form: `customers/{customer_id}/biddingSeasonalityAdjustments/{seasonality_adjustment_id}`
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

bidding_seasonality_adjustment.scope

Field descriptionThe scope of the seasonality adjustment.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.SeasonalityEventScopeEnum.SeasonalityEventScope
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_seasonality_adjustment.seasonality_adjustment_id

Field descriptionOutput only. The ID of the seasonality adjustment.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_seasonality_adjustment.start_date_time

Field descriptionRequired. The inclusive start time of the seasonality adjustment in yyyy-MM-dd HH:mm:ss format. A seasonality adjustment is forward looking and should be used for events that start and end in the future.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_seasonality_adjustment.status

Field descriptionOutput only. The status of the seasonality adjustment.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v8.enums.SeasonalityEventStatusEnum.SeasonalityEventStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse