HotelAd-Datenobjekt – Kampagnenverwaltung

Artikel
12/21/2023

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.	Lange
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: Optional Aktualisieren: Optional. 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	Lange
Status	Die status der Anzeige. Sie können die Anzeige status auf Aktiv oder Angehalten festlegen. Hinzufügen: Optional Aktualisieren: Optional	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: Optional Aktualisieren: Optional. 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: Optional Aktualisieren: Optional. 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

Freigeben über