bidding_data_exclusion

Represents a bidding data exclusion. Bidding data exclusions can be set in client accounts only, and cannot be used in manager accounts. See "About data exclusions" at https://support.google.com/google-ads/answer/10370710. Note: A customer account can have a maximum of 500 active bidding data exclusions.

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_data_exclusion.advertising_channel_types

Field description

The data_exclusion will apply to all the campaigns under the listed channels retroactively as well as going forward when the scope of this exclusion is CHANNEL. The supported advertising channel types are DISPLAY, SEARCH and SHOPPING. Note: a data exclusion with both advertising_channel_types and campaign_ids is not supported.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

bidding_data_exclusion.campaigns

Field description

The data exclusion will apply to the campaigns listed when the scope of this exclusion is CAMPAIGN. The maximum number of campaigns per event is 2000. Note: a data exclusion with both advertising_channel_types and campaign_ids is not supported.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

bidding_data_exclusion.data_exclusion_id

Field description

Output only. The ID of the data exclusion.

CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_data_exclusion.description

Field description

The description of the data exclusion. The description can be at most 2048 characters.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_data_exclusion.devices

Field description

If not specified, all devices will be included in this exclusion. Otherwise, only the specified targeted devices will be included in this exclusion.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.DeviceEnum.Device
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue

bidding_data_exclusion.end_date_time

Field description

Required. The exclusive end time of the data exclusion 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_data_exclusion.name

Field description

The name of the data exclusion. The name can be at most 255 characters.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_data_exclusion.resource_name

Field description

Immutable. The resource name of the data exclusion. Data exclusion resource names have the form: customers/{customer_id}/biddingDataExclusions/{data_exclusion_id}

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

bidding_data_exclusion.scope

Field description

The scope of the data exclusion.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.SeasonalityEventScopeEnum.SeasonalityEventScope
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_data_exclusion.start_date_time

Field description

Required. The inclusive start time of the data exclusion in yyyy-MM-dd HH:mm:ss format. A data exclusion is backward looking and should be used for events that start in the past and end either in the past or future.

CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

bidding_data_exclusion.status

Field description

Output only. The status of the data exclusion.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v24.enums.SeasonalityEventStatusEnum.SeasonalityEventStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse