DeviceCriterion Data Object - Campaign Management

Article
07/25/2023

Defines a criterion that can be used to show ads on specific devices.

When you target by device, you choose to show ads to potential customers when they're using desktops and tablets or smartphones.

Each device criterion defines a device name for the accompanying criterion bid adjustment.

The maximum number of device criterions that you can specify per campaign or ad group is three. You must either have three separate criterions for Computers, Smartphones, and Tablets, otherwise no device criterions can exist for the campaign or ad group.

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

Note

For new Video campaigns, the device target is set automatically according to the Bidding strategy.

For CPM, the bidding adjustment for PC/Mobile/tablet is set to 0, and for CTV to 100.
For CPV, the bidding adjustment for PC/Mobile/tablet is set to -100, and for CTV to 0.

Syntax

<xs:complexType name="DeviceCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Criterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="DeviceName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="OSName" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

The DeviceCriterion object has the following elements: DeviceName, OSName.

Element	Description	Data Type
DeviceName	The name of the device to target. The following are the possible device names that you can specify. - Computers - Smartphones - Tablets Three separate bids for Computers, Tablets, and Smartphones should always be specified together. If you do not add individual device criterions representing each of the three device types, the missing device criterions will be added with the default bid adjustment of zero. Add: Required. Three separate criterions for Computers, Smartphones, and Tablets should be specified together in the same add criterions request. If you do not add individual device criterions representing each of the three device types, no device criterions will be added to the campaign or ad group. Update: Not allowed. If you specify this element it must match the existing setting.	string
OSName	Reserved for internal use. If you specify this element the add and update operations will not fail, but the OS names will not be set. When you retrieve this object, the OSName element will be nil. Add: Not allowed. Update: Not allowed.	string

The DeviceCriterion object has Inherited Elements.

Inherited Elements

Inherited Elements from Criterion

The DeviceCriterion object derives from the Criterion object, and inherits the following elements: Type. The descriptions below are specific to DeviceCriterion, 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 Device when you retrieve a device 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

Share via