bidding_seasonality_adjustment
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition Represents a bidding seasonality adjustment. Cannot be used in manager
accounts.
See "About seasonality adjustments" at
https://support.google.com/google-ads/answer/10369906 .
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 description The 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.
Category ATTRIBUTEData Type
ENUM
DEMAND_GEN
DISPLAY
HOTEL
LOCAL
LOCAL_SERVICES
MULTI_CHANNEL
PERFORMANCE_MAX
SEARCH
SHOPPING
SMART
TRAVEL
UNKNOWN
UNSPECIFIED
VIDEO
Type URL google.ads.googleads.v23.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType Filterable True Selectable True Sortable False Repeated True Selectable with
The following fields/resources can be selected with this field:
bidding_seasonality_adjustment.campaigns
Field description The 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.
Category ATTRIBUTEData Type RESOURCE_NAMEType URL N/AFilterable True Selectable True Sortable False Repeated True Selectable with
The following fields/resources can be selected with this field:
bidding_seasonality_adjustment.conversion_rate_modifier
Field description Conversion 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.
Category ATTRIBUTEData Type DOUBLEType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
bidding_seasonality_adjustment.description
Field description The description of the seasonality adjustment. The description can be at
most 2048 characters.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
bidding_seasonality_adjustment.devices
Field description If not specified, all devices will be included in this adjustment.
Otherwise, only the specified targeted devices will be included in this
adjustment.
Category ATTRIBUTEData Type
ENUM
CONNECTED_TV
DESKTOP
MOBILE
OTHER
TABLET
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v23.enums.DeviceEnum.Device Filterable True Selectable True Sortable False Repeated True Selectable with
The following fields/resources can be selected with this field:
bidding_seasonality_adjustment.end_date_time
Field description Required. 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].
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
bidding_seasonality_adjustment.name
Field description The name of the seasonality adjustment. The name can be at most 255
characters.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
bidding_seasonality_adjustment.resource_name
Field description Immutable. The resource name of the seasonality adjustment.
Seasonality adjustment resource names have the form:
customers/{customer_id}/biddingSeasonalityAdjustments/{seasonality_adjustment_id}
Category ATTRIBUTEData Type RESOURCE_NAMEType URL N/AFilterable True Selectable True Sortable False Repeated False Selectable with
The following fields/resources can be selected with this field:
bidding_seasonality_adjustment.scope
Field description The scope of the seasonality adjustment.
Category ATTRIBUTEData Type
ENUM
CAMPAIGN
CHANNEL
CUSTOMER
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v23.enums.SeasonalityEventScopeEnum.SeasonalityEventScope Filterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
bidding_seasonality_adjustment.seasonality_adjustment_id
Field description Output only. The ID of the seasonality adjustment.
Category ATTRIBUTEData Type INT64Type URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
bidding_seasonality_adjustment.start_date_time
Field description Required. 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.
Category ATTRIBUTEData Type STRINGType URL N/AFilterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
bidding_seasonality_adjustment.status
Field description Output only. The status of the seasonality adjustment.
Category ATTRIBUTEData Type
ENUM
ENABLED
REMOVED
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v23.enums.SeasonalityEventStatusEnum.SeasonalityEventStatus Filterable True Selectable True Sortable True Repeated False Selectable with
The following fields/resources can be selected with this field:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-10-14 UTC.
[null,null,["Last updated 2026-10-14 UTC."],[],[]]
