Freigeben über

HotelAd-Datenobjekt – Kampagnenverwaltung

Definiert eine Hotelanzeige. Hotelanzeigen werden angezeigt, wenn ein Reisender auf der Suche nach einem Hotel oder karten sucht.

Syntax

<xs:complexType name="HotelAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence />
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

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

Geerbte Elemente

Geerbte Elemente von Ad

Das HotelAd-Objekt wird vom Ad-Objekt abgeleitet und erbt die folgenden Elemente: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Die folgenden Beschreibungen sind spezifisch für HotelAd und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom Ad-Objekt erben.

Element Beschreibung Datentyp
AdFormatPreference Wird für diesen Anzeigentyp nicht unterstützt. Zeichenfolge
DevicePreference Wird für diesen Anzeigentyp nicht unterstützt. lang
EditorialStatus Wird für diesen Anzeigentyp nicht unterstützt. AdEditorialStatus
FinalAppUrls Wird für diesen Anzeigentyp nicht unterstützt. AppUrl-Array
FinalMobileUrls Wird für diesen Anzeigentyp nicht unterstützt. Zeichenfolgenarray
FinalUrls Wird für diesen Anzeigentyp nicht unterstützt. Zeichenfolgenarray
FinalUrlSuffix Das endgültige URL-Suffix kann Nachverfolgungsparameter enthalten, die an das Ende ihrer Landing Page-URL angefügt werden. Es wird empfohlen, die für Ihre Landing Page benötigten Nachverfolgungsparameter in einem endgültigen URL-Suffix zu platzieren, damit Ihre Kunden immer an Ihre Landing Page gesendet werden. Weitere Informationen und Validierungsregeln finden Sie unter Endgültiges URL-Suffix in den technischen Leitfäden.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.		 Zeichenfolge
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 ForwardCompatibilityMap-Schlüssel- und Wertpaare, die für Hotelanzeigen gelten.		 KeyValuePairOfstring-Array
Id Der eindeutige Microsoft Advertising-Bezeichner für die Anzeige.

Hinzufügen: Schreibgeschützt
Aktualisieren: Erforderlich und schreibgeschützt		 lang
Status Die status der Anzeige.

Sie können die Anzeige status auf Aktiv oder Angehalten festlegen.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei		 AdStatus
TrackingUrlTemplate Die Nachverfolgungsvorlage, die als Standard für alle Landing Page-URLs verwendet werden soll.

Die folgenden Validierungsregeln gelten für Nachverfolgungsvorlagen. Weitere Informationen zu unterstützten Vorlagen und Parametern finden Sie im Microsoft Advertising-Hilfeartikel Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?
- Nachverfolgungsvorlagen, die für Entitäten auf niedrigerer Ebene definiert sind, z. B. Anzeigen, überschreiben diejenigen, die für Entitäten höherer Ebene festgelegt wurden, z. B. Kampagnen. Weitere Informationen finden Sie unter Entitätsgrenzwerte.
– Die Länge der Nachverfolgungsvorlage ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet.
– Die Nachverfolgungsvorlage muss eine wohlgeformte URL sein, die mit einer der folgenden Beginnt: http://, https://, {lpurl} oder {unescapedlpurl}.
– Microsoft Advertising überprüft nicht, ob benutzerdefinierte Parameter vorhanden sind. Wenn Sie benutzerdefinierte Parameter in Ihrer Nachverfolgungsvorlage verwenden und diese nicht vorhanden sind, enthält die URL der Angebotsseite die Schlüssel- und Wertplatzhalter Ihrer benutzerdefinierten Parameter ohne Ersetzung. Wenn Ihre Nachverfolgungsvorlage beispielsweise lautet https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} und weder {_season} noch {_promocode} auf Kampagnen-, Anzeigengruppen-, Kriterium-, Schlüsselwort (keyword)- oder Anzeigenebene definiert sind, ist die URL der Landing Page identisch.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.		 Zeichenfolge
Typ Der Typ der Anzeige. Dieser Wert ist Hotel , wenn Sie eine Hotelanzeige abrufen. Weitere Informationen zu Anzeigentypen finden Sie in den Hinweisen zu Ad Data Object.For more information about ad types, see the Ad Data Object Remarks.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 AdType
UrlCustomParameters Ihre benutzerdefinierte Sammlung von Schlüssel- und Wertparametern für die URL-Nachverfolgung.

Microsoft Advertising akzeptiert die ersten 8 CustomParameter-Objekte , die Sie in das CustomParameters-Objekt einschließen, und wenn Sie mehr als 8 benutzerdefinierte Parameter einschließen, wird ein Fehler zurückgegeben. Jeder CustomParameter enthält Key - und Value-Elemente .

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Legen Sie das UrlCustomParameters-Element auf NULL oder leer fest, um alle vorhandenen benutzerdefinierten Parameter beizubehalten. Um alle benutzerdefinierten Parameter zu entfernen, legen Sie das Parameters-Element des CustomParameters-Objekts auf NULL oder leer fest. Um eine Teilmenge benutzerdefinierter Parameter zu entfernen, geben Sie die benutzerdefinierten Parameter an, die Sie im Parameters-Element des CustomParameters-Objekts beibehalten möchten.		 CustomParameters

Anforderungen

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