Objeto de datos de HotelAd: administración de campañas

Define un anuncio de hotel. Los anuncios de hoteles aparecen cuando un viajero busca un hotel en la búsqueda o mapas.

XML

<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>

JSON

{}

Elementos

El objeto HotelAd tiene elementos heredados.

Elementos heredados

Elementos heredados de Ad

El objeto HotelAd deriva del objeto Ad y hereda los siguientes elementos: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Las descripciones siguientes son específicas de HotelAd y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto Ad .

Elemento	Descripción	Tipo de datos
AdFormatPreference	No se admite para este tipo de anuncio.	string
DevicePreference	No se admite para este tipo de anuncio.	largo
EditorialStatus	No se admite para este tipo de anuncio.	AdEditorialStatus
FinalAppUrls	No se admite para este tipo de anuncio.	Matriz AppUrl
FinalMobileUrls	No se admite para este tipo de anuncio.	matriz de cadenas
FinalUrls	No se admite para este tipo de anuncio.	matriz de cadenas
FinalUrlSuffix	El sufijo de dirección URL final puede incluir parámetros de seguimiento que se anexarán al final de la dirección URL de la página de aterrizaje. Se recomienda colocar los parámetros de seguimiento que requiere la página de aterrizaje en un sufijo de dirección URL final para que los clientes siempre se envíen a la página de aterrizaje. Para obtener más detalles y reglas de validación, consulte Sufijo de dirección URL final en las guías técnicas. Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este elemento en una cadena vacía (""), se eliminará la configuración anterior.	string
ForwardCompatibilityMap	Lista de cadenas de clave y valor para la compatibilidad con reenvíos para evitar cambios importantes en caso contrario cuando se agregan nuevos elementos en la versión actual de la API. Actualmente no hay pares de clave y valor forwardCompatibilityMap que sean aplicables a los anuncios de hoteles.	Matriz KeyValuePairOfstringstring
Identificación	Identificador único de Microsoft Advertising para el anuncio. Agregar: Solo lectura Actualizar: Obligatorio y de solo lectura	largo
Estado	Estado del anuncio. Puedes establecer el estado del anuncio en Activo o En pausa. Agregar: Opcional Actualizar: Opcional	AdStatus
TrackingUrlTemplate	Plantilla de seguimiento que se usará como valor predeterminado para todas las direcciones URL de página de aterrizaje. Las siguientes reglas de validación se aplican a las plantillas de seguimiento. Para obtener más información sobre las plantillas y los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar? - Las plantillas de seguimiento definidas para entidades de nivel inferior, por ejemplo, los anuncios, reemplazan a las establecidas para entidades de nivel superior, por ejemplo, campaña. Para obtener más información, vea Límites de entidad. - La longitud de la plantilla de seguimiento está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres. - La plantilla de seguimiento debe ser una dirección URL bien formada que comience por una de las siguientes: http://, https://, {lpurl}o {unescapedlpurl}. - Microsoft Advertising no valida si existen parámetros personalizados. Si usa parámetros personalizados en la plantilla de seguimiento y no existen, la dirección URL de la página de aterrizaje incluirá los marcadores de posición de clave y valor de los parámetros personalizados sin sustitución. Por ejemplo, si la plantilla de seguimiento es https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} y no se definen {_season} ni {_promocode} en el nivel de campaña, grupo de anuncios, criterio, palabra clave o anuncio, la dirección URL de la página de aterrizaje será la misma. Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este elemento en una cadena vacía (""), se eliminará la configuración anterior.	string
Tipo	Tipo del anuncio. Este valor es Hotel cuando se recupera un anuncio de hotel. Para obtener más información sobre los tipos de anuncios, consulte comentarios sobre los objetos de datos de anuncios. Agregar: Solo lectura Actualizar: Solo lectura	AdType
UrlCustomParameters	Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL. Microsoft Advertising aceptará los 8 primeros objetos CustomParameter que incluya en el objeto CustomParameters y, si incluye más de 8 parámetros personalizados, se devolverá un error. Cada CustomParameter incluye elementos Key y Value . Agregar: Opcional Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Establezca el elemento UrlCustomParameters en null o vacío para conservar los parámetros personalizados existentes. Para quitar todos los parámetros personalizados, establezca el elemento Parameters del objeto CustomParameters en null o vacío. Para quitar un subconjunto de parámetros personalizados, especifique los parámetros personalizados que desea conservar en el elemento Parameters del objeto CustomParameters .	CustomParameters

Requisitos

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