HotelAd Data Object - Gestão de Campanhas

Artigo
12/21/2023

Define um anúncio de hotel. Os anúncios de hotel aparecem quando um viajante procura um hotel em pesquisa ou mapas.

Sintaxe

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

Elementos

O objeto HotelAd tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do Ad

O objeto HotelAd deriva do objeto Ad e herda os seguintes elementos: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. As descrições abaixo são específicas do HotelAd e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto Ad .

Elemento	Descrição	Tipo de Dados
AdFormatPreference	Não suportado para este tipo de anúncio.	cadeia
DevicePreference	Não suportado para este tipo de anúncio.	long
EditorialStatus	Não suportado para este tipo de anúncio.	AdEditorialStatus
FinalAppUrls	Não suportado para este tipo de anúncio.	Matriz appUrl
FinalMobileUrls	Não suportado para este tipo de anúncio.	matriz de cadeia
FinalUrls	Não suportado para este tipo de anúncio.	matriz de cadeia
FinalUrlSuffix	O sufixo de URL final pode incluir parâmetros de controlo que serão anexados ao final do URL da página de destino. Recomendamos que coloque os parâmetros de controlo de que a página de destino necessita num sufixo de URL final para que os seus clientes sejam sempre enviados para a sua página de destino. Para obter mais detalhes e regras de validação, veja Sufixo de URL Final nos guias técnicos. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.	cadeia
ForwardCompatibilityMap	A lista de cadeias de chave e valor para compatibilidade de reencaminhamento para evitar alterações interruptivas quando novos elementos são adicionados na versão atual da API. Atualmente, não existem pares de chaves e valores ForwardCompatibilityMap aplicáveis a anúncios de hotéis.	Matriz KeyValuePairOfstringstring
ID	O identificador exclusivo do Microsoft Advertising para o anúncio. Adicionar: Só de leitura Atualização: Obrigatório e Só de Leitura	long
Estado	O estado do anúncio. Pode definir o estado do anúncio como Ativo ou Em Pausa. Adicionar: Opcional Atualização: Opcional	AdStatus
TrackingUrlTemplate	O modelo de controlo a utilizar como predefinição para todos os URLs de página de destino. As seguintes regras de validação aplicam-se aos modelos de controlo. Para obter mais detalhes sobre os modelos e parâmetros suportados, consulte o artigo de ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar? - Modelos de controlo definidos para entidades de nível inferior, por exemplo, os anúncios substituem os conjuntos de entidades de nível superior, por exemplo, campanha. Para obter mais informações, veja Limites de Entidades. - O comprimento do modelo de controlo está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres. - O modelo de controlo tem de ser um URL bem formado, começando por um dos seguintes: http://, https://, {lpurl} ou {unescapedlpurl}. - O Microsoft Advertising não valida se existem parâmetros personalizados. Se utilizar parâmetros personalizados no seu modelo de controlo e estes não existirem, o URL da página de destino incluirá os marcadores de posição de chave e valor dos parâmetros personalizados sem substituição. Por exemplo, se o seu modelo de controlo for `https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}` e nem {_season} nem {_promocode} estiverem definidos na campanha, grupo de anúncios, critério, palavra-chave ou nível de anúncio, o URL da página de destino será o mesmo. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este elemento como uma cadeia vazia ("", a definição anterior será eliminada.	cadeia
Tipo	O tipo do anúncio. Este valor é Hotel quando obtém um anúncio de hotel. Para obter mais informações sobre tipos de anúncios, veja Ad Data Object Remarks (Comentários de Objetos de Dados do Ad). Adicionar: Só de leitura Atualização: Só de leitura	AdType
UrlCustomParameters	A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs. O Microsoft Advertising aceitará os primeiros 8 objetos CustomParameter que incluir no objeto CustomParameters e, se incluir mais de 8 parâmetros personalizados, será devolvido um erro. Cada CustomParameter inclui elementos Chave e Valor . Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Defina o elemento UrlCustomParameters como nulo ou vazio para manter quaisquer parâmetros personalizados existentes. Para remover todos os parâmetros personalizados, defina o elemento Parâmetros do objeto CustomParameters como nulo ou vazio. Para remover um subconjunto de parâmetros personalizados, especifique os parâmetros personalizados que pretende manter no elemento Parâmetros do objeto CustomParameters .	CustomParameters

Requisitos

Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13

Partilhar via