Partilhar via

Objeto de Dados de Palavra-chave - Gestão de Campanhas

  • Artigo

Define uma palavra-chave.

As palavras-chave são as palavras ou expressões pesquisadas ao procurar um produto ou serviço. Por exemplo, as palavras-chave podem ser qualquer uma das seguintes:

  • Sapatos
  • Barcos de férias de cruzeiros
  • Aulas de ténis em Nova Iorque

Conforme mostrado acima, uma palavra-chave pode ser apenas uma única palavra, várias palavras ou até mesmo uma expressão. No contexto da publicidade de pesquisa, todas elas são simplesmente referidas como uma palavra-chave.

Importante

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.

Sintaxe

<xs:complexType name="Keyword" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Bid" nillable="true" type="tns:Bid" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:KeywordEditorialStatus" />
    <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
    <xs:element xmlns:q32="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q32:ArrayOfstring" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q33="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q33:ArrayOfstring" />
    <xs:element xmlns:q34="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q34:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MatchType" nillable="true" type="tns:MatchType" />
    <xs:element minOccurs="0" name="Param1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param3" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:KeywordStatus" />
    <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
    <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:complexType>

Elementos

O objeto Palavra-chave tem os seguintes elementos: Bid, Bid, BidScheme, DestinationUrl, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, MatchType, Param1, Param2, Param3, Status, Text, TrackingUrlTemplate, UrlCustomParameters.

Elemento Descrição Tipo de Dados
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á utilizado o Ad Group CpcBid . 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. Para eliminar a oferta de palavra-chave e utilizar a oferta de tipo de correspondência predefinida do AdGroup , defina o elemento Amount do objeto Bid como nulo.		 Licitação
BidõesScheme O tipo de estratégia de oferta para a forma como pretende gerir as suas ofertas.

Para obter detalhes sobre estratégias de licitação suportadas por tipo de campanha, veja Estratégias de Orçamento e Licitação.

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. Se não definir este elemento, a opção InheritFromParentBiddingScheme é utilizada por predefinição.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 BidõesScheme
DestinationUrl 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 URLs finais . 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		 cadeia
EditorialStatus O estado da revisão editorial da palavra-chave, que indica se a palavra-chave está pendente de revisão, foi aprovado ou foi desaprovado.

Adicionar: Só de leitura
Atualização: Só de leitura		 KeywordEditorialStatus
FinalAppUrls Reservado para utilização futura. Matriz appUrl
FinalMobileUrls 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.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 matriz de cadeia
FinalUrls 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 FinalUrls e FinalMobileUrls; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento.
- A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo {lpurl}.
- Os URLs finais têm de ser um URL bem formado, começando com http:// ou https://.
- Se especificar FinalMobileUrls, também tem de especificar FinalUrls.
- Não pode especificar FinalMobileUrls se a preferência do dispositivo estiver definida como móvel. Tenha também em atenção que, se os elementos TrackingUrlTemplate ou UrlCustomParameters estiverem definidos, é necessário, pelo menos, um URL final. Para obter mais informações, veja Controlo de URLs com URLs Atualizados.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 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.

As alterações de compatibilidade de reencaminhamento serão registadas aqui em versões futuras. Atualmente, não existem alterações de compatibilidade para este objeto.		 Matriz KeyValuePairOfstringstring
ID O identificador gerado pelo sistema da palavra-chave.

Adicionar: Só de leitura
Atualização: Necessário		 long
Tipo de Correspondência O tipo de correspondência para comparar a palavra-chave e o termo de pesquisa do utilizador.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 Tipo de Correspondência
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}.

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 elemento como uma cadeia vazia ("", a definição anterior será eliminada.		 cadeia
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 elemento como uma cadeia vazia ("", a definição anterior será eliminada.		 cadeia
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 elemento como uma cadeia vazia ("", a definição anterior será eliminada.		 cadeia
Estado O estado da palavra-chave. Por predefinição, o estado está definido como Ativo.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.		 KeywordStatus
Text 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		 cadeia
TrackingUrlTemplate O modelo de controlo a utilizar como predefinição para todos os FinalUrls e FinalMobileUrls.

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

Utilizado Por

AddKeywords
GetKeywordsByAdGroupId
GetKeywordsByEditorialStatus
GetKeywordsByIds
UpdateKeywords