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. A função de correspondência consiste em três campos:

Campo Tipo
lhsOperand FunctionArgumentOperand
operator Function.Operator
rhsOperand FunctionArgumentOperand

Por exemplo, em uma função que seleciona FeedItems com feedItemId de 1000001, 1000002 ou 1000003, os atributos são os seguintes:

  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 para a criação de objetos "operand" e "operator". É possível criar uma função equivalente para o exemplo acima usando a seguinte string de função:

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 explicarão as diferentes regras utilizadas pela AdWords API para validação das funções de correspondência.

Exemplo de itens de feed

Este guia utilizará como exemplos os seguintes itens de feed do ID de feed fictício 12345678.

ID de FeedItem Atributo 0
Nome
Atributo 1
Linha 2
Atributo 2
Linha 3
Atributo 3
URLs finais
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 de item de feed

Com esse tipo de função, é possível selecionar itens de feed, especificando seus respectivos feedItemIds.

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 seus respectivos IDs de item 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 atributo específico de um FeedItem.

A string de função abaixo selecionará o primeiro, o segundo e o quarto item de feed de acordo com seus respectivos valores 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
  • no máximo 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.

A string de função abaixo não selecionará nenhum dos itens do feed no feed. Use esse tipo de função para desativar as extensões de anúncios de um tipo específico no nível de cliente, campanha ou grupo de anúncios.

Você também pode usar uma string de função de IDENTITY(true), que selecionará todos os itens de feed presentes no feed. No entanto, deve-se fazer isso somente em um CustomerFeed para locais.

Campo Valor válido
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 FunctionOperands com o operador AND para combinar logicamente duas ou mais funções e 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 de item de feed, mas apenas se a impressão for para um dispositivo móvel.

Campo Valor válido
lhsOperand Pelo menos dois FunctionArgumentOperands
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 função de nível superior. Não é possível aninhar FunctionOperands.

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

O CustomerFeed só pode ter um dos seguintes tipos de marcador de posição:

Em uma função de correspondência de CustomerFeed, é possível usar todos os tipos de função e combinações de funções acima, exceto quando o CustomerFeed é para locais.

CustomerFeed para locais

O CustomerFeed para o tipo de marcador de posição de local precisa ser um dos seguintes:

OU

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 de cliente, campanha ou grupo de anúncios, você também pode definir opções de segmentação em itens de feed individuais, configurando 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 de posição 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 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.