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