Export (0) Print
Expand All
Ad
Bid
Expand Minimize

ImageAdExtension Data Object

System_CLiX_note Note

Currently this feature is only available for pilot participants. For more information, see GetCustomerPilotFeatures Service Operation.

Defines an ad extension that specifies an image with alternative text to include in a text ad.

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

<xs:complexType name="ImageAdExtension">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element type="xs:string" name="AlternativeText" nillable="true"/>
        <xs:element type="xs:string" name="Description" nillable="true" minOccurs="0"/>
        <xs:element type="xs:string" name="DestinationUrl" nillable="true" minOccurs="0"/>
        <xs:element type="xs:long" name="ImageMediaId"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

Element

Description

Data Type

Add

Update

AlternativeText

Alternative description of the image media for usability. If the image could not be displayed, the alternative text is used instead.

The maximum length for this element is 35 characters.

string

Optional

Optional

Description

Description that can be used by the advertiser, agency, or account manager to track, label, or manage image media. This description is not displayed with the ad or image.

The maximum length for this element is 100 characters.

string

Optional

Optional

DestinationUrl

The URL of the webpage to take the user to when they click the image.

If not specified for an image, the destination URL of the TextAd is used.

System_CLiX_noteNote

The URL can contain a maximum of 1,024 characters. If the URL specifies the HTTP protocol when you add an ad, the service will remove the http:// protocol string (the HTTP protocol string does not count against the 1,024 character limit); however, the service will not remove an HTTPS protocol string (https://) from the URL.

If the URL does not specify a protocol, the system uses the HTTP protocol when a user clicks the ad.

string

Optional

Optional

ImageMediaId

The identifier of the image to include in the ad. You must specify the identifier of the image that you added to the image library by calling the AddMedia operation.

You can get the media identifiers for image ad extensions with the GetMediaMetaDataByAccountId operation.

string

Required

Read-only and Required

Requirements

CampaignManagementService.svc v9

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

Community Additions

ADD
Show:
© 2015 Microsoft