ตัวเลือกช่วยให้โปรแกรมเมอร์สร้างคําค้นหาที่ดึงข้อมูลเอนทิตี Google Ads ที่ต้องการได้ ตัวเลือกช่วยให้ผู้ใช้จำกัดรายการเอนทิตีที่ดึงข้อมูลและจัดเรียงรายการได้ ตัวเลือกส่วนใหญ่มีวิธีการดังต่อไปนี้
withCondition()- เพิ่มเงื่อนไขลงในตัวเลือก หากมีการใช้เงื่อนไขหลายรายการ ระบบจะใช้ตรรกะ AND ร่วมกัน กล่าวคือ ตัวเลือกจะแสดงเฉพาะเอนทิตีที่เป็นไปตามเงื่อนไขที่ระบุทั้งหมด
withIds()- เพิ่มคอลเล็กชันรหัสเป็นเงื่อนไข ระบบจะรวมเงื่อนไขตามรหัสเข้ากับเงื่อนไขอื่นๆ ทั้งหมดโดยใช้ AND
forDateRange()- ต้องระบุเมื่อเงื่อนไขหรือคำสั่งการจัดเรียงอ้างอิงถึงช่องสถิติ เช่น อัตรา CTR หรือการแสดงผล หากคุณขอแคมเปญทั้งหมดที่มีการแสดงผลมากกว่า 100 ครั้ง สคริปต์ Google Ads จะต้องทราบช่วงวันที่ที่จะตรวจสอบ
orderBy()- ระบุลําดับของเอนทิตีที่แสดงผล
withLimit()- จํากัดจํานวนเอนทิตีที่แสดงผลเป็นค่าที่ระบุ ซึ่งมีประโยชน์อย่างยิ่งเมื่อใช้ร่วมกับ
orderBy()เพื่อดึงข้อมูลต่างๆ เช่น "คีย์เวิร์ด 10 รายการที่มีการแสดงผลมากที่สุดเมื่อวาน" โดยค่าเริ่มต้น ตัวเลือกทั้งหมดจะตั้งค่าขีดจํากัดไว้ที่ 50,000 คุณสามารถเพิ่มขีดจํากัดได้โดยระบุขีดจํากัดด้วยตนเอง
เรียกเมธอดเหล่านี้ตามลำดับใดก็ได้ ข้อยกเว้นอย่างหนึ่งคือ orderBy() ซึ่งลำดับการเรียกใช้มีความสำคัญอย่างยิ่ง การเรียกใช้เมธอดนี้หลายครั้งจะระบุเงื่อไขการจัดเรียงหลายรายการ และระบบจะใช้ตามลำดับ ลองดูตัวอย่างข้อมูลต่อไปนี้
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
ผลลัพธ์จะจัดเรียงตามจํานวนคลิกจากมากไปน้อย ผลลัพธ์ที่มีค่า "จำนวนคลิก" เท่ากัน จะเรียงลำดับตาม CTR จากน้อยไปหามาก
การเรียกใช้เมธอดของตัวเลือกสามารถต่อเชื่อมกันได้ รหัสต่อไปนี้
var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");
เขียนใหม่ให้กระชับยิ่งขึ้นได้ดังนี้
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
เมื่อสร้างตัวเลือกแล้ว ผู้ใช้จะขอรับ Iterator จากตัวเลือกได้โดยเรียกใช้ selector.get()
อ่านแนวทางปฏิบัติแนะนำเพื่อดูเคล็ดลับเกี่ยวกับการใช้ตัวเลือกอย่างมีประสิทธิภาพ