หน้านี้ได้รับการแปลโดย Cloud Translation API

กำลังกรอง

พารามิเตอร์สตริงการค้นหา 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