通过

什么是选择器？

  • 项目

选择器允许你在检索Microsoft广告实体（如关键字和市场活动）时应用筛选和排序条件。 选择器提供的功能大致相当于 SQL WHERE 和 ORDER BY 子句。 选择器包括以下方法：

  • withCondition () - 用于指定选择实体必须满足的条件。 这等效于 SQL WHERE 子句。

    例如：withCondition('Name STARTS_WITH "Contoso"')

    可以将一个或多个条件应用于选择器。 指定多个条件被视为 AND 操作。 例如，仅当条件 A 为 true 且条件 B 为 true 时，才会选择实体。

  • withIds () — 用于指定要选择的实体的 ID。 这等效于 SQL IN 子句。

    例如：withIds(["1","2","3","4"])

  • forDateRange () - 用于返回具有与指定日期范围匹配的性能数据的实体。 如果条件指定指标列，则必须包含在 forDateRange 选择器的链中。

    例如：forDateRange("LAST_14_DAYS")

  • orderBy () — 用于对选择器按指定字段返回的实体进行排序。 这等效于 SQL ORDER BY 子句。

    例如：orderBy("Clicks DESC")

  • withLimit () - 使用 最多返回指定数量的实体。 这等效于 SQL TOP 子句。

    例如：withLimit(50)

由于每个方法返回应用了筛选条件的选择器，因此可以使用多个条件) 点表示法将 (链接在一起以优化筛选条件。 例如：

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

若要提高脚本性能，请使用特定的筛选条件来确保仅检索所需的实体。 获取选择器后，调用 get() 方法来检索用于循环访问实体列表的迭代器。

var campaigns = selector.get();

或

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

下面是选择器的列表。

后续步骤

了解迭代器