共用方式為

什麼是選取器？

  • 發行項

選取器可讓您在擷取Microsoft廣告實體時套用篩選和排序準則，例如關鍵詞和營銷活動。 選取器提供的功能大致相當於 SQL WHERE 和 ORDER BY 子句。 選取器包含下列方法：

  • withCondition () — 用來指定實體必須符合才能選取的條件。 這相當於 SQL WHERE 子句。

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

    您可以將一或多個條件套用至選取器。 指定多個條件會被視為 AND 作業。 例如，只有在條件 A 為 true 且條件 B 為 true 時，才會選取實體。

  • withIds () — 用來指定要選取之實體的標識碼。 這相當於 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();

以下是選取器的清單。

後續步驟

瞭解反覆運算器