DeviceCriterion Data Object - Campaign Management

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 AdGroupCriterion and CampaignCriterion 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.

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

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. 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 v12
Namespace: https://bingads.microsoft.com/CampaignManagement/v12