LogoAdExtension Data Object - Campaign Management

Article
07/15/2024

Defines an ad extension that specifies a business logo.

Logo Ad Extensions enable advertisers to display eye-catching logos in ads. Build brand recognition to drive more clicks and conversions on your website.

Syntax

<xs:complexType name="LogoAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="BusinessLogo" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="BusinessLogoUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DomainName" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

The LogoAdExtension object has the following elements: BusinessLogo, BusinessLogoUrl, BusinessName, DomainName.

Element	Description	Data Type
BusinessLogo	The asset ID for the business logo. The business logo must have a 1:1 aspect ratio. The minimum image size is 128px by 128px. The maximum image size is 5120 KB. Add: Required Update: Required	long
BusinessLogoUrl	The URL of the business logo. This is used internally. Add: Not allowed Update: Not allowed	string
BusinessName	The business name. Maximum length is 25 characters. Add: Required Update: Required	string
DomainName	The domain name. Note: Use the domain name, not a URL. For example, use "contoso.com", not "https://contoso.com". The maximum length is 50 characters. Add: Optional Update: Optional	string

The LogoAdExtension object has Inherited Elements.

Inherited Elements

Inherited Elements from AdExtension

The LogoAdExtension object derives from the AdExtension object, and inherits the following elements: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. The descriptions below are specific to LogoAdExtension, and might not apply to other objects that inherit the same elements from the AdExtension object.

Element	Description	Data Type
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. Forward compatibility changes will be noted here in future releases. There are currently no forward compatibility changes for this object.	KeyValuePairOfstringstring array
Id	The unique Microsoft Advertising identifier of the ad extension.	long
Scheduling	Determines the calendar day and time ranges when the ad extension is eligible to be shown in ads.	Schedule
Status	The status of the ad extension. The value will always be Active because the Campaign Management service does not return deleted ad extensions.	AdExtensionStatus
Type	The type of ad extension. For more information, see Remarks.	string
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.	int

Requirements

Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Share via