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