Seçiciler nedir?

Seçiciler, anahtar sözcükler ve kampanyalar gibi Microsoft Advertising varlıklarını alırken filtreleme ve sıralama ölçütleri uygulamanıza olanak tanır. Seçiciler, SQL WHERE ve ORDER BY yan tümcelere kabaca eşdeğer işlevsellik sağlar. Seçiciler aşağıdaki yöntemleri içerir:

  • withCondition() — Varlıkların seçilmek için karşılaması gereken koşulları belirtmek için kullanın. Bu bir SQL WHERE yan tümcesiyle eşdeğerdir.

    Örnek: withCondition('Name STARTS_WITH "Contoso"')

    Bir seçiciye bir veya daha fazla koşul uygulayabilirsiniz. Birden çok koşul belirtmek, VE işlemi olarak kabul edilir. Örneğin, varlık yalnızca A koşulu doğruysa VE B koşulu doğruysa seçilir.

  • withIds() — Seçilecek varlıkların kimliklerini belirtmek için kullanın. Bu bir SQL IN yan tümcesiyle eşdeğerdir.

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

  • forDateRange() — Belirtilen tarih aralığıyla eşleşen performans verilerine sahip varlıkları döndürmek için kullanılır. Bir koşul bir metrik sütun belirtiyorsa, seçici zincirine dahil forDateRange etmeniz gerekir.

    Örnek: forDateRange("LAST_14_DAYS")

  • orderBy() — Seçicinin döndürdüğü varlıkları belirtilen bir alana göre sıralamak için kullanın. Bu bir SQL ORDER BY yan tümcesiyle eşdeğerdir.

    Örnek: orderBy("Clicks DESC")

  • withLimit() — En fazla belirtilen sayıda varlığı döndürmek için kullanın. Bu bir SQL TOP yan tümcesiyle eşdeğerdir.

    Örnek: withLimit(50)

Her yöntem, filtre ölçütlerinin uygulandığı seçiciyi döndürdüğünden, filtre ölçütlerini daraltmak için birden çok koşulu birbirine zincirleyebilirsiniz (nokta gösterimi kullanarak). Örneğin:

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

Betik performansını artırmak için, yalnızca istediğiniz varlıkları aldığınızdan emin olmak için belirli filtre koşullarını kullanın. Seçiciyi aldıktan sonra, varlık listesini yinelemek için kullandığınız yineleyiciyi almak için yöntemi çağırın get() .

var campaigns = selector.get();

Veya

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

Seçicilerin listesi aşağıdadır.

Sonraki adımlar

Yineleyiciler hakkında bilgi edinin

  • Last updated on