Regras de valor da conversão

As regras de valor da conversão permitem definir ações que vão modificar o valor de uma conversão com base na categoria do ConversionAction e nas seguintes dimensões de uma impressão:

• Associação do público-alvo
• Local físico ou local de interesse
• Dispositivo
• Itinerário de viagem

Use a API Google Ads para definir regras de valor da conversão, combiná-las em um conjunto de regras de valor da conversão e aplicar esse conjunto a toda a conta do Google Ads ou a uma campanha específica. Os segmentos nos relatórios da API Google Ads fornecem detalhamentos para que você possa comparar as partes originais, não ajustadas e ajustadas dos seus valores de conversão.

Criar regras

A primeira etapa para usar as regras de valor da conversão é criar pelo menos uma ConversionValueRule, que consiste em:

• As condições que determinam quando a regra é aplicada
• A ação a ser realizada quando a regra é aplicada.

Observação: até que um ConversionValueRule seja adicionado a um ConversionValueRuleSet, não será possível visualizá-lo na interface do Google Ads.

Por exemplo, o payload JSON a seguir para ConversionValueRuleService.MutateConversionValueRules cria uma regra que multiplica os valores de conversão por 1.5 para impressões em dispositivos móveis:

{
  "operations": [
    {
      "create": {
        "action": {
          "operation": "MULTIPLY",
          "value": 1.5
        },
        "deviceCondition": {
          "deviceTypes": ["MOBILE"]
        }
      }
    }
  ]
}

Condições da regra

Defina as condições de um ConversionValueRule com os seguintes campos:

audience_condition

Aplica a regra às impressões associadas a um ou mais públicos-alvo. Especifique os nomes de recursos de cada lista ou interesse do usuário com os campos user_lists ou user_interests. Para recuperar os nomes de recursos de listas de usuários ou interesses de usuários disponíveis, emita uma solicitação searchStream ou search de GoogleAdsService em que a cláusula FROM da consulta seja user_list ou user_interest, respectivamente.

Se um audience_condition tiver várias listas ou interesses de usuários, uma impressão vai corresponder à regra se estiver associada a qualquer uma das listas ou interesses de usuários.

device_condition

Aplica a regra se o dispositivo da impressão corresponder a qualquer um dos device_types especificados. Somente os tipos de dispositivo em ValueRuleDeviceType são permitidos.

geo_location_condition

Aplica a regra às impressões em que as informações de localização correspondem a qualquer um dos geo_target_constants especificados para o geo_match_type e não correspondem a nenhum dos excluded_geo_target_constants para o excluded_geo_match_type. Consulte o guia de segmentação por local para saber como recuperar nomes de recursos de local.

itinerary_condition

Aplica a regra a impressões em que os termos de pesquisa incluem informações específicas do itinerário, como janela de reserva, duração da viagem ou dia de início da viagem. Consulte ValueRuleItineraryCondition para mais detalhes sobre as condições disponíveis.

Importante: as regras de valor da conversão para itinerário de viagem estão disponíveis apenas para contas adicionadas à lista de permissões. Entre em contato com seu representante do Google se precisar de acesso ao recurso.

É possível especificar no máximo dois de audience_condition, device_condition, geo_location_condition ou itinerary_condition em cada ConversionValueRule.

Uma regra sem condições especificadas se aplica a impressões que não atendem às condições de uma regra mais específica no mesmo conjunto de regras.

Ação de regra

Uma regra precisa ter um único action, que consiste em um operation e um value. A ação define como ajustar o valor de uma conversão que atende às condições da regra. As operações disponíveis são as seguintes:

ADD

Adiciona o value ao valor original da conversão. O value precisa ser maior que 0.

MULTIPLY

Multiplica o valor original da conversão pelo value especificado. O value precisa ser maior ou igual a 0.5 e menor ou igual a 10.

SET

Define o valor da conversão como o value especificado. O value precisa ser maior que 0.

Só é possível usar uma regra com a ação SET em um conjunto de regras que atenda às condições descritas em Como criar um conjunto de regras.

Outros atributos de regra

Além das condições e de uma ação, um ConversionValueRule tem os seguintes atributos.

owner_customer

O nome do recurso do Customer que é proprietário da regra. Use essa opção para determinar se uma regra é definida na conta ou em uma das contas de administrador dela.

status

O status da regra. É possível pausar uma regra definindo esse campo como PAUSED e ativar uma regra pausada definindo esse campo como ENABLED.

Criar conjuntos de regras

Depois de ter pelo menos um ConversionValueRule, é possível criar um ConversionValueRuleSet, que consiste em:

conversion_action_categories

Uma lista de categorias de ações de conversão às quais esse conjunto de regras se aplica. Se a lista estiver vazia, o conjunto de regras será aplicado a todas as categorias. Se a lista não estiver vazia, ela precisará conter uma única entrada de STORE_VISIT ou STORE_SALE.

Só é possível definir a lista de categorias de ações de conversão ao criar o conjunto de regras.

conversion_value_rules

Os nomes de recursos das regras a serem incluídas no conjunto.

Essa lista só pode conter uma regra que use a ação SET se uma destas condições for atendida:

• Sua conta está na lista de permissões, e o conversion_action_categories do conjunto de regras está vazio.
• O conversion_action_categories do conjunto contém apenas uma entrada de STORE_VISIT ou STORE_SALE, o dimensions do conjunto contém apenas uma entrada para NO_CONDITION e nenhum dos campos de condição da regra está definido.

Importante: cada regra de valor da conversão só pode ser incluída em um conjunto de regras de valor da conversão. Se o conversion_value_rules contiver o nome do recurso de uma regra que está no conversion_value_rules de outro conjunto de regras com status de ENABLED ou PAUSED, a operação vai falhar com um erro DATA_CONSTRAINT_VIOLATION.

dimensions

Uma lista de valores de tipo enumerado ValueRuleSetDimension que indica quais condições as regras no conjunto podem usar. Por exemplo, se dimensions contiver GEO_LOCATION e DEVICE, será possível adicionar regras com geo_location_condition ou device_condition ao conjunto, mas não será possível adicionar uma regra com audience_condition.

Essa lista não pode estar vazia e pode conter no máximo duas entradas.

A primeira entrada nessa lista determina qual valor aparece para segments.conversion_value_rule_primary_dimension em métricas.

Se essa lista tiver uma entrada para NO_CONDITION, então:

• NO_CONDITION precisa ser a única entrada na lista.
• A lista de conversion_action_categories do conjunto precisa conter apenas uma única entrada de STORE_VISIT ou STORE_SALE.
• A lista de conversion_value_rules não pode conter nenhuma regra em que audience_condition, device_condition ou geo_location_condition esteja definido.

attachment_type

Defina esse valor como CUSTOMER para criar um conjunto de regras que se aplica a toda a conta ou como CAMPAIGN para criar um conjunto de regras para uma campanha específica.

campaign

Se o attachment_type do conjunto de regras for CAMPAIGN, defina-o como o nome do recurso ao qual o conjunto de regras se aplica.

Assim como as regras, um conjunto de regras também tem um owner_customer e um status. No entanto, o status de um conjunto de regras é somente leitura e derivado das regras da seguinte maneira:

• Se todas as regras referenciadas por conversion_value_rules tiverem um status de PAUSED, o conjunto de regras de valor da conversão status será PAUSED.
• Caso contrário, o conjunto de regras de valor da conversão status será ENABLED.

Remover regras e conjuntos de regras

• Um ConversionValueRuleSet precisa ter pelo menos uma regra de valor da conversão que seja PAUSED ou ENABLED.

• A remoção de um ConversionValueRule referenciado no conversion_value_rules de um PAUSED ou ENABLED ConversionValueRuleSet vai falhar.

• A remoção de um ConversionValueRuleSet não altera o status de cada ConversionValueRule referenciado pelo conjunto.

• Depois que um ConversionValueRuleSet é removido, as solicitações search e searchStream para o recurso conversion_value_rule_set não retornam mais o conjunto removido.

Precedência de regras e conjuntos de regras

O Google Ads usa a lógica a seguir para selecionar e aplicar no máximo uma regra a cada conversão. Encontre mais informações sobre essas regras na Central de Ajuda do Google Ads:

1. Determine o attachment_type dos conjuntos de regras a serem considerados. Se houver qualquer conjunto de regras com attachment_type = CAMPAIGN e campaign definidos para a campanha associada à impressão, considere apenas os conjuntos de regras no nível da campanha. Caso contrário, considere apenas os conjuntos de regras no nível do cliente.

2. Entre os conjuntos de regras a serem considerados, escolha aquele em que o conversion_action_categories não está vazio e contém a categoria da ação de conversão, se houver um conjunto de regras desse tipo. Caso contrário, escolha o conjunto de regras em que conversion_action_categories está vazio.

3. Avalie as regras no conjunto de regras escolhido na ordem em que aparecem em conversion_value_rules e selecione a primeira regra com condições que correspondam à impressão.

4. Para várias condições de localização geográfica correspondentes, o local mais preciso é aplicado. Por exemplo, se uma impressão corresponder às condições dos Estados Unidos e da Califórnia, a da Califórnia será aplicada porque é um local exato.

5. Para várias condições de público-alvo correspondentes, a hierarquia de atribuição de público-alvo atual será aplicada. Se houver um empate entre duas regras em um conjunto, a regra "Multiplicar" será selecionada em vez da regra "Adicionar". Se ainda houver empate, ou seja, se houver mais de uma regra "Multiplicar", será aplicada a regra com o ajuste que tem o maior multiplicador.

6. Não é possível ter várias condições de dispositivo correspondentes, porque as categorias de dispositivo são mutuamente exclusivas.

7. Para condições de itinerário de viagem, a regra de itinerário mais específica é aplicada. Isso significa que, se várias regras corresponderem a uma determinada conversão, a regra usada será aquela com o maior número de opções de itinerário definidas, como "Janela de reserva futura" ou "Duração da viagem".

Métricas

Os campos metrics.conversions_value e metrics.all_conversions_value, assim como os campos derivados dessas métricas, refletem as modificações feitas pelos conjuntos de regras de valor da conversão. Além disso, é possível incluir segments.conversion_value_rule_primary_dimension na consulta para mais informações sobre como as regras foram aplicadas. Os valores possíveis para esse segmento são os seguintes:

NO_RULE_APPLIED

Valores de conversões em que nenhuma regra foi aplicada.

ORIGINAL

O valor original das conversões em que uma regra foi aplicada.

GEO_LOCATION, DEVICE, AUDIENCE ou NO_CONDITION

O valor das conversões após a aplicação de uma regra, agrupado pela primeira entrada na coleção dimensions do conjunto de regras.