O que são seletores?

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

  • withCondition() — Use para especificar as condições que as entidades devem atender 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. A especificação de 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() — Use para especificar as IDs das entidades a serem selecionadas. Isto é equivalente a uma cláusula SQL IN .

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

  • forDateRange() — Use para retornar entidades com dados de desempenho que correspondam ao intervalo de datas especificado. Se uma condição especificar uma coluna métrica, você deverá incluir forDateRange na cadeia do seletor.

    Exemplo: forDateRange("LAST_14_DAYS")

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

    Exemplo: orderBy("Clicks DESC")

  • withLimit() — Use para retornar 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 (utilizando a notação de pontos) várias 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, use condições de filtro específicas para garantir que você recupere apenas as entidades desejadas. Depois de obter o seletor, chame o get() método para recuperar um iterador que você usa 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