AdExtension-Datenobjekt – Kampagnenverwaltung

Artikel
11/13/2024

Definiert das Basisobjekt einer Anzeigenerweiterung.

Versuchen Sie nicht, eine AdExtension zu instanziieren. Sie können eines oder mehrere der folgenden Objekte erstellen, die daraus abgeleitet werden.

Syntax

<xs:complexType name="AdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
    <xs:element xmlns:q43="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q43:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Scheduling" nillable="true" type="tns:Schedule" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdExtensionStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Version" nillable="true" type="xs:int" />
  </xs:sequence>
</xs:complexType>

Elemente

Das AdExtension-Objekt weist die folgenden Elemente auf: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version.

Element	Beschreibung	Datentyp
DevicePreference	Dieses Element bestimmt, ob die Anzeigeerweiterung auf mobilen Oder allen Geräten angezeigt werden soll. Um eine Einstellung für mobile Geräte anzugeben, legen Sie dieses Element auf 30001 fest. Um alle Geräte anzugeben, legen Sie dieses Element auf 0 (null) fest, oder lassen Sie das Element null. Standardmäßig ist dieses Element null. Dieses Element gilt nur für die Typen AppAdExtension und SitelinkAdExtension .	Lange
ForwardCompatibilityMap	Die Liste der Schlüssel- und Wertzeichenfolgen für die Vorwärtskompatibilität, um andere Breaking Changes zu vermeiden, wenn neue Elemente in der aktuellen API-Version hinzugefügt werden. Änderungen an der Vorwärtskompatibilität werden in zukünftigen Versionen hier notiert. Es gibt derzeit keine Änderungen an der Vorwärtskompatibilität für dieses Objekt.	KeyValuePairOfstring-Array
Id	Der eindeutige Microsoft Advertising-Bezeichner der Anzeigenerweiterung.	Lange
Zeitplanung	Bestimmt den Kalendertag und die Zeitbereiche, in dem die Anzeigenerweiterung in Anzeigen angezeigt werden kann.	Schedule
Status	Der Status der Anzeigenerweiterung. Der Wert ist immer Aktiv , da der Kampagnenverwaltungsdienst keine gelöschten Anzeigenerweiterungen zurückgibt.	AdExtensionStatus
Typ	Der Typ der Anzeigenerweiterung. Weitere Informationen finden Sie unter Hinweise.	Zeichenfolge
Version	Verfolgt nach, wie oft die Anzeigenerweiterung aktualisiert wurde. Die Version wird beim Erstellen der Anzeigenerweiterung auf 1 festgelegt und nach jedem Update um eins erhöht.	int

Hinweise

Wenn Sie das SOAP manuell generieren, verwenden Sie das type-Attribut des <AdExtension> Knotens, wie im folgenden Beispiel gezeigt, um den Typ der Anzeigenerweiterung anzugeben.

<AdExtension i:type="ReviewAdExtension" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Id i:nil="true" />
    <Status i:nil="true" />
      . . .
</AdExtension>

Anforderungen

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

Verwendet von

AddAdExtensions
AdExtensionAssociation
GetAdExtensionsByIds
UpdateAdExtensions

Freigeben über