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