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