DayTimeCriterion Data Object - Campaign Management

Defines a criterion that can be used to show ads to users during a specific day and time range.

The DayTimeCriterion criterion can be included within BiddableAdGroupCriterion andBiddableCampaignCriterion objects. If ad group level day and time criterions are specified, the campaign level day and time criterions are ignored for that ad group. In other words the ad group day and time criterions override the campaign day and time criterions, and are not applied as a union.

Note

You cannot modify the Day, FromHour, FromMinute, ToHour, or ToMinute values for an existing criterion. To modify the day and time ranges, you must delete the criterion and add a new criterion.

Syntax

<xs:complexType name="DayTimeCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Criterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="Day" nillable="true" type="tns:Day" />
        <xs:element minOccurs="0" name="FromHour" nillable="true" type="xs:int" />
        <xs:element minOccurs="0" name="FromMinute" nillable="true" type="tns:Minute" />
        <xs:element minOccurs="0" name="ToHour" nillable="true" type="xs:int" />
        <xs:element minOccurs="0" name="ToMinute" nillable="true" type="tns:Minute" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

The DayTimeCriterion object has the following elements: Day, FromHour, FromMinute, ToHour, ToMinute.

Element Description Data Type
Day The day of the week to target. For example, you can target the ads to run only on Friday or Saturday.

Add: Required
Update: Not allowed. If you specify this element it must match the existing setting.
Day
FromHour The starting hour range to target.

The possible values range from 0 to 23.

Add: Required
Update: Not allowed. If you specify this element it must match the existing setting.
int
FromMinute The starting minute of the hour to target.

Add: Required
Update: Not allowed. If you specify this element it must match the existing setting.
Minute
ToHour The ending hour range to target.

Supported values range from 0 to 24. If the ToHour is set to 24, the ToMinute must be Zero.

Add: Required
Update: Not allowed. If you specify this element it must match the existing setting.
int
ToMinute The ending minute of the hour to target.

Add: Required
Update: Not allowed. If you specify this element it must match the existing setting.
Minute

The DayTimeCriterion object has Inherited Elements.

Inherited Elements

Inherited Elements from Criterion

The DayTimeCriterion object derives from the Criterion object, and inherits the following elements: Type. The descriptions below are specific to DayTimeCriterion, and might not apply to other objects that inherit the same elements from the Criterion object.

Element Description Data Type
Type The type of the criterion. This value is DayTime when you retrieve a day and time criterion. For more information about criterion types, see the Criterion Data Object Remarks.

Add: Read-only
Update: Read-only
string

Requirements

Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13