¿Qué son los selectores?

  • Artículo

Los selectores permiten aplicar criterios de filtro y ordenación al recuperar entidades de Microsoft Advertising, como palabras clave y campañas. Los selectores proporcionan una funcionalidad aproximadamente equivalente a SQL WHERE y ORDER BY cláusulas. Los selectores incluyen los métodos siguientes:

  • withCondition(): se usa para especificar las condiciones que deben cumplir las entidades para seleccionarse. Esto equivale a una cláusula SQL WHERE .

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

    Puede aplicar una o varias condiciones a un selector. La especificación de varias condiciones se considera una operación AND. Por ejemplo, la entidad solo se selecciona si la condición A es true Y la condición B es true.

  • withIds(): se usa para especificar los identificadores de las entidades que se van a seleccionar. Esto equivale a una cláusula SQL IN .

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

  • forDateRange(): se usa para devolver entidades con datos de rendimiento que coincidan con el intervalo de fechas especificado. Si una condición especifica una columna de métrica, debe incluirla forDateRange en la cadena del selector.

    Ejemplo: forDateRange("LAST_14_DAYS")

  • orderBy(): se usa para ordenar las entidades que devuelve el selector por un campo especificado. Esto equivale a una cláusula SQL ORDER BY .

    Ejemplo: orderBy("Clicks DESC")

  • withLimit(): se usa para devolver como máximo el número especificado de entidades. Esto equivale a una cláusula SQL TOP .

    Ejemplo: withLimit(50)

Dado que cada método devuelve el selector con los criterios de filtro aplicados, puede encadenar (mediante notación de puntos) varias condiciones para refinar los criterios de filtro. Por ejemplo:

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

Para mejorar el rendimiento del script, use condiciones de filtro específicas para asegurarse de recuperar solo las entidades que desee. Después de obtener el selector, llame al get() método para recuperar un iterador que se usa para recorrer en iteración la lista de entidades.

var campaigns = selector.get();

O bien

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

A continuación se muestra la lista de selectores.

Pasos siguientes

Más información sobre los iteradores