ภาษาการค้นหาของ Merchant Center

Merchant Center Query Language (MCQL) เป็นภาษาการค้นหาที่คล้ายกับ SQL คุณสามารถใช้ MCQL กับ Merchant Reports API เพื่อดึงข้อมูลประสิทธิภาพของผลิตภัณฑ์และตลาดที่ผลิตภัณฑ์แข่งขันอยู่ได้

ไวยากรณ์

ข้อมูลอ้างอิงไวยากรณ์ MCQL (ในรูปแบบนิพจน์ทั่วไป) มีดังนี้

Query            -> SelectClause FromClause? WhereClause? OrderByClause? LimitClause?
SelectClause     -> SELECT FieldName (, FieldName)*
FromClause       -> FROM TableName
WhereClause      -> WHERE Condition (AND Condition)*
OrderByClause    -> ORDER BY Ordering (, Ordering)*
LimitClause      -> LIMIT PositiveInteger

Condition        -> FieldName Operator Value | FieldName BETWEEN Value AND Value
Operator         -> = | != | > | >= | < | <= | <> | IN | NOT IN |
                    CONTAINS ANY | CONTAINS ALL | CONTAINS NONE | DURING |
                    LIKE | NOT LIKE | REGEXP_MATCH | NOT REGEXP_MATCH
Value            -> Number | NumberList | String | StringList | Function
Ordering         -> FieldName (ASC | DESC)?

FieldName        -> [a-z] ([a-zA-Z0-9._])*
TableName        -> [A-Z] ([a-zA-Z_])*

StringList       -> ( String (, String)* )
NumberList       -> ( Number (, Number)* )

PositiveInteger  -> [1-9] ([0-9])*
Number           -> -? [0-9]+ (. [0-9] [0-9]*)?
String           -> (' Char* ') | (" Char* ")
Function         -> LAST_14_DAYS | LAST_30_DAYS | LAST_7_DAYS |
                    LAST_BUSINESS_WEEK | LAST_MONTH | LAST_WEEK_MON_SUN |
                    LAST_WEEK_SUN_SAT | THIS_MONTH | THIS_WEEK_MON_TODAY |
                    THIS_WEEK_SUN_TODAY | TODAY | YESTERDAY

คุณใช้สัญลักษณ์ต่อไปนี้ได้

• ?หมายถึงองค์ประกอบที่ไม่บังคับ
• * หมายถึงไม่มีเลยหรือมีมากกว่า 1 รายการ + หมายถึงมีอย่างน้อย 1 รายการ
• (xxxxxx) หมายถึงการจัดกลุ่ม
• [a-z0-9] หมายถึงช่วงอักขระ
• | หมายถึง "หรือ"

ประเด็นสำคัญ: โอเปอเรเตอร์ REGEXP_MATCH ใช้ไวยากรณ์ RE2

การพิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

โอเปอเรเตอร์ MCQL ส่วนใหญ่จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ดังนี้

โอเปอเรเตอร์	การคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
= หรือ !=	พิจารณาตัวพิมพ์เล็กและใหญ่
(NOT) IN	พิจารณาตัวพิมพ์เล็กและใหญ่
(NOT) LIKE	พิจารณาตัวพิมพ์เล็กและใหญ่
CONTAINS (...)	พิจารณาตัวพิมพ์เล็กและใหญ่
REGEXP_MATCH	ทั้ง 2 อย่าง (ไม่บังคับ)

ประเด็นสำคัญ: REGEXP_MATCH และ NOT REGEXP_MATCH จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่โดยค่าเริ่มต้น แต่คุณสามารถใส่ (?i) ตามที่อธิบายไว้ในไวยากรณ์ RE2 เพื่อให้ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ได้

อนุประโยค

ส่วนคำสั่งที่คุณค้นหาด้วย MCQL ได้มีดังนี้

SELECT

ส่วนคำสั่ง SELECT จะใช้รายการฟิลด์ที่คั่นด้วยคอมมาเพื่อดึงข้อมูล

สำคัญ: คำสั่ง SELECT จำเป็นสำหรับการค้นหาทั้งหมด คุณต้องเลือกช่องเมตริกอย่างน้อย 1 ช่องในการค้นหาประสิทธิภาพ

คุณเลือกช่องใดก็ได้จากมุมมองที่ใช้อยู่ ตัวอย่างช่องที่คุณเลือกได้มีดังนี้

• เมตริก

  • impressions
  • clicks

• กลุ่ม

  • date
  • marketing_method

คุณสามารถค้นหาฟิลด์หลายประเภทได้ในคำขอเดียว เช่น

SELECT
  date,
  marketing_method,
  impressions,
  clicks
FROM product_performance_view
WHERE date BETWEEN '2023-08-01' AND '2023-08-31'

จาก

ส่วนคำสั่ง FROM จะระบุตารางที่จะดึงข้อมูลในคำขอ คุณระบุได้เพียงช่องเดียวในส่วนคำสั่ง FROM ต้องมีวลี FROM สำหรับคำค้นหาทั้งหมด

ที่ไหน

ใช้ส่วนคำสั่ง WHERE เพื่อกรองข้อมูลสำหรับคำขอของคุณ ต้องระบุส่วนคำสั่ง WHERE สำหรับการค้นหาประสิทธิภาพ คุณสามารถกรองตามช่อง segments ทั้งหมด และตามช่อง metrics เพิ่มเติมได้หากระบุไว้ในส่วนคำสั่ง SELECT

ต่อไปนี้คือตัวอย่างที่ใช้ WHERE เพื่อแสดงผลการแสดงผลจากระยะเวลาที่ระบุเท่านั้น (เดือนสิงหาคม)

SELECT offer_id, impressions
FROM product_performance_view
WHERE date BETWEEN '2023-08-01' AND '2023-08-31'

คุณสามารถกรองตามเงื่อนไขหลายรายการในการค้นหาเดียวได้ด้วยโอเปอเรเตอร์ AND ใช้ AND ระหว่างเงื่อนไขที่สมบูรณ์ เช่น WHERE marketing_method != "ADS" AND marketing_method != "ORGANIC" คุณไม่สามารถใช้ AND ระหว่างค่าต่างๆ ในเงื่อนไขเดียว เช่น WHERE marketing_method != "ADS" AND "ORGANIC"

ต่อไปนี้คือตัวอย่างที่แสดงจำนวนคลิกต่อข้อเสนอซึ่งมีจำนวนคลิกมากกว่า 100 ครั้งสำหรับวิธีทางการตลาด ADS ในช่วงเดือนสิงหาคม

SELECT offer_id, clicks
FROM product_performance_view
WHERE clicks > 100
  AND marketing_method = 'ADS'
  AND date BETWEEN '2023-08-01' AND '2023-08-31'

ส่วนคำสั่ง WHERE ไม่รองรับ OR โอเปอเรเตอร์จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ดูรายการโอเปอเรเตอร์ทั้งหมดได้ที่ไวยากรณ์

ORDER BY (ไม่บังคับ)

ส่วนคำสั่ง ORDER BY ช่วยให้คุณดึงข้อมูลผลลัพธ์ตามลำดับที่ระบุได้

ระบุลำดับตาม field_name แล้วตามด้วย ASC หรือ DESC คุณจัดเรียงได้เฉพาะตามฟิลด์ที่ระบุไว้ในส่วนคำสั่ง SELECT ของการค้นหาเท่านั้น ORDER BY จะมีค่าเริ่มต้นเป็น ASC หากคุณไม่ได้ระบุ

การค้นหาต่อไปนี้จะจัดเรียงแถวที่แสดงผลตามจำนวนคลิกจากมากที่สุดไปน้อยที่สุด

SELECT offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-08-01' AND '2023-08-31'
ORDER BY clicks DESC

คุณสามารถระบุหลายฟิลด์ในส่วนคำสั่ง ORDER BY โดยใช้รายการที่คั่นด้วยคอมมา

ตัวอย่างเช่น ผลลัพธ์ของคำค้นหาต่อไปนี้จะจัดเรียงตามลำดับจากน้อยไปมากตาม offer_id จากนั้นจัดเรียงตามลำดับจากมากไปน้อยตามจำนวนการแสดงผล แล้วจึงจัดเรียงตามลำดับจากมากไปน้อยตามจำนวนการคลิก

SELECT offer_id, impressions, clicks
FROM product_performance_view
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY
  offer_id,
  impressions DESC,
  clicks DESC

ขีดจำกัด

ส่วนคำสั่ง LIMIT ช่วยให้คุณระบุจำนวนผลลัพธ์ที่จะแสดงได้

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

SELECT offer_id, impressions
FROM product_performance_view
WHERE date BETWEEN '2020-08-01' AND '2020-08-31'
ORDER BY impressions DESC
LIMIT 50

ใช้ช่อง pageSize เพื่อจัดการรายการผลลัพธ์ที่ยาว

ช่วงวันที่

MCQL ช่วยให้คุณระบุช่วงวันที่ที่กำหนดเองหรือช่วงวันที่แบบสัมพัทธ์ได้ คุณต้องใช้ส่วนคำสั่ง WHERE เพื่อระบุช่วง date สำหรับการค้นหาประสิทธิภาพทั้งหมด

กำหนดเอง

คุณระบุวันที่ ISO 8601(YYYY-MM-DD) ในรูปแบบต่อไปนี้ได้

• date BETWEEN '2021-01-01' AND '2021-01-31'
• date >= '2021-01-01' AND date <= '2021-01-31'

คุณสามารถกำหนดสตริงวันที่ด้วยเครื่องหมายคำพูดเดี่ยว (') หรือเครื่องหมายคำพูดคู่ (") ก็ได้

ญาติ

คุณสามารถระบุช่วงวันที่แบบสัมพัทธ์ เช่น LAST_30_DAYS หรือ THIS_MONTH โดยใช้ DURING แทน BETWEEN และ AND ดังนี้

WHERE date DURING LAST_30_DAYS

ดูไวยากรณ์สำหรับรายการช่วงวันที่แบบสัมพัทธ์ทั้งหมดที่ใช้ได้