Partilhar via

O que são seletores?

Os seletores permitem-lhe aplicar critérios de filtragem e ordenação ao obter entidades do Microsoft Advertising, como palavras-chave e campanhas. Os seletores fornecem uma funcionalidade aproximadamente equivalente ao SQL WHERE e ORDER BY às cláusulas. Os seletores incluem os seguintes métodos:

  • withCondition() — utilize para especificar condições que as entidades têm de cumprir para serem selecionadas. Isto é equivalente a uma cláusula SQL WHERE .

    Exemplo: withCondition('Name STARTS_WITH "Contoso"')

    Pode aplicar uma ou mais condições a um seletor. Especificar várias condições é considerada uma operação E. Por exemplo, a entidade só é selecionada se a condição A for verdadeira E a condição B for verdadeira.

  • withIds() — utilize para especificar os IDs das entidades a selecionar. Isto é equivalente a uma cláusula SQL IN .

    Exemplo: withIds(["1","2","3","4"])

  • forDateRange() — utilize para devolver entidades com dados de desempenho que correspondam ao intervalo de datas especificado. Se uma condição especificar uma coluna de métrica, tem de incluir forDateRange na cadeia do seletor.

    Exemplo: forDateRange("LAST_14_DAYS")

  • orderBy() — utilize para ordenar as entidades que o seletor devolve por um campo especificado. Isto é equivalente a uma cláusula SQL ORDER BY .

    Exemplo: orderBy("Clicks DESC")

  • withLimit() — utilize para devolver, no máximo, o número especificado de entidades. Isto é equivalente a uma cláusula SQL TOP .

    Exemplo: withLimit(50)

Uma vez que cada método devolve o seletor com os critérios de filtro aplicados, pode encadear em conjunto (utilizando notação de pontos) múltiplas condições para refinar os critérios de filtro. Por exemplo:

var selector = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10);

Para melhorar o desempenho do script, utilize condições de filtro específicas para garantir que obtém apenas as entidades que pretende. Depois de obter o seletor, chame o get() método para obter um iterador que utiliza para iterar através da lista de entidades.

var campaigns = selector.get();

Ou

var campaigns = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10)
    .get();

Segue-se a lista de seletores.

Passos seguintes

Saiba mais sobre iteradores

  • Last updated on