bidding_seasonality_adjustment

Page Summary

• Bidding seasonality adjustments represent anticipated changes in conversion rates for specific events.

• These adjustments cannot be used in manager accounts.

• You can apply adjustments to all campaigns under specified advertising channel types or to a list of up to 2000 campaigns.

• Seasonality adjustments must have a start and end time within a 14-day window.

• The adjustment uses a conversion rate modifier between 0.1 and 10.0, where 1.0 indicates no adjustment.

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.

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 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 ATTRIBUTE Data 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.v21.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType Filterable True Selectable True Sortable False Repeated True

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 ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated True

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 ATTRIBUTE Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

bidding_seasonality_adjustment.description Field description The description of the seasonality adjustment. The description can be at most 2048 characters. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

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 ATTRIBUTE Data Type ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v21.enums.DeviceEnum.Device Filterable True Selectable True Sortable False Repeated True

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 ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

bidding_seasonality_adjustment.name Field description The name of the seasonality adjustment. The name can be at most 255 characters. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

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 ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

bidding_seasonality_adjustment.scope Field description The scope of the seasonality adjustment. Category ATTRIBUTE Data Type ENUM CAMPAIGN CHANNEL CUSTOMER UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v21.enums.SeasonalityEventScopeEnum.SeasonalityEventScope Filterable True Selectable True Sortable True Repeated False

bidding_seasonality_adjustment.seasonality_adjustment_id Field description Output only. The ID of the seasonality adjustment. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

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 ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

bidding_seasonality_adjustment.status Field description Output only. The status of the seasonality adjustment. Category ATTRIBUTE Data Type ENUM ENABLED REMOVED UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v21.enums.SeasonalityEventStatusEnum.SeasonalityEventStatus Filterable True Selectable True Sortable True Repeated False