什麼是選擇器？

選取器可讓您在擷取 Microsoft Advertising 實體時套用篩選和排序準則，例如關鍵字和廣告活動。 選取器提供的功能大致相當於 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();

下列是選取器清單。

後續步驟

深入了解反覆運算器

  • Last updated on