ตัวเลือกคืออะไร

ตัวเลือกช่วยให้คุณนําตัวกรองและเกณฑ์การเรียงลําดับไปใช้เมื่อดึงข้อมูลเอนทิตี Microsoft Advertising เช่น คําสําคัญและแคมเปญ ตัวเลือกมีฟังก์ชันการทํางานเทียบเท่ากับ SQL WHERE และส่วน ORDER BY คําสั่ง ตัวเลือก มีวิธีการต่อไปนี้:

  • withCondition() — ใช้เพื่อระบุเงื่อนไขที่เอนทิตีต้องปฏิบัติตามเพื่อเลือก ซึ่งเทียบเท่ากับส่วนคําสั่ง SQL WHERE

    ตัวอย่าง: withCondition('Name STARTS_WITH "Contoso"')

    คุณสามารถใช้เงื่อนไขอย่างน้อยหนึ่งข้อกับตัวเลือกได้ การระบุเงื่อนไขหลายข้อจะถือว่าเป็นการดําเนินการ AND ตัวอย่างเช่น เอนทิตีจะถูกเลือกก็ต่อเมื่อเงื่อนไข A เป็นจริง และเงื่อนไข B เป็นจริง

  • withIds() — ใช้เพื่อระบุ ID ของเอนทิตีที่จะเลือก ซึ่งเทียบเท่ากับส่วนคําสั่ง SQL IN

    ตัวอย่าง: withIds(["1","2","3","4"])

  • forDateRange() — ใช้เพื่อส่งกลับเอนทิตีที่มีข้อมูลประสิทธิภาพที่ตรงกับช่วงวันที่ที่ระบุ หากเงื่อนไขระบุคอลัมน์เมตริก คุณต้องรวมไว้ใน forDateRange สายโซ่ของตัวเลือก

    ตัวอย่าง: forDateRange("LAST_14_DAYS")

  • orderBy() — ใช้เพื่อจัดลําดับเอนทิตีที่ตัวเลือกส่งคืนตามเขตข้อมูลที่ระบุ ซึ่งเทียบเท่ากับส่วนคําสั่ง SQL ORDER BY

    ตัวอย่าง: orderBy("Clicks DESC")

  • withLimit() — ใช้เพื่อส่งกลับจํานวนเอนทิตีสูงสุดตามที่ระบุ ซึ่งเทียบเท่ากับส่วนคําสั่ง SQL TOP

    ตัวอย่าง: withLimit(50)

เนื่องจากแต่ละวิธีส่งกลับตัวเลือกที่มีการใช้เกณฑ์การกรอง คุณอาจเชื่อมโยงเงื่อนไขหลายข้อเข้าด้วยกัน (โดยใช้สัญกรณ์แบบจุด) เพื่อปรับปรุงเกณฑ์การกรอง ตัวอย่างเช่น:

var selector = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10);

เมื่อต้องการปรับปรุงประสิทธิภาพของสคริปต์ ให้ใช้เงื่อนไขตัวกรองที่เฉพาะเจาะจงเพื่อให้แน่ใจว่าคุณจะเรียกใช้เฉพาะเอนทิตีที่คุณต้องการเท่านั้น หลังจากได้รับตัวเลือก ให้เรียกใช้ get() วิธีการเพื่อเรียกใช้ตัวทําซ้ําที่คุณใช้ในการทําซ้ําผ่านรายการของเอนทิตี

var campaigns = selector.get();

หรือ

var campaigns = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10)
    .get();

ต่อไปนี้คือรายการของผู้เลือก

ขั้นตอนถัดไป

เรียนรู้เกี่ยวกับตัววนซ้ํา

  • Last updated on