Aracılığıyla paylaş


Seçiciler nedir?

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

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

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

    Bir seçiciye bir veya daha fazla koşul uygulayabilirsiniz. Birden çok koşul belirtmek bir AND 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çecek varlıkların kimliklerini belirtmek için kullanın. Bu, SQL IN yan tümcesine 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ın. Bir koşul ölçüm sütununu belirtiyorsa, seçicinin zincirine eklemeniz forDateRange 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, SQL ORDER BY yan tümcesine eşdeğerdir.

    Örnek: orderBy("Clicks DESC")

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

    Örnek: withLimit(50)

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

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

Betik performansını geliştirmek için belirli filtre koşullarını kullanarak yalnızca istediğiniz varlıkları almanızı sağlayın. Seçiciyi aldıktan sonra, varlık listesinde yinelemek için kullandığınız bir yineleyiciyi almak için yöntemini ç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();

Aşağıda seçicilerin listesi yer alır.

Sonraki adımlar