Cenários do lance

Com os cenários do lance, é possível estimar o desempenho dos seus grupos de anúncios, critérios e campanhas usando diferentes situações de lances. Você pode utilizar essas informações para ajustar e otimizar sua estratégia de lance.

Os serviços de cenário do lance da API estimam como a alteração do seu lance de diversas maneiras afeta o custo, as impressões e os cliques. Isso é análogo aos Simuladores de lances na interface do usuário do Google AdWords.

Caso de uso

Digamos que você tenha um anúncio em exibição há algumas semanas, e ele esteja custando muito mais do que o esperado ou desejado.

Você deseja testar o que aconteceria se reduzisse seus lances. Quantas visualizações e cliques a menos seu anúncio receberia? Qual seria a diferença de preço? Por outro lado, e se seu anúncio não estivesse gerando o número esperado de impressões e cliques, e você quisesse saber como definir seus lances para corrigir isso?

Os cenários do lance ajudarão você a pesquisar essas situações. Quando você busca um cenário do lance, são exibidas estimativas de visualizações, cliques e custo para o mesmo período em que seu anúncio estava em exibição.

Com os cenários do lance, é possível examinar as estatísticas de desempenho da semana anterior no nível atual de lance, além do desempenho simulado para o mesmo período usando diferentes valores de lance.

By analyzing how your ads might have performed differently in the past, you can make more informed decisions about how to adjust your bids and campaign–level bid modifiers for the future.

Requisitos

Para usar os cenários do lance, a campanha precisa atender aos seguintes requisitos:

  • Você precisa ter um grupo de anúncios, uma campanha ou um critério estabelecido para fornecer informações de base ao sistema, a partir das quais as previsões serão geradas.
  • O acompanhamento de conversões precisa estar ativado.
  • A conta não pode ser de teste. Os cenários do lance têm como base o desempenho anterior. Como as contas de teste não veiculam anúncios, elas não possuem histórico de desempenho.

Além disso, serão retornadas apenas as informações relacionadas à parte da campanha segmentada para a rede de pesquisa. Os cenários do lance não funcionam com dados da Rede de Display.

Como fazer uma solicitação

Ao recuperar dados do cenário do lance, o serviço da API retorna um objeto BidLandscape com informações sobre o período, a campanha, o grupo de anúncios ou o critério em que os dados se baseiam. O período sempre terá como base uma data anterior, já que os cenários do lance estimam o desempenho dos seus anúncios nesse período e sob as mesmas condições. Porém, são utilizados diferentes modificadores de lance no nível da campanha ou do lance.

O objeto BidLandscape também inclui uma sequência de pontos de cenário que, combinados, oferecem um histograma do desempenho previsto com diferentes lances ou modificadores de lance para celular no nível da campanha durante esse período.

Você pode solicitar três tipos de cenário de lances e modificadores de lance para celular pelo DataService. O cenário escolhido dependerá do nível em que você deseja ajustar os lances: do critério, do grupo de anúncios ou da campanha. Os métodos get() ou query() são nomeados conforme o nível:

Como buscar critérios e grupos de anúncios nos cenários do lance

No exemplo abaixo, suponha que os lances estejam definidos no nível de um critério. O processo de busca por cenários do lance para grupos de anúncios é semelhante.

A busca por cenários do lance é semelhante a qualquer outra consulta: selecione os campos desejados, configure os predicados para restringir a consulta somente aos grupos de anúncios ou critérios convenientes e faça a chamada get() ou query() para buscar os dados.

A documentação de referência de BidLandscape e LandscapePoint lista todos os campos válidos que podem ser filtrados e selecionados.

Independentemente de o campo de seu interesse estar em BidLandscape ou LandscapePoint, inclua-o no mesmo seletor ou predicado. Os campos BidModifier, TotalLocalClicks, TotalLocalCost, TotalLocalImpressions e RequiredBudget são compatíveis apenas com solicitações de cenário do modificador de lance para celular de campanhas. Quando os dados são retornados, os campos são inseridos automaticamente no local adequado no SOAP e nas implementações da biblioteca cliente. Os campos de LandscapePoints serão preenchidos para cada LandscapePoint que for retornado em BidLandscape.

DataServiceInterface dataService =
    adWordsServices.get(session, DataServiceInterface.class);
Selector selector = new SelectorBuilder()
    .fields(
        "AdGroupId",
        "CriterionId",
        "StartDate",
        "EndDate",
        "Bid",
        "LocalClicks",
        "LocalCost",
        "LocalImpressions") // Include whichever fields interest you
    .equals("AdGroupId", adGroupId.toString())
    .build();
CriterionBidLandscapePage page =
    dataService.getCriterionBidLandscape(selector);

Como buscar cenários do modificador de lance para celular nas campanhas

A busca por cenários do modificador de lance para celular no nível da campanha é semelhante à busca por lances no nível do grupo de anúncios ou do critério. Os campos de LandscapePoints serão preenchidos para cada LandscapePoint que for retornado em BidLandscape. Consulte a documentação de referência de BidLandscape e LandscapePoint para ver quais campos podem ser selecionados e filtrados. Independentemente de o campo estar em BidLandscape ou LandscapePoint, você deve inclui-lo no mesmo seletor ou predicado.

Este exemplo mostra como buscar cenários do modificador de lance para celular no nível da campanha:

DataServiceInterface dataService =
    adWordsServices.get(session, DataServiceInterface.class);
Selector selector = new SelectorBuilder()
    .fields(
        "BidModifier",
        "CampaignId",
        "CriterionId",
        "StartDate",
        "EndDate",
        "LocalClicks",
        "LocalCost",
        "LocalImpressions",
        "TotalLocalImpressions",
        "RequiredBudget") // Include whichever fields interest you
    .equals("CampaignId", campaignId.toString())
    .build();
CriterionBidLandscapePage page =
    dataService.getCampaignCriterionBidLandscape(selector);

Paginação de resultados

O comportamento de CriterionBidLandscapePage (retornado por [get|query]CriterionBidLandscape e [get|query]CampaignCriterionBidLandscape) e AdGroupBidLandscapePage (retornado por [get|query]AdGroupBidLandscape) é diferente de outros tipos de página. Em vez de incrementar paging.startIndex e fazer solicitações até paging.startIndex >= page.totalNumEntries, no caso de uma solicitação de cenário do lance, é necessário:

  • incrementar paging.startIndex pelo número de pontos de cenário internos encontrados em cada resposta;
  • continuar fazendo solicitações até que o número de pontos de cenário internos encontrados na última resposta seja menor que o paging.numberResults (tamanho da página) especificado no seu seletor.

O exemplo abaixo demonstra como isso pode ser feito em Java.

selector.getPaging().setNumberResults(PAGE_SIZE); // Set to your desired
                                                  // page size.
int landscapePointsInLastResponse = 0;
int offset = 0;
do {
  // Offset by the number of landscape points, NOT the number
  // of entries (bid landscapes) in the last response.
  offset += landscapePointsInLastResponse;
  selector.getPaging().setStartIndex(offset);
  landscapePointsInLastResponse = 0;
  CriterionBidLandscapePage page = dataService
    .getCriterionBidLandscape(selector);
  if (page.getEntries() != null) {
    for (CriterionBidLandscape bidLandscape : page.getEntries()) {
      for (BidLandscapeLandscapePoint landscapePoint : bidLandscape
        .getLandscapePoints()) {
        // Process results...
        landscapePointsInLastResponse++;
      }
    }
  }
} while (landscapePointsInLastResponse >= PAGE_SIZE);

Você pode conferir um exemplo completo em cada biblioteca cliente.

Como entender os resultados

Os resultados retornam vários lances e o desempenho esperado em cada nível. Veja um exemplo de uma possível resposta em XML para uma dessas solicitações.

<landscapePoints>
  <bid>
    <ComparableValue.Type>Money</ComparableValue.Type>
    <microAmount>990000</microAmount>
  </bid>
  <clicks>278000</clicks>
  <cost>
    <ComparableValue.Type>Money</ComparableValue.Type>
    <microAmount>14500000000</microAmount>
  </cost>
  <impressions>648000</impressions>
  <promotedImpressions>0</promotedImpressions>
</landscapePoints>

Todos os elementos que você pode receber dos LandscapePoints estão representados acima. O valor promotedImpressions indica quantas vezes a impressão estava em uma posição "promovida" na página de pesquisa, isto é, na parte superior dela.

O snippet em XML acima mostra um LandscapePoint. No entanto, cada BidLandscape terá uma sequência desses pontos com um valor diferente de lance ou modificador de lance para celular, além de estatísticas correspondentes ajustadas à conta para o lance ou modificador de lance alterado. Cabe a você interpretar os resultados. Porém, os dados fornecidos oferecerão informações úteis para determinar como os ajustes de lances e modificadores de lance para celular poderão afetar o desempenho.

Recursos

Enviar comentários sobre…

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