Seletores

Os seletores ajudam o programador a construir a consulta que coleta as entidades desejadas do Google AdWords. Com eles, é possível restringir a lista de entidades recuperadas e classificá-la. A maioria dos seletores usa os seguintes métodos:

withCondition()
adiciona uma condição a um seletor. Se várias condições forem usadas, elas serão associadas com AND. Em outras palavras, o seletor retornará apenas as entidades que atendem a todas as condições especificadas.
withIds()
adiciona um conjunto de IDs como uma condição. Uma condição com base em IDs será associada com AND a todas as outras.
forDateRange()
é necessário quando uma instrução de condição ou de classificação faz referência a um campo de estatísticas (como "Ctr" ou "Impressions"). Se você solicitar todas as campanhas com mais de cem impressões, os scripts do Google AdWords precisarão "saber" o período onde pesquisar.
orderBy()
especifica a classificação das entidades retornadas.
withLimit()
limita o número de entidades retornadas no valor especificado. É particularmente útil com orderBy(). Assim, é possível buscar itens como "10 palavras-chave com mais impressões ontem".

Esses métodos podem ser chamados em qualquer ordem. Uma exceção é orderBy(), no qual a ordem das chamadas realmente importa: várias chamadas para esse método especificarão várias condições de classificação que serão aplicadas na ordem. Considere o snippet a seguir:

selector = selector.forDateRange("LAST_14_DAYS")
    .orderBy("Clicks DESC")
    .orderBy("CTR ASC");

Os resultados serão classificados por cliques em ordem decrescente. Os resultados com a mesma quantidade de cliques serão classificados por "Ctr", em ordem crescente.

As chamadas para os métodos de um seletor podem ser associadas. O código a seguir

var campaignSelector = AdWordsApp.campaigns();
campaignSelector.withCondition("Clicks > 10");
campaignSelector.withCondition("Impressions > 1000");
campaignSelector.orderBy("Impressions DESC");
campaignSelector.forDateRange("YESTERDAY");

pode ser reescrito de uma forma mais compacta:

var campaignSelector = AdWordsApp.campaigns()
  .withCondition("Clicks > 10")
  .withCondition("Impressions > 1000")
  .orderBy("Impressions DESC")
  .forDateRange("YESTERDAY");

Depois que o seletor for construído, será possível conseguir um Iterador dele chamando selector.get().

Alguns seletores (por exemplo, AdParamSelector e LabelSelector) expõem menos métodos, já que eles operam em entidades mais restritas (não possuem estatísticas ou campos significativos pelos quais classificar).

Leia as Práticas recomendadas para dicas e truques sobre o uso eficiente de seletores.

Enviar comentários sobre…

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