แชร์ผ่าน

ตัวเลือกคืออะไร

  • บทความ

ตัวเลือกช่วยให้คุณใช้เกณฑ์ตัวกรองและเรียงลําดับเมื่อเรียกใช้เอนทิตีการโฆษณาของ Microsoft เช่น คีย์เวิร์ดและแคมเปญ Selector มีฟังก์ชันการทํางานที่เทียบเท่ากับ SQL WHERE และ ORDER BY ส่วนคําสั่งโดยประมาณ ตัวเลือกมีวิธีการต่อไปนี้:

  • withCondition() — ใช้เพื่อระบุเงื่อนไขที่เอนทิตีต้องตรงกับที่เลือกไว้ ซึ่งเทียบเท่ากับส่วนคําสั่ง SQL WHERE

    ตัว อย่าง เช่น: withCondition('Name STARTS_WITH "Contoso"')

    คุณอาจใช้เงื่อนไขอย่างน้อยหนึ่งข้อกับตัวเลือก การระบุหลายเงื่อนไขจะถือว่าเป็นการดําเนินการ AND ตัวอย่างเช่น เอนทิตีจะถูกเลือกเฉพาะเมื่อเงื่อนไข A เป็นจริงและเงื่อนไข B เป็นจริง

  • 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();

ต่อไปนี้คือรายการของตัวเลือก

ขั้นตอนถัดไป

เรียนรู้เกี่ยวกับตัวทําซ้ํา