Objeto de Dados AppAdExtension - Gestão de Campanhas

Artigo
12/21/2023

Define uma extensão de anúncio de aplicação que pode ser incluída num anúncio.

Pode associar uma extensão de anúncio de aplicação à conta ou a campanhas e grupos de anúncios na conta. Cada entidade (conta, campanha ou grupo de anúncios) pode ser associada ao número de extensões de anúncios de aplicações que decidir, até ao número total de extensões de anúncios de aplicações na sua conta.

Sintaxe

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

Elementos

O objeto AppAdExtension tem os seguintes elementos: AppPlatform, AppStoreId, DestinationUrl, DisplayText, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Elemento	Descrição	Tipo de Dados
AppPlatform	A plataforma da aplicação. Os valores possíveis incluem iOS, Android e Windows. Adicionar: Necessário Atualização: Necessário	cadeia
AppStoreId	O identificador da aplicação fornecido pela loja de aplicações. Se a aplicação for nova, aguarde 4 a 7 dias antes de o anúncio ser elegível para entrega. Adicionar: Necessário Atualização: Necessário	cadeia
DestinationUrl	O URL da página Web de transferência da loja de aplicações para a qual os utilizadores são levados quando clicam na ligação da extensão da aplicação. O URL pode conter cadeias de texto dinâmicas, como {keyword}. Para obter uma lista dos parâmetros suportados, consulte a secção Parâmetros disponíveis no artigo ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar?. O URL pode conter um máximo de 1024 carateres. Se o URL não especificar um protocolo, o sistema utiliza o protocolo HTTP quando um utilizador clica no anúncio. Se o URL especificar o protocolo HTTP ao adicionar um anúncio, o serviço removerá a cadeia de protocolo http:// (a cadeia de protocolo HTTP não conta com o limite de 1024 carateres); no entanto, o serviço não removerá uma cadeia de protocolo HTTPS (https://) do URL. Adicionar: Necessário Atualização: Opcional	cadeia
Texto a Apresentar	O texto apresentado na extensão de anúncios da aplicação. O texto pode conter um máximo de 35 carateres. Adicionar: Necessário Atualização: Opcional	cadeia
FinalAppUrls	Reservado para utilização futura.	Matriz appUrl
FinalMobileUrls	Reservado para utilização futura.	matriz de cadeia
FinalUrls	Reservado para utilização futura.	matriz de cadeia
FinalUrlSuffix	Reservado para utilização futura.	cadeia
TrackingUrlTemplate	Reservado para utilização futura.	cadeia
UrlCustomParameters	Reservado para utilização futura.	CustomParameters

O objeto AppAdExtension tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do AdExtension

O objeto AppAdExtension deriva do objeto AdExtension e herda os seguintes elementos: DevicePreference, ForwardCompatibilityMap, ID, Scheduling, Status, Type, Version. As descrições abaixo são específicas de AppAdExtension e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto AdExtension .

Elemento	Descrição	Tipo de Dados
DevicePreference	Este elemento determina se a preferência é que a extensão de anúncios seja apresentada em dispositivos móveis ou em todos os dispositivos. Para especificar uma preferência para dispositivos móveis, defina este elemento como 30001. Para especificar todos os dispositivos, defina este elemento como 0 (zero) ou deixe o elemento nulo. Por predefinição, este elemento será nulo. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	long
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 alterações de compatibilidade para o objeto AdExtension . Adicionar: Só de leitura Atualização: Só de leitura	Matriz KeyValuePairOfstringstring
ID	O identificador exclusivo do Microsoft Advertising da extensão de anúncios. Adicionar: Só de leitura Atualização: Só de leitura e Obrigatório	long
Agendamento	Determina os intervalos de dia e hora do calendário quando a extensão de anúncios é elegível para ser apresentada em anúncios. Adicionar: Opcional Atualização: Opcional. Se definir este elemento como nulo, qualquer conjunto de agendamento existente para a extensão de anúncio permanecerá inalterado. Se definir esta opção para qualquer objeto Schedule não nulo, está efetivamente a substituir as definições de agendamento existentes para a extensão de anúncios. Para remover todo o agendamento, defina este elemento para um objeto Schedule vazio.	Agenda
Estado	O estado da extensão de anúncios. O valor será sempre Ativo porque o serviço Gestão de Campanhas não devolve extensões de anúncios eliminadas. Adicionar: Só de leitura Atualização: Só de leitura	AdExtensionStatus
Tipo	O tipo da extensão de anúncios. Este valor é AppAdExtension quando obtém uma extensão de anúncio de aplicação. Adicionar: Só de leitura Atualização: Só de leitura Para obter mais informações sobre os tipos de extensão de anúncios, veja Comentários sobre Objetos de Dados da Extensão do Ad.	cadeia
Versão	Monitoriza o número de vezes que a extensão de anúncios foi atualizada. A versão é definida como 1 quando a extensão de anúncio é criada e incrementa um após cada atualização. Adicionar: Não permitido Atualização: Não permitido	int

Requisitos

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

Partilhar via