AppInstallAd Data Object - Gestão de Campanhas

Artigo
12/21/2023

Define um anúncio de instalação da aplicação.

Os Anúncios de Instalação de Aplicações são semelhantes a anúncios de texto, mas fornecem ligações diretas para as suas aplicações com um botão, enviando os clientes diretamente para a loja aplicável para transferir a aplicação. Esta é uma solução ideal para os anunciantes que querem gerir e impulsionar as transferências das suas aplicações, em vez do tráfego de sites.

Instalação de Aplicações Os anúncios detetam automaticamente o dispositivo móvel e o sistema operativo do cliente, enviando-os para o apple App Store ou Google Play correspondente. Também pode controlar conversões com os mesmos parceiros de controlo de conversão que as Extensões de Aplicações: AppsFlyer, Kochava, Tune, Singular, Adjust e Branch.

Nota

Os Anúncios de Instalação de Aplicações estão disponíveis apenas na Austrália, Brasil, Canadá, França, Alemanha, Índia, Reino Unido e Estados Unidos apenas em iOS e Android. Atualmente, só são suportadas aplicações disponíveis no Estados Unidos no Apple App Store e na Google Play Store. Não existe suporte para o Windows.

Nem todos têm esta funcionalidade ainda. Se não o fizer, não se preocupe. Está a chegar em breve.

Nota

Os anúncios de instalação de aplicações só podem ser criados em campanhas de Pesquisa em que o AdGroupType está definido como "SearchStandard". Se o AdGroupType estiver definido como "SearchDynamic", o grupo de anúncios não suporta anúncios de instalação de aplicações.

A combinação dos elementos AppPlatform, AppStoreId, Text e Title torna a instalação do anúncio exclusiva da aplicação.

Sintaxe

<xs:complexType name="AppInstallAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <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="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto AppInstallAd tem os seguintes elementos: AppPlatform, AppStoreId, Text, Title.

Elemento	Descrição	Tipo de Dados
AppPlatform	A plataforma da aplicação. Os valores possíveis incluem iOS e Android. Adicionar: Necessário Atualização: Opcional	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: Opcional	cadeia
Text	A cópia de anúncios. A cópia tem de conter, pelo menos, uma palavra. A cópia e o título combinados do anúncio têm de ter, pelo menos, três palavras. A cópia de anúncios não pode conter cadeias de texto dinâmicas, como {keyword}. O comprimento máximo de entrada da cópia é de 71 carateres. Tenha em atenção que, para grupos de anúncios que utilizam chinês tradicional, o texto está limitado a 38 carateres. A cópia de anúncios não pode conter o caráter newline (\n). Adicionar: Necessário Atualização: Opcional	cadeia
Cargo	O título do anúncio. O título tem de conter, pelo menos, uma palavra. A cópia e o título combinados do anúncio têm de ter, pelo menos, três palavras. O título não pode conter cadeias de texto dinâmicas, como {keyword}. O comprimento máximo de entrada do título é de 25 carateres. Tenha em atenção que, para grupos de anúncios que utilizam chinês tradicional, o título está limitado a 15 carateres. O título não pode conter o caráter newline (\n). Adicionar: Necessário Atualização: Opcional	cadeia

O objeto AppInstallAd tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do Ad

O objeto AppInstallAd 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 de AppInstallAd 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	Este elemento determina se a preferência é que os anúncios de instalação de aplicações sejam apresentados em dispositivos móveis e tablets ou apenas em dispositivos móveis. (Os anúncios de instalação de aplicações não são atualmente suportados em computadores de secretária.) Para especificar uma preferência apenas para dispositivos móveis (ou seja, excluindo tablets), defina este elemento como 30001. Para especificar uma preferência para dispositivos móveis e tablets, defina este elemento como 0 (zero) ou deixe o elemento nulo. Por predefinição, este elemento será nulo. Adicionar: Opcional Atualização: Opcional	long
EditorialStatus	O estado de revisão editorial do anúncio, que indica se o anúncio está pendente de revisão, foi aprovado ou foi desaprovado. Adicionar: Só de leitura Atualização: Só de leitura	AdEditorialStatus
FinalAppUrls	Não suportado para anúncios de instalação de aplicações.	Matriz appUrl
FinalMobileUrls	Não suportado para anúncios de instalação de aplicações.	matriz de cadeia
FinalUrls	O URL onde um utilizador de pesquisa é pousado e pode optar por instalar uma aplicação. Adicionar: Necessário Atualização: Opcional	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 este objeto.	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 o URL especificado com FinalUrls. 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 é AppInstall quando obtém um anúncio de instalação da aplicação. 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