bidding_seasonality_adjustment

Help me build a query Proto definition on GitHub

Represents a bidding seasonality adjustment. Cannot be used in manager accounts.

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

Attributed resources
customer

Fields from the preceding resources can be selected along with this resource in your SELECT and WHERE clauses. These fields do 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.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v26.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType
CapabilitiesSelectable: True
Filterable: True
Sortable: False
Repeated: True
Selectable with

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.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
CapabilitiesSelectable: True
Filterable: True
Sortable: False
Repeated: True
Selectable with

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.

CategoryATTRIBUTE
Data TypeDOUBLE
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

bidding_seasonality_adjustment.description

Field description

The description of the seasonality adjustment. The description can be at most 2048 characters.

CategoryATTRIBUTE
Data TypeSTRING
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

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.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v26.enums.DeviceEnum.Device
CapabilitiesSelectable: True
Filterable: True
Sortable: False
Repeated: True
Selectable with

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].

CategoryATTRIBUTE
Data TypeSTRING
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

bidding_seasonality_adjustment.name

Field description

The name of the seasonality adjustment. The name can be at most 255 characters.

CategoryATTRIBUTE
Data TypeSTRING
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

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}

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
CapabilitiesSelectable: True
Filterable: True
Sortable: False
Repeated: False
Selectable with

bidding_seasonality_adjustment.scope

Field description

The scope of the seasonality adjustment.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v26.enums.SeasonalityEventScopeEnum.SeasonalityEventScope
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

bidding_seasonality_adjustment.seasonality_adjustment_id

Field description

Output only. The ID of the seasonality adjustment.

CategoryATTRIBUTE
Data TypeINT64
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

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.

CategoryATTRIBUTE
Data TypeSTRING
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

bidding_seasonality_adjustment.status

Field description

Output only. The status of the seasonality adjustment.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v26.enums.SeasonalityEventStatusEnum.SeasonalityEventStatus
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with