CalloutAdExtension Data Object - Campaign Management
Defines an object that specifies additional text about your business, products, or services to include in a text ad.
You can associate an app ad extension with the account or with campaigns and ad groups in the account. You must associate between 2 and 20 callout ad extensions per entity (account, campaign, or ad group). If you associate one or fewer callout extensions with your account, campaign, or ad group, then no callout text will serve with your ad. An ad may include between 2 to 4 callouts per impression.
Ad extensions that are associated at the ad group level will override ad extensions of the same type that are associated at the campaign level. For example if you have 2 callout extensions set for Campaign A, zero callout extensions associated with Ad Group AA, and one callout extension associated with Ad Group AB, then only Ad Group AA is eligible to have its text ads decorated with callouts.
<xs:complexType name="CalloutAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:complexContent mixed="false"> <xs:extension base="tns:AdExtension"> <xs:sequence> <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" /> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType>
Inherited Elements from AdExtension
The CalloutAdExtension object derives from the AdExtension object, and inherits the following elements: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. The descriptions below are specific to CalloutAdExtension, and might not apply to other objects that inherit the same elements from the AdExtension object.
|DevicePreference||Not supported for this ad extension type.||long|
|ForwardCompatibilityMap||The list of key and value strings for forward compatibility to avoid otherwise breaking changes when new elements are added in the current API version.
There are currently no forward compatibility changes for the AdExtension object.
|Id||The unique Microsoft Advertising identifier of the ad extension.
Update: Read-only and Required
|Scheduling||Determines the calendar day and time ranges when the ad extension is eligible to be shown in ads.
Update: Optional. If you set this element null, any existing scheduling set for the ad extension will remain unchanged. If you set this to any non-null Schedule object, you are effectively replacing existing scheduling settings for the ad extension. To remove all scheduling set this element to an empty Schedule object.
|Status||The status of the ad extension. The value will always be Active because the Campaign Management service does not return deleted ad extensions.
|Type||The type of the ad extension. This value is CalloutAdExtension when you retrieve a callout ad extension.
For more information about ad extension types, see the Ad Extension Data Object Remarks.
|Version||Tracks the number of times the ad extension has been updated.
The version is set to 1 when the ad extension is created, and increments by one after each update.
Add: Not allowed
Update: Not allowed
Service: CampaignManagementService.svc v13