Partilhar via

Registo de Palavras-chave - Em massa

  • Artigo

Define uma palavra-chave que pode ser transferida e carregada num ficheiro em massa.

Pode transferir todos os registos de Palavras-chave na conta ao incluir o valor DownloadEntity de Palavras-chave no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para incluir os campos Relevância da Palavra-chave, Relevância da Página de Destino, Experiência do Utilizador da Página de Destino e Classificação de Qualidade nos registos de Campanha transferidos, também tem de incluir o âmbito QualityScoreData . Se também incluir o âmbito BidSuggestionsData , o ficheiro em massa também pode conter registos de Oferta de Melhor Posição de Palavra-chave, Oferta de Linha Principal de Palavra-chave e Oferta de Primeira Página de Palavras-chave correspondentes a cada palavra-chave transferida. 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 uma nova palavra-chave se fosse fornecido um valor de ID Principal válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Bid,Param1,Param2,Param3,Name,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Bid Strategy Type
Format Version,,,,,,,,,,,,,,6.0,,,,,,
Keyword,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,red shoes,Broad,0.5,,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,,{_promoCode}=PROMO1; {_season}=summer,ManualCpc

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 BulkKeyword , 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 BulkKeyword
var bulkKeyword = new BulkKeyword
{
    // '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 
    // Keyword object of the Campaign Management service.
    Keyword = new Keyword
    {
        // 'Bid' column header in the Bulk file
        Bid = new Bid
        {
            Amount = 0.50,
        },
        // 'Bid Strategy Type' column header in the Bulk file
        BiddingScheme = new ManualCpcBiddingScheme { },
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/womenshoesale"
        },
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/womenshoesale"
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Match Type' column header in the Bulk file
        MatchType = MatchType.Broad,
        // 'Param 1 column header in the Bulk file
        Param1 = null,
        // 'Param 2' column header in the Bulk file
        Param2 = null,
        // 'Param 3' column header in the Bulk file
        Param3 = null,
        // 'Status' column header in the Bulk file
        Status = KeywordStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "red shoes",
        // '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(bulkKeyword);

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 Palavra-chave , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Grupo de Anúncios

O nome do grupo de anúncios que contém a palavra-chave.

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 .

Licitação

O montante máximo que pretende pagar sempre que alguém clicar no seu anúncio.

Você licita contra outros anunciantes usando a mesma palavra-chave, por isso, em geral, ofertas mais altas ajudam a fazer com que o seu anúncio seja apresentado em localizações mais desejáveis na página de resultados da pesquisa.

Em vez de utilizar a oferta de nível de grupo de anúncios predefinida, pode definir ofertas personalizadas para cada palavra-chave. As ofertas personalizadas de palavras-chave substituem a oferta predefinida do grupo de anúncios para essas palavras-chave específicas. Com as ofertas personalizadas, pode concentrar o seu tempo e dinheiro nas palavras-chave mais lucrativas, mas terá de gastar mais tempo na gestão das ofertas individuais.

Se a oferta de nível de palavra-chave não estiver definida, será utilizada a Oferta cpc do Grupo Ad. Para obter mais informações, veja Estratégias de Orçamento e Licitação.

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

Tipo de Estratégia de Oferta

O tipo de estratégia de oferta para a forma como pretende gerir as suas ofertas.

O tipo de estratégia de oferta para grupos de anúncios e palavras-chave é "InheritFromParent".

Nota

A partir de abril de 2021, não pode definir estratégias de licitação para grupos de anúncios ou palavras-chave. Se tentar definir estratégias de licitação para grupos de anúncios ou palavras-chave, o pedido será ignorado sem erros. Grupos de anúncios e palavras-chave herdarão a estratégia de licitação da sua campanha.

Adicionar: Opcional
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 a palavra-chave.

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

URL de Destino

O URL da página Web para onde levar o utilizador quando clica no anúncio. O URL de destino da palavra-chave é utilizado se for especificado; caso contrário, é utilizado o URL de destino do anúncio.

Importante

A partir de novembro de 2018, o URL de destino da palavra-chave não pode ser adicionado ou atualizado. Em alternativa, pode utilizar o Url Final , caso contrário, o Microsoft Advertising utilizará o URL Final do anúncio. Para obter mais detalhes, veja Migrating your keyword destination URLs to final URLs (Migrar os URLs de destino da palavra-chave para URLs finais).

Adicionar: Não permitido
Atualização: Não permitido
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 da palavra-chave 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 da palavra-chave.

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

Valor Descrição
Ativo A palavra-chave passou na revisão editorial.
ActiveLimited A palavra-chave passou a revisão editorial em um ou mais mercados, e um ou mais elementos da palavra-chave estão a ser analisados editorialmente noutro mercado. Por exemplo, a palavra-chave passou revisão editorial para o Canadá e ainda está pendente de revisão no Estados Unidos.
Reprovado A palavra-chave falhou na revisão editorial.
Inativo Um ou mais elementos da palavra-chave estão a ser submetidos a uma revisão editorial.

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 da página de destino. O URL final da palavra-chave é utilizado se for especificado; caso contrário, é utilizado o URL final do anúncio.

As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais.

  • 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 até 10 itens para URLs Finais e URLs Móveis Finais; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento.

  • Cada URL é delimitado por um ponto e vírgula e espaço ("; ").

  • 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://.

  • Se especificar URLs Finais para Dispositivos Móveis, também tem de especificar Url Final.

Tenha também em atenção que, se os campos Modelo de Controlo ou Parâmetro Personalizado estiverem definidos, é necessário o campo Url Final .

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

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 da palavra-chave.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificador negativo para a palavra-chave pode, em seguida, ser referenciado no campo ID Principal de tipos de registo dependentes, como Etiqueta de Palavra-chave. Isto é recomendado se estiver a adicionar novas palavras-chave 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

Tipo de Estratégia de Oferta Herdada

O tipo de estratégia de oferta que é herdado da campanha principal ou do grupo de anúncios se o Tipo de Estratégia de Oferta da palavra-chave estiver definido como HerdarFromParent. Este valor é igual à campanha principal ou ao campo Tipo de Estratégia de Oferta do grupo de anúncios. Os valores possíveis são EnhancedCpc, ManualCpc, MaxClicks, MaxConversions, TargetCpa e TargetRoas.

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

Palavra-chave

O texto da palavra-chave.

O texto pode conter um máximo de 100 carateres.

Deve especificar a palavra-chave na região do valor Idioma que especificou para o grupo de anúncios ao qual a palavra-chave pertence.

Adicionar: Necessário
Atualização: Só de leitura
Eliminar: Só de leitura

Relevância da Palavra-chave

Uma classificação numérica que indica a probabilidade de os seus anúncios serem clicados e quão bem a sua palavra-chave compete com outras palavras-chave direcionadas para o mesmo tráfego. Esta classificação prevê se é provável que a palavra-chave conduza a um clique nos seus anúncios, tendo em conta o desempenho da palavra-chave no passado relativamente à posição do seu anúncio.

Nota

A Palavra-chave Relevância é equivalente à etiqueta Taxa de Click-Through Esperada utilizada na aplicação Web Microsoft Advertising.

Uma classificação de 3 é Acima da Média; uma classificação de 2 é Média; e uma classificação de 1 é considerada Abaixo da Média.

Se especificar um período de tempo que abrange vários dias, a classificação será a mesma para cada dia no período de tempo e o valor é a classificação calculada mais recente.

Normalmente, os dados desta coluna são atualizados 14 a 18 horas após o fim do dia UTC.

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

Relevância da Página de Destino

Uma classificação numérica que indica a relevância do anúncio e da página de destino para a consulta de pesquisa do cliente ou outras entradas.

Nota

A Relevância da Página de Destino é equivalente à etiqueta Relevância do Anúncio utilizada na aplicação Web Microsoft Advertising.

Uma classificação de 3 é Acima da Média; uma classificação de 2 é Média; e uma classificação de 1 é considerada Abaixo da Média.

Se especificar um período de tempo que abrange vários dias, a classificação será a mesma para cada dia no período de tempo e o valor é a classificação calculada mais recente.

Normalmente, os dados desta coluna são atualizados 14 a 18 horas após o fim do dia UTC.

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

Experiência de Utilizador da Página de Destino

Uma classificação numérica que indica se é provável que a sua página de destino proporcione uma boa experiência aos clientes que clicam no seu anúncio e acedem ao seu site.

Nota

A Experiência de Utilizador da Página de Destino é equivalente à etiqueta Experiência de Página de Destino utilizada na aplicação Web Microsoft Advertising.

Uma classificação de 3 é Acima da Média; uma classificação de 2 é Média; e uma classificação de 1 é considerada Abaixo da Média.

Se especificar um período de tempo que abrange vários dias, a classificação será a mesma para cada dia no período de tempo e o valor é a classificação calculada mais recente.

Normalmente, os dados desta coluna são atualizados 14 a 18 horas após o fim do dia UTC.

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

Tipo de Correspondência

O tipo de correspondência para comparar a palavra-chave e o termo de pesquisa do utilizador.

Os valores de tipo de correspondência suportados para uma palavra-chave são Largo, Exato e Expressão.

Nota: se ativou a Segmentação preditiva para a sua campanha de Pesquisa, o tipo de correspondência é "Preditivo". Neste caso, não pode adicionar, atualizar e eliminar o tipo de correspondência porque utilizamos a segmentação preditiva para corresponder os seus anúncios a consultas de pesquisa relevantes.

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

Url Final do Dispositivo Móvel

O URL da página de destino móvel. O URL móvel final da palavra-chave é utilizado se for especificado; caso contrário, é utilizado o URL móvel final do anúncio.

As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais.

  • 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 até 10 itens para URLs Finais e URLs Móveis Finais; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento.

  • Cada URL é delimitado por um ponto e vírgula e espaço ("; ").

  • 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://.

  • Se especificar URLs Finais para Dispositivos Móveis, também tem de especificar Url Final.

Tenha também em atenção que, se o elemento TrackingUrlTemplate ou UrlCustomParameters estiver definido, é necessário, pelo menos, um URL final.

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

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

Parâmetro1

A cadeia a utilizar como valor de substituição num anúncio se o título, texto, URL de apresentação ou URL de destino do anúncio contiver a cadeia de substituição dinâmica {Param1}.

Nota

Embora possa utilizar {Param1} para especificar o URL de destino de um anúncio, recomendamos que não o faça. Em vez disso, deve definir o elemento DestinationUrl da palavra-chave.

A cadeia pode conter um máximo de 1022 carateres. O limite real depende do comprimento do elemento que referencia a cadeia de substituição. Por exemplo, o comprimento do título de um anúncio de texto pode conter um máximo de 25 carateres.

Ao implementar texto dinâmico na sua cópia de anúncios, deve fornecer uma cadeia predefinida, por exemplo, {Param1:default} que o sistema utilizará se Param1 para uma palavra-chave for nulo ou estiver vazio, ou se incluir o valor de substituição param1 fará com que a cadeia expandida exceda o limite do elemento; caso contrário, o anúncio não servirá com esta palavra-chave. Para obter mais informações, consulte o artigo Ajuda do Microsoft Advertising Personalizar automaticamente os seus anúncios com parâmetros de texto dinâmicos.

Tenha também em atenção que se o grupo de anúncios tiver apenas um anúncio e se esse anúncio utilizar {Param1} mas não fornecer uma cadeia predefinida, por exemplo, {Param1:default}, tem de fornecer um valor Param1 válido para essa substituição. Caso contrário, esta palavra-chave não pode ser adicionada ou atualizada.

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

Parâmetro2

A cadeia a utilizar como o valor de substituição num anúncio se o título, o texto, o URL de apresentação ou o URL de destino contiverem a cadeia de substituição dinâmica {Param2}.

Normalmente, utiliza a cadeia de substituição {Param2} nos elementos de título ou texto (descrição da cópia de anúncios) de um anúncio.

A cadeia pode conter um máximo de 70 carateres. O limite real depende do comprimento do elemento que referencia a cadeia de substituição. Por exemplo, o comprimento do título de um anúncio de texto pode conter um máximo de 25 carateres.

Ao implementar texto dinâmico na sua cópia de anúncios, deve fornecer uma cadeia predefinida, por exemplo, {Param2:default} que o sistema utilizará se Param2 para uma palavra-chave for nulo ou estiver vazio, ou se incluir o valor de substituição Param2 fará com que a cadeia expandida exceda o limite do elemento; caso contrário, o anúncio não servirá com esta palavra-chave. Para obter mais informações, consulte o artigo Ajuda do Microsoft Advertising Personalizar automaticamente os seus anúncios com parâmetros de texto dinâmicos.

Tenha também em atenção que se o grupo de anúncios tiver apenas um anúncio e se esse anúncio utilizar {Param2} mas não fornecer uma cadeia predefinida, por exemplo, {Param2:default}, tem de fornecer um valor Param2 válido para essa substituição. Caso contrário, esta palavra-chave não pode ser adicionada ou atualizada.

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

Parâmetro3

A cadeia a utilizar como valor de substituição num anúncio se o título, texto, URL de apresentação ou URL de destino contiver a cadeia de substituição dinâmica {Param3}.

Normalmente, utiliza a cadeia de substituição {Param3} nos elementos de título ou texto (descrição da cópia de anúncios) de um anúncio.

A cadeia pode conter um máximo de 70 carateres. O limite real depende do comprimento do elemento que referencia a cadeia de substituição. Por exemplo, o comprimento do título de um anúncio de texto pode conter um máximo de 25 carateres.

Ao implementar texto dinâmico na sua cópia de anúncios, deve fornecer uma cadeia predefinida, por exemplo, {Param3:default} que o sistema utilizará se Param3 para uma palavra-chave for nulo ou estiver vazio, ou se incluir o valor de substituição param3 fará com que a cadeia expandida exceda o limite do elemento; caso contrário, o anúncio não servirá com esta palavra-chave. Para obter mais informações, consulte o artigo Ajuda do Microsoft Advertising Personalizar automaticamente os seus anúncios com parâmetros de texto dinâmicos.

Tenha também em atenção que se o grupo de anúncios tiver apenas um anúncio e se esse anúncio utilizar {Param3} mas não fornecer uma cadeia predefinida, por exemplo, {Param3:default}, tem de fornecer um valor Param3 válido para essa substituição. Caso contrário, esta palavra-chave não pode ser adicionada ou atualizada.

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 principal

O identificador gerado pelo sistema do grupo de anúncios que contém a palavra-chave.

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 novas palavras-chave 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

Pontuação de Qualidade

A pontuação numérica mostra-lhe o quão competitivos são os seus anúncios no marketplace ao medir a relevância das suas palavras-chave e páginas de destino para os termos de pesquisa dos clientes. A classificação de qualidade é calculada pela Microsoft Advertising com as subcontas Relevância da Palavra-chave, Relevância da Página de Destino e Experiência do Utilizador da Página de Destino . Se disponível, a classificação de qualidade pode variar entre um mínimo de 1 e um máximo de 10.

A classificação de qualidade baseia-se nos últimos 30 dias para o tráfego de pesquisa detido e operado. Uma pontuação de qualidade pode ser atribuída sem quaisquer impressões, no caso em que uma oferta de palavra-chave não ganhou nenhum leilão. O tráfego para redes sindicadas não afeta a classificação de qualidade. O valor no ficheiro será "" (cadeia vazia) se a classificação não tiver sido calculada. Isto pode ocorrer se não existirem impressões para a palavra-chave durante 30 dias ou mais.

Normalmente, a classificação de qualidade é atualizada 14 a 18 horas após o fim do dia UTC. As palavras-chave em todos os fusos horários receberão uma classificação de qualidade para o dia UTC correspondente.

Se executar o relatório várias vezes num dia, os valores de classificação de qualidade podem mudar de relatório para relatório com base no momento em que executa o relatório relativamente à data de cálculo das classificações.

Se especificar um período de tempo que abrange vários dias, a classificação de qualidade é a classificação calculada atual e mais recente e será reportada como a mesma para cada dia no período de tempo. Utilize a pontuação de qualidade histórica para descobrir como a pontuação de qualidade pode ter mudado ao longo do tempo. A classificação de qualidade histórica é um instantâneo diário da classificação de qualidade sem interrupção. Para obter mais informações sobre a classificação de qualidade histórica, veja a coluna HistoricQualityScore em Atributos de Relatório e Estatísticas de Desempenho.

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

Estado

O estado da palavra-chave.

Os valores possíveis são Ativo, Em Pausa, Inativo 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.

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