ตัวเลือกจะช่วยโปรแกรมเมอร์สร้างการค้นหาที่ดึงเอนทิตี Google Ads ที่ต้องการ ตัวเลือกช่วยให้จำกัดรายการเอนทิตีที่ดึงมาและเรียงลำดับได้ ตัวเลือกส่วนใหญ่จะมี วิธีดังต่อไปนี้
withCondition()
- เพิ่มเงื่อนไขไปยังตัวเลือก หากมีการใช้หลายเงื่อนไข ระบบจะรวมและรวมเข้าด้วยกัน กล่าวคือ ตัวเลือกจะแสดงเฉพาะเอนทิตีที่ตรงตามเงื่อนไขที่ระบุทั้งหมดเท่านั้น
withIds()
- เพิ่มคอลเล็กชันรหัสเป็นเงื่อนไข ระบบจะรวมเงื่อนไขที่อิงตามรหัสไว้พร้อมกับเงื่อนไขอื่นๆ ทั้งหมด
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()
อ่านแนวทางปฏิบัติแนะนำเพื่อดูกลเม็ดเคล็ดลับเกี่ยวกับการใช้ตัวเลือกอย่างมีประสิทธิภาพ