AppAdExtension-Datenobjekt – Kampagnenverwaltung

Artikel
10/17/2024

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.

Syntax

<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:q47="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q47:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q48="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q48: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
Art	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

Freigeben über