Export (0) Print
Expand All
Ad
Bid
Expand Minimize

CallAdExtension Data Object

Defines an object that specifies a click-to-call phone number to include in a text ad.

You can associate a call ad extension with one or more campaigns; however, a campaign can be associated with only one call ad extension.

The CallAdExtension object derives from the AdExtension object. For a list of inherited elements, see the AdExtension object.

<xs:complexType name="CallAdExtension">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element name="CountryCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
        <xs:element name="IsCallOnly" type="xs:boolean" />
        <xs:element minOccurs="0" name="IsCallTrackingEnabled" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="RequireTollFreeTrackingNumber" nillable="true" type="xs:boolean" /> 
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

Element

Description

Data Type

Add

Update

CountryCode

The country code where the phone number is registered. The country code must contain a 2 character country code. For a list of country code values, see Geographical Location Codes.

string

Required

Optional

DevicePreference

System_CLiX_noteNote

Reserved for future use.

This element determines whether the preference is for the click to call phone number to be displayed on mobile devices or all devices.

long

Not applicable

Not applicable

IsCallOnly

A Boolean value that determines whether the phone number is the only clickable item in the ad. If true and the ad is displayed on a hi-fi mobile device, all otherwise clickable items such as addresses, the display URL, and site links will be disabled.

boolean

Optional

Optional

IsCallTrackingEnabled

A Boolean value that determines whether call tracking is enabled for the call ad extension.

System_CLiX_noteNote

Call tracking is only supported in the United States and United Kingdom.

To enable call tracking, set this element to true. To disable call tracking, set this element to false.

If this element is nil or not specified, the default value is False.

boolean

Optional

Optional

PhoneNumber

The phone number to include in the ad. The phone number is clickable on hi-fi mobile devices.

The phone number can contain a maximum of 35 characters and must be valid for the specified country.

If the campaign includes call and location ad extensions, this phone number will override the phone number specified in the location ad extensions.

Note that the phone number may be reformatted. For example, if you set phone number to 4255551212, it will be reformatted to (425) 555-1212.

string

Required

Optional

RequireTollFreeTrackingNumber

A Boolean value that determines whether a toll-free tracking number should be created for call tracking. This element can only be set if IsCallTrackingEnabled is also true.

To create a toll-free number, set this element to true. To inactivate an existing toll-free number, set this element to false.

If this element is nil or not specified, the default value is False.

System_CLiX_noteNote

Each time the flag is set from false to true, a new toll-free number is provisioned.

boolean

Optional

Optional

Requirements

CampaignManagementService.svc v9

Namespace: https://bingads.microsoft.com/CampaignManagement/v9

Community Additions

ADD
Show:
© 2014 Microsoft