Freigeben über

AppAdExtension-Datenobjekt – Kampagnenverwaltung

  • Artikel

Definiert eine App-Anzeigenerweiterung, die in eine Anzeige aufgenommen werden kann.

Sie können dem Konto oder Kampagnen und Anzeigengruppen im Konto eine App-Anzeigenerweiterung zuordnen. Jede Entität (Konto, Kampagne oder Anzeigengruppe) kann beliebig vielen App-Anzeigenerweiterungen bis zur Gesamtanzahl der App-Anzeigenerweiterungen in Ihrem Konto zugeordnet werden.

<xs:complexType name="AppAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="AppPlatform" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="AppStoreId" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q48="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q48:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q49="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q49:ArrayOfstring" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

Das AppAdExtension-Objekt verfügt über die folgenden Elemente: AppPlatform, AppStoreId, DestinationUrl, DisplayText, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Element Beschreibung Datentyp
AppPlatform Die Anwendungsplattform.

Mögliche Werte sind iOS, Android und Windows.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich		 Zeichenfolge
AppStoreId Der vom App Store bereitgestellte Anwendungsbezeichner.

Wenn die Anwendung neu ist, warten Sie 4 bis 7 Tage, bevor die Anzeige für die Zustellung berechtigt ist.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich		 Zeichenfolge
DestinationUrl Die URL der App Store-Downloadwebseite, auf die Benutzer weitergeleitet werden, wenn sie auf den App-Erweiterungslink klicken.

Die URL kann dynamische Textzeichenfolgen wie {Schlüsselwort (keyword)} enthalten. Eine Liste der unterstützten Parameter finden Sie im Abschnitt Verfügbare Parameter im Microsoft Advertising-Hilfeartikel Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?.

Die URL darf maximal 1.024 Zeichen enthalten. Wenn die URL kein Protokoll angibt, verwendet das System das HTTP-Protokoll, wenn ein Benutzer auf die Anzeige klickt. Wenn die URL das HTTP-Protokoll angibt, wenn Sie eine Anzeige hinzufügen, entfernt der Dienst die http:// Protokollzeichenfolge (die HTTP-Protokollzeichenfolge zählt nicht auf den Grenzwert von 1.024 Zeichen); Der Dienst entfernt jedoch keine HTTPS-Protokollzeichenfolge (https://) aus der URL.

Hinzufügen: Erforderlich
Aktualisieren: Wahlfrei		 Zeichenfolge
DisplayText Der in der App-Anzeigenerweiterung angezeigte Text. Der Text darf maximal 35 Zeichen enthalten.

Hinzufügen: Erforderlich
Aktualisieren: Wahlfrei		 Zeichenfolge
FinalAppUrls Zur zukünftigen Verwendung. AppUrl-Array
FinalMobileUrls Reserviert für zukünftige Verwendung. Zeichenfolgenarray
FinalUrls Reserviert für zukünftige Verwendung. Zeichenfolgenarray
FinalUrlSuffix Reserviert für zukünftige Verwendung. Zeichenfolge
TrackingUrlTemplate Reserviert für zukünftige Verwendung. Zeichenfolge
UrlCustomParameters Reserviert für zukünftige Verwendung. CustomParameters

Das AppAdExtension-Objekt verfügt über geerbte Elemente.

Geerbte Elemente

Geerbte Elemente von AdExtension

Das AppAdExtension-Objekt wird vom AdExtension-Objekt abgeleitet und erbt die folgenden Elemente: DevicePreference, ForwardCompatibilityMap, ID, Scheduling, Status, Type, Version. Die folgenden Beschreibungen gelten spezifisch für AppAdExtension und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom AdExtension-Objekt erben .

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.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 lang
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.

Es gibt derzeit keine Änderungen an der Vorwärtskompatibilität für das AdExtension-Objekt .

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 KeyValuePairOfstring-Array
Id Der eindeutige Microsoft Advertising-Bezeichner der Anzeigenerweiterung.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt und erforderlich		 lang
Zeitplanung Bestimmt den Kalendertag und die Zeitbereiche, in dem die Anzeigenerweiterung in Anzeigen angezeigt werden kann.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn Sie dieses Element null festlegen, bleiben alle vorhandenen Zeitplanungssätze für die Anzeigenerweiterung unverändert. Wenn Sie dieses Objekt auf ein Schedule-Objekt ungleich NULL festlegen, ersetzen Sie effektiv vorhandene Planungseinstellungen für die Anzeigenerweiterung. Um alle Zeitplanungen zu entfernen, legen Sie dieses Element auf ein leeres Schedule-Objekt fest.		 Schedule
Status Der status der Anzeigenerweiterung. Der Wert ist immer Aktiv , da der Kampagnenverwaltungsdienst keine gelöschten Anzeigenerweiterungen zurückgibt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 AdExtensionStatus
Typ Der Typ der Anzeigenerweiterung. Dieser Wert ist AppAdExtension , wenn Sie eine App-Anzeigenerweiterung abrufen.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt

Weitere Informationen zu Anzeigenerweiterungstypen finden Sie in den Hinweisen zu Ad Extension Data Object.		 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.

Hinzufügen: Unstatthaft
Aktualisieren: Unstatthaft		 int

Anforderungen

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