Funções de correspondência

Com os objetos CustomerFeed, CampaignFeed e AdGroupFeed no Google AdWords, é possível definir critérios de seleção para itens de feed por meio de uma função de correspondência. Essa função consiste em três campos:

Campo Tipo
lhsOperand FunctionArgumentOperand
operator Function.Operator
rhsOperand FunctionArgumentOperand

Por exemplo, uma Function que seleciona objetos FeedItem com feedItemId 1000001, 1000002 ou 1000003 tem os seguintes atributos:

  1. lhsOperand =RequestContextOperand com contextType= FEED_ITEM_ID
  2. operator = IN
  3. rhsOperand = [1000001, 1000002, 1000003]

Você pode configurar a functionString da função como uma alternativa à criação de objetos "operador" e "operando" para criar uma função equivalente:

IN(FEED_ITEM_ID,{1000001,1000002,1000003})

Além das funções simples, você pode combinar várias funções para criar uma nova, com algumas restrições (falaremos mais sobre isso posteriormente neste guia).

As seções abaixo abordam as regras usadas pela Google AdWords API para validar funções de correspondência.

Exemplo de itens de feed

O exemplo usa os seguintes itens de feed de um ID de feed fictício 12345678.

ID do FeedItem Nome do atributo 0 Linha 2 do atributo 1 Linha 3 do atributo 2 URLs finais do atributo 3
1000001 Cruzeiro Marte Viaje na velocidade da luz 225 milhões de quilômetros [http://www.example.com/mars]
1000002 Cruzeiro Vênus Viaje na velocidade da luz 260 milhões de quilômetros [http://www.example.com/venus]
1000003 Cruzeiro Júpiter Almoço incluído 587 milhões de quilômetros [http://www.example.com/jupiter1, http://www.example.com/jupiter2]
1000004 Cruzeiro Lua Pretzels de cortesia 384 mil quilômetros [http://www.example.com/moon]

Tipos de função

A API é compatível com os seguintes tipos de função de nó de folha. Funções compostas por outras funções serão abordadas na próxima seção.

Seleção por plataforma (dispositivo móvel ou computador)

Com esse tipo de função, é possível limitar a exibição de extensões de anúncios específicas (tipos de marcador de posição) para usuários de dispositivos móveis ou computadores.

Campo Valor válido
lhsOperand RequestContextOperand com contextType = DEVICE_PLATFORM
operator EQUALS
rhsOperand um único ConstantOperand de Mobile ou Desktop (com diferenciação de maiúsculas e minúsculas)
Exemplo de string de função
EQUALS(CONTEXT.DEVICE,"Mobile")

Seleção por ID do item do feed

Esse tipo de função permite selecionar itens de feed especificando o feedItemId deles.

A string de função abaixo selecionará os três primeiros itens de feed (Cruzeiro Marte, Cruzeiro Vênus e Cruzeiro Júpiter) de acordo com os respectivos IDs de itens de feed.

Campo Valor válido
lhsOperand RequestContextOperand com contextType = FEED_ITEM_ID
operator EQUALS ou IN
rhsOperand um ConstantOperand ou mais
  • precisa ser exatamente um ConstantOperand para EQUALS
  • no máximo 20 ConstantOperands para IN
Exemplo de string de função
IN(FEED_ITEM_ID,{1000001,1000002,1000003})

Seleção por atributo de feed

Com este tipo de função, é possível selecionar itens de feed com base no valor de um atributo específico de um FeedItem.

A string de função abaixo selecionará o primeiro, o segundo e o quarto itens de feed de acordo com os respectivos valores deles para o atributo 0.

Campo Valor válido
lhsOperand FeedAttributeOperand com feedId e feedAttributeId definidos
operator EQUALS ou CONTAINS_ANY
rhsOperand um ConstantOperand ou mais
  • precisa ser exatamente um ConstantOperand para EQUALS
  • máximo de três ConstantOperands para CONTAINS_ANY
Exemplo de string de função
CONTAINS_ANY(FeedAttribute[12345678,0],{"Mars cruise","Venus cruise","Moon cruise"})

Funções de identidade (sempre verdadeiro ou sempre falso)

Com essa função, é possível definir uma condição que sempre avalia como verdadeiro ou falso. Você pode usar uma string de função de IDENTITY(true) para selecionar todos os itens em um feed.

O exemplo da string de função abaixo não seleciona nenhum item no feed. Use esse tipo de função para desativar as extensões de anúncio de um tipo específico no nível do cliente, da campanha ou do grupo.

Campo Valor
lhsOperand exatamente um ConstantOperand com o booleanValue definido como true ou false
operator IDENTITY
rhsOperand nenhum
Exemplo de string de função
IDENTITY(false)

Como combinar funções

Você pode usar o FunctionOperand com o operador AND para combinar duas ou mais funções de forma lógica a fim de criar uma nova função de correspondência.

O exemplo de string de função abaixo selecionará os três primeiros itens de feed de acordo com o ID, mas apenas se a impressão tiver sido gerada a partir de um dispositivo móvel.

Campo Valor válido
lhsOperand Pelo menos dois objetos FunctionArgumentOperand
operator AND
rhsOperand nenhum
Exemplo de string de função
AND(IN(FEED_ITEM_ID,{1000001,1000002,1000003}),EQUALS(CONTEXT.DEVICE,"Mobile"))

Ao combinar as funções, o lhsOperand pode consistir em:

Além disso, você só pode usar um FunctionOperand em uma Function de nível superior. Não é possível aninhar objetos FunctionOperand.

Veja a seguir alguns exemplos de strings de função válidas e inválidas:

String de função Válida Observações

AND(
 IN(FEED_ITEM_ID,{1000001,1000002,
   1000003}),
 EQUALS(CONTEXT.DEVICE,"Mobile"))
Sim Válida: consiste em uma função de ID de item de feed e uma função de plataforma

AND(
 CONTAINS_ANY(FeedAttribute[12345678,0],
   {"Mars cruise","Venus cruise",
    "Moon cruise"}),
 EQUALS(CONTEXT.DEVICE,"Mobile"))
Sim Válida: consiste em uma função de atributo de feed e uma função de plataforma

AND(
 CONTAINS_ANY(FeedAttribute[12345678,0],
   {"Mars cruise","Venus cruise",
    "Moon cruise"}),
 CONTAINS_ANY(FeedAttribute[12345678,2],
   {
     "140 million miles",
     "162 million miles"}))
Sim Válida: consiste em duas funções de atributo de feed

AND(
 IN(FEED_ITEM_ID,{1000001,1000002,
   1000003}),
 CONTAINS_ANY(FeedAttribute[12345678,0],
   {"Mars cruise","Venus cruise",
    "Moon cruise"}))
Não Inválida: não pode combinar funções de ID de item de feed e funções de atributo de feed

AND(
 AND(
  IN(FEED_ITEM_ID,
     {1000001,1000002,1000003}),
   EQUALS(CONTEXT.DEVICE,"Mobile")),
 AND(
   CONTAINS_ANY(
     FeedAttribute[12345678,0],
     {"Mars cruise","Venus cruise",
      "Moon cruise"}),
   CONTAINS_ANY(FeedAttribute[
     12345678,1],
     {"Free pretzels","Lunch included"})
 )
)
Não Inválida: não pode aninhar funções de combinação

Regras de operadores de função

Veja abaixo as regras de validação para cada Operator de função.

Operador IN
O rhsOperand precisa conter no mínimo um e no máximo 20 objetos ConstantOperand.
Operador EQUALS
O rhsOperand precisa conter exatamente um objeto ConstantOperand.
Operador AND
O lhsOperand precisa conter pelo menos dois objetos FunctionOperand. O rhsOperand não deve ser definido.
Operador CONTAINS_ANY
O rhsOperand precisa conter no mínimo um e no máximo três objetos ConstantOperand.
Operador IDENTITY
O lhsOperand precisa conter exatamente um ConstantOperand com o booleanValue definido. O rhsOperand não deve ser definido.

Regras da função CustomerFeed

A função CustomerFeed é compatível com qualquer tipo de marcador, exceto as extensões de chamada ou mensagem.

Em uma função de correspondência CustomerFeed, você pode usar qualquer um dos tipos de função ou combinações de funções, a menos que o CustomerFeed seja direcionado às extensões de local.

CustomerFeed para extensões de local

Um CustomerFeed para o tipo de marcador de local precisa ser uma das funções a seguir:

Regras das funções CampaignFeed e AdGroupFeed

Você pode usar todos os tipos de função e combinações de funções acima ao criar funções de correspondência para objetos CampaignFeed e AdGroupFeed.

Opções de segmentação do FeedItem

Além de especificar uma função de correspondência no nível do cliente, da campanha ou do grupo de anúncios, você também pode definir opções de segmentação em itens de feed individuais. Para isso, basta configurar os atributos campaignTargeting, adGroupTargeting ou keywordTargeting.

Essas opções de segmentação serão combinadas com a função de correspondência para selecionar quais itens de feed serão usados em uma determinada impressão.

Por exemplo, digamos que você crie um FeedItem para sitelinks com as seguintes opções de segmentação:

  • adGroupTargeting.TargetingAdGroupId = 12345
  • keywordTargeting.id = 7890

E, em seguida, defina um AdGroupFeed para o tipo de marcador 1 (sitelinks) com uma função de correspondência de plataforma para Mobile.

Ao veicular impressões para esse grupo de anúncios, o Google AdWords só veiculará sitelinks do FeedItem se os atributos de impressão satisfizerem ambas as opções de segmentação do FeedItem e a função de correspondência do AdGroupFeed.

Exemplo 1

Atributos de impressão: ID do grupo de anúncios 12345, palavra-chave 7890 e um usuário de computador.

Resultado: o FeedItem não será usado porque a plataforma (computador) não satisfaz a função de correspondência de AdGroupFeed.

Exemplo 2

Atributos de impressão: ID do grupo de anúncios 12345, palavra-chave 8910 e um usuário de dispositivo móvel.

Resultado: o FeedItem não será usado porque a palavra-chave (7890) não satisfaz as opções de segmentação de FeedItem.

Exemplo 3

Atributos de impressão: ID do grupo de anúncios 12345, palavra-chave 7890 e um usuário de dispositivo móvel.

Resultado: o FeedItem será usado porque os atributos satisfazem ambas as funções de correspondência de AdGroupFeed e as opções de segmentação de FeedItem.

Próximas etapas

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.