App Install Ad Record - Bulk

Define um anúncio de instalação da aplicação que pode ser transferido e carregado num ficheiro em massa.

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 Tipo de Grupo de Anúncios está definido como "SearchStandard". Se o Tipo de Grupo de Anúncios estiver definido como "SearchDynamic", o grupo de anúncios não suporta anúncios de instalação de aplicações.

Pode transferir todos os registos do App Install Ad na conta ao incluir o valor DownloadEntity de AppInstallAds no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para obter mais detalhes sobre o Serviço em massa, incluindo as melhores práticas, veja Transferência e Carregamento em Massa.

O seguinte exemplo de CSV em Massa adicionaria um novo anúncio de instalação da aplicação se for fornecido um valor de ID Principal válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,,,,,6.0,,,,,,,
App Install Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,,,,All,,Android,AppStoreIdGoesHere,FinalUrlGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer

Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo ao utilizar o BulkServiceManager para carregar e transferir o objeto BulkAppInstallAd , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAppInstallAd
var bulkAppInstallAd = new BulkAppInstallAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // AppInstallAd object of the Campaign Management service.
    AppInstallAd = new AppInstallAd
    {
        // 'App Platform' column header in the Bulk file
        AppPlatform = "Android",
        // 'App Id' column header in the Bulk file
        AppStoreId = "AppStoreIdGoesHere",
        // 'Device Preference' column header in the Bulk file
        DevicePreference = 0,
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "FinalUrlGoesHere"
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales!",
        // 'Title' column header in the Bulk file
        Title = "Contoso Quick Setup",
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
};

uploadEntities.Add(bulkAppInstallAd);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Para um registo de Instalação de Aplicação do Ad , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa. A combinação dos campos ID da Aplicação, Plataforma de Aplicações, Texto e Título torna a instalação da aplicação exclusiva.

• Grupo de Anúncios
• ID da Aplicação
• Plataforma de Aplicações
• Campanha
• ID de Cliente
• Parâmetro Personalizado
• Preferência do Dispositivo
• Estatuto de Recurso Editorial
• Localização Editorial
• Código do Motivo Editorial
• Estado Editorial
• Termo Editorial
• Final Url
• Sufixo de URL Final
• ID
• Hora da Modificação
• ID principal
• Países do Publisher
• Estado
• Text
• Cargo
• Modelo de Controlo

Grupo de Anúncios

O nome do grupo de anúncios que contém o anúncio.

Adicionar: Só de leitura e Obrigatório
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

ID da Aplicação

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. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Plataforma de Aplicações

A plataforma da aplicação.

Os valores possíveis incluem iOS e Android.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Campanha

O nome da campanha que contém o grupo de anúncios e o anúncio.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

ID de Cliente

Utilizado para associar registos no ficheiro de carregamento em massa a registos no ficheiro de resultados. O valor deste campo não é utilizado ou armazenado pelo servidor; é simplesmente copiado do registo carregado para o registo de resultados correspondente. Pode ser qualquer cadeia válida até 100 de comprimento.

Adicionar: Opcional
Atualização: Opcional
Eliminar: Só de leitura

Parâmetro Personalizado

A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs.

Num ficheiro em massa, a lista de parâmetros personalizados é formatada da seguinte forma.

• Formate cada par de parâmetros personalizado como Key=Value, por exemplo {_promoCode}=PROMO1.

• O Microsoft Advertising aceitará os primeiros oito pares de chave e valor personalizados que incluir e, se incluir mais de 8 parâmetros personalizados, será devolvido um erro. Cada par chave e valor é delimitado por um ponto e vírgula e espaço ("; "), por exemplo {_promoCode}=PROMO1; {_season}=verão.

• Uma Chave não pode conter um ponto e vírgula. Se um Valor contiver um ponto e vírgula, tem de ser escapado como '\;'. Além disso, se o Valor contiver uma barra invertida, também terá de ser escapado como "\".

• A Chave não pode exceder os 16 bytes UTF-8 e o Valor não pode exceder os 250 bytes UTF-8. A Chave é necessária e o Valor é opcional. O tamanho máximo da Chave não inclui as chavetas e o caráter de sublinhado, ou seja, "{", "_" e "}".

  Nota

  Com o serviço em massa, a Chave tem de ser formatada com chavetas adjacentes e um caráter de sublinhado à esquerda, por exemplo, se a Chave for promoCode, tem de ser formatada como {_promoCode}. Com o serviço Gestão de Campanhas, não pode especificar as chavetas adjacentes e o caráter de sublinhado.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para remover todos os parâmetros personalizados, defina este campo como delete_value. A palavra-chave delete_value remove a definição anterior. Para remover um subconjunto de parâmetros personalizados, especifique os parâmetros personalizados que pretende manter e omita os que não pretende manter. O novo conjunto de parâmetros personalizados substituirá qualquer conjunto de parâmetros personalizados anterior.
Eliminar: Só de leitura

Preferência do Dispositivo

Este campo 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.)

Os valores possíveis são Todos (dispositivos móveis e tablets) e Mobile (ou seja, excluindo tablets), que diferem dos valores utilizados no serviço de gestão de campanhas.

O valor predefinido é Tudo.

No ficheiro de transferência e carregamento de resultados em massa, este campo nunca estará vazio. Se não tiver especificado uma preferência de dispositivo, será devolvido o valor predefinido de Todos .

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 campo para a cadeia de delete_value , a definição anterior é removida. Se definir este campo como delete_value, está efetivamente a repor para o valor predefinido de Todos.
Eliminar: Só de leitura

Estatuto de Recurso Editorial

Determina se pode recorrer das questões encontradas pela revisão editorial.

Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Apelativo	A questão editorial é apelativa.
Recurso Pendente	A questão editorial é recorrida e foi apresentado um recurso.
Não Aplicável	A questão editorial não é apelativa.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Localização Editorial

O componente ou propriedade do anúncio que falhou na revisão editorial.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Código do Motivo Editorial

Um código que identifica o motivo da falha. Para obter uma lista de possíveis códigos de motivos, consulte Códigos de Razão Editoriais.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Estado Editorial

O estado editorial do anúncio.

Os valores possíveis estão descritos na tabela abaixo.

Valor	Descrição
Ativo	O anúncio passou na revisão editorial.
ActiveLimited	O anúncio passou na revisão editorial em um ou mais mercados, e um ou mais elementos do anúncio estão a ser revistos editorialmente noutro mercado. Por exemplo, o anúncio passou na revisão editorial para o Canadá e ainda está pendente de revisão no Estados Unidos.
Reprovado	O anúncio falhou na revisão editorial.
Inativo	Um ou mais elementos do anúncio estão a ser analisados editorialmente.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Termo Editorial

O termo que falhou na revisão editorial.

Este campo não será definido se uma combinação de termos tiver causado a falha ou se a falha tiver sido baseada numa violação de política.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Final Url

O URL onde um utilizador de pesquisa é pousado e pode optar por instalar uma aplicação.

As seguintes regras de validação aplicam-se ao Url Final para anúncios de instalação de aplicações.

• O comprimento do URL está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.
• Pode especificar apenas um URL neste campo.
• A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo "{lpurl}".
• Cada URL tem de ser um URL bem formado, começando com http:// ou https://.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Sufixo de URL Final

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 campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema do anúncio.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificador negativo para o anúncio pode, em seguida, ser referenciado no campo ID Principal de tipos de registo dependentes, como App Install Ad Label. Isto é recomendado se estiver a adicionar novos anúncios e novos registos dependentes no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Hora da Modificação

A data e hora em que a entidade foi atualizada pela última vez. O valor está em Hora Universal Coordenada (UTC).

Nota

O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

ID principal

O identificador gerado pelo sistema do grupo de anúncios que contém o anúncio.

Este campo em massa mapeia para o campo ID do registo do Grupo de Anúncios .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de grupo de anúncios existente ou especificar um identificador negativo que seja igual ao campo ID do registo do Grupo de Anúncios principal. Isto é recomendado se estiver a adicionar novos anúncios a um novo grupo de anúncios no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura
Eliminar: Só de leitura

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

Países do Publisher

A lista de países ou regiões publicadores cujas diretrizes editoriais não permitem o termo especificado.

Num ficheiro em massa, a lista de países ou regiões do publicador é delimitada com um ponto e vírgula (;).

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Estado

O estado do anúncio.

Os valores possíveis são Ativo, Em Pausa ou Eliminado.

Adicionar: Opcional. O valor predefinido é Ativo.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.

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. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

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. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Modelo de Controlo

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?

• Os 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 campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura