การกรอง

พารามิเตอร์สตริงการค้นหา filters จำกัดข้อมูลที่แสดงผล ในรายงาน AdSense Management API เมื่อใช้พารามิเตอร์ filters คุณจะ ให้ระบุมิติข้อมูลที่ต้องการกรอง ตามด้วยนิพจน์ตัวกรอง

การค้นหาที่กรองจะจำกัดแถวที่จะรวมไว้ในผลลัพธ์ แต่ละแถว ในผลลัพธ์จะมีการทดสอบกับตัวกรอง: หากตัวกรองตรงกัน แถวจะเป็น ที่คงไว้ และหากไม่ตรงกัน แถวจะหายไป

  • การเข้ารหัส URL: ไลบรารีของไคลเอ็นต์จะเข้ารหัสโดยอัตโนมัติ โอเปอเรเตอร์ตัวกรอง อย่างไรก็ตาม หากคุณส่งคำขอไปยังโปรโตคอลโดยตรง คุณต้องเข้ารหัสโอเปอเรเตอร์ตัวกรองอย่างชัดแจ้งตามที่ระบุไว้ในตารางด้านล่าง
  • ลำดับความสำคัญของการกรอง: การกรองจะเกิดขึ้นก่อน มีการรวมมิติข้อมูล ดังนั้นเมตริกที่แสดงผลจะแสดงถึง สำหรับมิติข้อมูลที่เกี่ยวข้องเท่านั้น

ไวยากรณ์ตัวกรอง

ตัวกรองเดียวจะใช้แบบฟอร์มดังนี้

name operator expression

ในไวยากรณ์นี้

  • name — ชื่อของมิติข้อมูลที่จะกรอง ตัวอย่างเช่น AD_CLIENT_ID จะกรองรหัสลูกค้าโฆษณา
  • โอเปอเรเตอร์ — กำหนดประเภทการจับคู่ตัวกรองที่จะใช้
  • นิพจน์ — ระบุค่าที่รวมอยู่ในผลลัพธ์

มิติข้อมูลทั้งหมดที่ ใช้กับเมตริกที่รายงานอยู่ สามารถใช้เป็นตัวกรองได้ด้วย ข้อยกเว้นของมิติข้อมูลที่เกี่ยวกับวันที่ (DATE, WEEK, และ MONTH) หากต้องการกรองตามวันที่ ให้ระบุ ช่วงวันที่สำหรับรายงานแทน

โอเปอเรเตอร์ตัวกรอง

ตัวกรองมีโอเปอเรเตอร์อยู่ 2 แบบ โอเปอเรเตอร์ต้องเป็น URL ที่เข้ารหัสเพื่อ รวมอยู่ในสตริงการค้นหา URL

โอเปอเรเตอร์ คำอธิบาย แบบฟอร์มที่เข้ารหัส URL ตัวอย่าง
== การทำงานแบบตรงทั้งหมด %3D%3D รวบรวมเมตริกที่มีชื่อประเทศเป็นแคนาดา ดังนี้
filters=COUNTRY_NAME%3D%3DCanada
=@ มีสตริงย่อย %3D@ รวบรวมเมตริกซึ่งชื่อประเทศมีคำว่า United ซึ่งเท่ากับ ตรงกับสหรัฐอเมริกาและสหราชอาณาจักร เช่น
filters=COUNTRY_NAME%3D@United

กรองนิพจน์

กฎที่สำคัญสำหรับนิพจน์ตัวกรองมี 2 ข้อดังนี้

  • อักขระที่สงวน URL — อักขระ เช่น & ต้องเข้ารหัส URL ด้วยวิธีตามปกติ ไลบรารีของไคลเอ็นต์ จะแก้ไขปัญหานี้ให้คุณ ดังนั้นคุณไม่ต้องกังวลกับการเข้ารหัสนี้ คุณกำลังโทรไปยังโปรโตคอลโดยตรง
  • อักขระที่สงวนไว้ - โดยคอมมาและแบ็กสแลชต้อง เครื่องหมายแบ็กสแลชจะเป็นอักขระหลีกเมื่อปรากฏในนิพจน์
    • แบ็กสแลช \\
    • คอมมา \,

หมายเหตุ: อย่าลืมใช้อักขระหลีกกับแบ็กสแลชก่อน เครื่องหมายจุลภาคเพื่อเลี่ยงการ Escape 2 ครั้ง

รวมตัวกรอง

รวมตัวกรองได้โดยใช้บูลีน OR และ AND

ตรรกะ "หรือ"

กำหนดตรรกะ OR โดยใช้คอมมา (,) ภายในแท็ก นิพจน์ตัวกรอง

ตัวอย่าง: (แต่ละรายการต้องมีการเข้ารหัส URL)

รหัสประเทศคือ (สหรัฐอเมริกาหรือสหราชอาณาจักร):
วันที่ COUNTRY_CODE==US,COUNTRY_CODE==UK

ตรรกะ AND

AND จะบรรลุผลได้จากการระบุพารามิเตอร์ตัวกรองหลายรายการ ซึ่งหมายถึงการจัดหาอาร์เรย์ของตัวกรองในไลบรารีของไคลเอ็นต์

ตัวอย่างเช่น

รหัสประเทศคือ US และรหัสผลิตภัณฑ์คือ AFC:
วันที่ filters=COUNTRY_CODE%3D%3DUS&filters=PRODUCT_CODE%3D%3DAFC

การรวมตรรกะ AND และ OR

สามารถรวมตรรกะ AND และ OR เป็นนิพจน์เดียวได้

หมายเหตุ: ระบบจะประเมินตัวกรองแต่ละรายการแยกกัน ก่อนที่ตัวกรองทั้งหมดจะรวมกันเป็นนิพจน์เชิงตรรกะ AND

ตัวอย่างเช่น

รหัสประเทศคือ (สหรัฐอเมริกาหรือสหราชอาณาจักร) และรหัสผลิตภัณฑ์คือ AFC:
วันที่ filters=COUNTRY_CODE%3D%3DUS,COUNTRY_CODE%3D%3DUK&filters=PRODUCT_CODE%3D%3DAFC

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