ข้อความค้นหาประกอบด้วยวลีต่อไปนี้ SELECT
,
FROM
,
WHERE
,
ORDER BY
LIMIT
และ PARAMETERS
วรรคจะใช้ชื่อช่อง ชื่อทรัพยากร โอเปอเรเตอร์ เงื่อนไข และการจัดลำดับที่รวมกันเป็นคำขอข้อความค้นหาเดียว
พูดง่ายๆ ก็คือ หากต้องการสร้าง Query คุณ:
- ระบุทรัพยากรที่ต้องการเรียกข้อมูล
- เพิ่มช่องและเมตริกเพื่อกําหนดข้อมูลที่ต้องการส่งคืน
- เพิ่มกลุ่มเพื่อจัดกลุ่มผลลัพธ์
- เพิ่มทรัพยากรที่มีการระบุแหล่งที่มาเพื่อรวมข้อมูลทรัพยากรที่เกี่ยวข้องโดยปริยาย
- กรอง เรียงลำดับ และจำกัดผลลัพธ์ของคุณ
SELECT
ข้อความ
วรรค SELECT
:
- เป็นอนุประโยคที่ต้องระบุในการค้นหา
- ระบุชุดช่องที่จะดึงข้อมูลในคำขอ
- ใช้รายการช่องทรัพยากร คอลัมน์ที่กำหนดเอง และรายการข้อมูลที่คั่นด้วยคอมมา ตัวแปร Floodlight, ช่องกลุ่ม และเมตริก และแสดงผลค่าใน คำตอบ
ตัวอย่างการค้นหานี้จะแสดงวิธีเลือกแอตทริบิวต์ของ campaign
แหล่งข้อมูล:
SELECT
campaign.id,
campaign.name
FROM campaign
ประเภทช่องหลายประเภท
คุณขอช่องประเภทอื่นในคำขอเดียวกันได้
ตัวอย่างข้อความค้นหาด้านล่างแสดงข้อความค้นหาเดียวที่มีชุดค่าผสมของ
- ช่องแหล่งข้อมูล:
campaign.id
,campaign.name
,bidding_strategy.id
และbidding_strategy.name
- ฟิลด์กลุ่ม:
segments.device
และsegments.date
- ช่องเมตริก:
metrics.impressions
และmetrics.clicks
SELECT
campaign.id,
campaign.name,
bidding_strategy.id,
bidding_strategy.name,
segments.device,
segments.date,
metrics.impressions,
metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ดูการแบ่งกลุ่ม เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการแบ่งกลุ่มรายงานการค้นหา
ช่องทรัพยากรหลัก
โดยทั่วไปแล้ว คุณจะต้องรวมฟิลด์ทรัพยากรหลักใน SELECT
ประเภทนี้หรือไม่ก็ได้ (ไม่จำเป็น)
การค้นหาตัวอย่างนี้ใช้ฟิลด์ทรัพยากรหลัก (ad_group.status
) เพื่อกรองเฉพาะ
ผลลัพธ์
SELECT campaign.id
FROM ad_group
WHERE ad_group.status = PAUSED
ตัวแปร Floodlight ที่กำหนดเอง
คุณสามารถรวมตัวแปร Floodlight ที่กำหนดเองในวลี "เลือก" โดยใช้ตัวแปร รหัส
ในตัวอย่างนี้ การค้นหามีตัวแปรที่กำหนดเองที่มีรหัส 123454321 สำหรับพารามิเตอร์ Google Analytics 4
SELECT
conversion_custom_metrics.id[123454321]
FROM campaign
SELECT
conversion_custom_dimensions.id[123454321]
FROM campaign
คอลัมน์ที่กำหนดเอง
คุณรวมคอลัมน์ที่กำหนดเองในคำสั่ง SELECT โดยใช้รหัสได้
ในตัวอย่างนี้ การค้นหามีคอลัมน์ที่กำหนดเองที่มีรหัส 12345678 สำหรับแอตทริบิวต์ Google Analytics 4
SELECT
custom_columns.id[12345678]
FROM campaign
ดูวิธีรับรหัสคอลัมน์ที่กำหนดเอง
ช่องเมตริก
คุณเลือกช่องเมตริกสำหรับทรัพยากรที่ระบุได้โดยไม่ต้องรวมข้อมูลอื่นๆ
จากทรัพยากรในวรรค SELECT
ตัวอย่างการค้นหานี้จะเลือกเมตริก impressions
และ clicks
สําหรับ campaign
ทรัพยากร
SELECT
metrics.impressions,
metrics.clicks
FROM campaign
โปรดดู metrics
สำหรับ
รายการช่องเมตริกที่คุณใช้ในการค้นหาได้
ช่องกลุ่ม
คุณเลือกช่องของกลุ่มโดยไม่ต้องระบุช่องทรัพยากรประกอบได้
หรือเมตริกในวรรคเงื่อนไข SELECT
ตัวอย่างการค้นหานี้จะแบ่งกลุ่มผลลัพธ์ตามอุปกรณ์
SELECT segments.device
FROM campaign
โปรดดู segments
สำหรับ
รายการช่องกลุ่มที่คุณใช้ในการค้นหาได้
ฟิลด์ที่ห้าม
คุณไม่สามารถใช้ช่องต่อไปนี้ในวรรค SELECT
ได้
- ช่องที่เลือกไม่ได้ ซึ่งก็คือช่องที่มีข้อมูลเมตา
Selectable
มีการทำเครื่องหมายเป็นfalse
- ช่องที่ซ้ำ กล่าวคือ ช่องที่มีแอตทริบิวต์ข้อมูลเมตา
Repeated
ทำเครื่องหมายเป็นtrue
- ช่องที่ไม่พร้อมใช้งานสำหรับทรัพยากรที่ระบุในวรรค
FROM
เลือกแอตทริบิวต์ของทรัพยากรบางรายการร่วมกันไม่ได้ แหล่งข้อมูลบางรายการเท่านั้น ทำให้ชุดย่อยของเมตริกและกลุ่มทั้งหมดพร้อมใช้งาน - กลุ่มหรือเมตริกใช้ร่วมกันไม่ได้ ดูการแบ่งกลุ่มสำหรับข้อมูลเพิ่มเติม
ดูเอกสารอ้างอิงสำหรับ เพื่อดูว่าจะดูข้อมูลนี้สำหรับทรัพยากรแต่ละรายการได้จากที่ใด
คำสั่ง FROM
วรรค FROM
:
- เป็นอนุประโยคที่จำเป็นสำหรับคำค้นหาเพื่อ
SearchAds360Service
(ทั้งวิธีSearch
และSearchStream
) - ควรไม่รวมอยู่สำหรับคำขอที่ส่งถึง
SearchAds360FieldService
- ระบุทรัพยากรหลักที่การค้นหาแสดงผล
- ระบุทรัพยากรได้เพียงรายการเดียวเท่านั้น
- กำหนดช่องที่คุณสามารถใช้ในข้อย่อยอื่นๆ ทั้งหมดในการค้นหา
ทรัพยากรที่มีการระบุแหล่งที่มา
หากทรัพยากรที่มีการระบุแหล่งที่มาพร้อมใช้งาน ทรัพยากรเหล่านั้นจะรวมเข้าด้วยกันโดยปริยาย
แหล่งข้อมูลที่คุณระบุในวรรค FROM
คุณเพียงแค่ต้องเพิ่มแอตทริบิวต์ของพาร์ทเนอร์
ไปยังวรรค SELECT
เพื่อแสดงค่า
ข้อความค้นหาตัวอย่างนี้ส่งคืนทั้งรหัสกลุ่มโฆษณาและรหัสแคมเปญ เนื่องจาก
campaign
เป็นทรัพยากรที่มีการระบุแหล่งที่มาของทรัพยากร ad_group
SELECT
campaign.id,
ad_group.id
FROM ad_group
resource_name
ช่อง
ช่อง resource_name
ของทรัพยากรหลักในวรรคคำสั่ง FROM
เสมอ
ส่งคืนแล้ว
ในการค้นหาตัวอย่างนี้ ระบบจะรวม ad_group.resource_name
ไว้ในคำตอบ
แม้ว่าจะไม่ได้เลือกไว้อย่างชัดเจนใน Query:
SELECT ad_group.id
FROM ad_group
ช่อง resource_name
ของทรัพยากรที่มีการระบุแหล่งที่มาคือ
แสดงผลเมื่อเลือกอย่างน้อยหนึ่งฟิลด์
ในการค้นหาตัวอย่างนี้ campaign.resource_name
จะรวมอยู่ใน
คำตอบ เนื่องจากเลือก campaign.id
ไว้:
SELECT
campaign.id,
ad_group.id
FROM ad_group
วรรค WHERE
วรรค WHERE
:
- เป็นอนุประโยคที่ไม่บังคับในการค้นหา
- ระบุเงื่อนไขในการกรองและแบ่งกลุ่มข้อมูลสำหรับคำขอ
เงื่อนไขจะเป็นไปตามรูปแบบนี้:
FIELD_NAME
OPERATOR
VALUE
(คั่นด้วย พื้นที่ว่าง) - อาจมีหลายเงื่อนไขโดยคั่นด้วยตัวคั่น
AND
ตัวอย่างการค้นหานี้จะแสดงวิธีใช้วลี WHERE
เพื่อแสดง impressions
เมตริกสำหรับระยะเวลาที่กำหนด ได้แก่
SELECT
campaign.id,
campaign.name,
metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ดูการแบ่งกลุ่ม เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการแบ่งกลุ่มรายงานการค้นหา
โปรดดูที่ช่วงวันที่เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการระบุวันที่ ช่วงในการค้นหาของคุณ
กรองตามช่อง resource_name
คุณสามารถใช้ช่อง resource_name
เพื่อกรองหรือเรียงลำดับข้อมูลได้
การค้นหาตัวอย่างนี้ใช้ช่อง campaign.resource_name
เพื่อกรองผลลัพธ์
ตามแคมเปญที่ระบุ
SELECT
campaign.id,
campaign.name
FROM campaign
WHERE campaign.resource_name = 'customers/1234567/campaigns/987654'
หลายเงื่อนไข
โดยคุณสามารถรวมหลายเงื่อนไขเข้าด้วยกันเพื่อกรองข้อมูลได้
การค้นหาตัวอย่างนี้ขอจำนวนเมตริก clicks
สำหรับแคมเปญทั้งหมด
ที่มีเมตริก impressions
รายการบนอุปกรณ์เคลื่อนที่ในช่วง 30 วันที่ผ่านมา
SELECT
campaign.id,
campaign.name,
segments.device,
metrics.clicks
FROM campaign
WHERE metrics.impressions > 0
AND segments.device = MOBILE
AND segments.date DURING LAST_30_DAYS
ดูการแบ่งกลุ่ม เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการแบ่งกลุ่มรายงาน
คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
เมื่อกรองค่าสตริง การพิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่เริ่มต้นของโอเปอเรเตอร์แต่ละรายการ มีบทบาทสำคัญในการกรองผลการค้นหาอย่างถูกต้อง
ตารางต่อไปนี้แสดงการพิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่เริ่มต้นของโอเปอเรเตอร์แต่ละรายการ
คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่เริ่มต้น | |
---|---|
=/!= |
Case sensitive |
IN/NOT IN |
Case sensitive |
LIKE/NOT LIKE |
Case insensitive |
CONTAINS (...) |
Case sensitive |
REGEXP_MATCH/NOT REGEXP_MATCH |
Case sensitive |
คุณสามารถใช้ตัวแก้ไข (?i)
เพื่อเปลี่ยนความไวเริ่มต้นของ
REGEXP_MATCH
และ NOT REGEXP_MATCH
เพื่อไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ เช่น
SELECT campaign.id
FROM campaign
WHERE campaign.name REGEXP_MATCH "(?i).*test.*"
โปรดดูที่ข้อมูลอ้างอิงไวยากรณ์ในข้อความค้นหาสำหรับรายการทั้งหมด ที่คุณสามารถใช้ในการกรองข้อมูล
กลุ่มวันที่หลัก
ช่องของกลุ่มต่อไปนี้เรียกว่ากลุ่มวันที่หลัก
segments.date
, segments.week
, segments.month
, segments.quarter
และ
segments.year
คุณใช้กลุ่มวันที่หลักในวลี WHERE
เพื่อระบุวันที่หรือเวลาได้
6 เดือน
คำค้นหาตัวอย่างนี้ระบุ DURING LAST_30_DAYS
สำหรับช่อง segments.date
ในวรรค WHERE
:
SELECT
campaign.id,
campaign.name,
segments.date,
metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ดูการแบ่งกลุ่ม > กลุ่มวันที่หลักสำหรับรายละเอียด ข้อมูลเกี่ยวกับการใช้กลุ่มวันที่หลัก
การกรองที่ไม่อนุญาต
ไม่อนุญาตให้กรอง:
- ในช่องกลุ่มที่ไม่ได้เลือก ยกเว้นกลุ่มวันที่หลัก
- ในช่องข้อความประเภทใดก็ได้ ยกเว้นประเภทพื้นฐาน (เช่น
Int64Value
StringValue
ฯลฯ) - ในแอตทริบิวต์ของช่องที่ซ้ำของประเภทข้อความใดก็ได้ ยกเว้นประเภทพื้นฐาน
(เช่น
Int64Value
,StringValue
เป็นต้น)
ข้อกำหนด ORDER BY
วรรค ORDER BY
:
- เป็นอนุประโยคที่ไม่บังคับในการค้นหา
- ระบุลำดับการแสดงผลลัพธ์ เรียงลำดับตามนี้
รูปแบบ:
FIELD_NAME
ORDERING_OPTION
(คั่นด้วยพื้นที่ว่าง) - อนุญาตให้มี 2 ตัวเลือก ได้แก่
ASC
(จากน้อยไปมาก) หรือDESC
(จากมากไปน้อย) ค่าเริ่มต้นคือ จากน้อยไปมาก
คำค้นหาตัวอย่างนี้เรียงลำดับแคมเปญตามจำนวนคลิกในลำดับจากมากไปน้อย (สูงสุดไปต่ำสุด):
SELECT
campaign.name,
metrics.clicks
FROM campaign
ORDER BY metrics.clicks DESC
การสั่งซื้อหลายรายการ
คุณระบุช่องหลายช่องในคำสั่ง ORDER BY
ได้โดยใช้คอมมา
รายการ ผลลัพธ์จะเรียงลำดับในลำดับเดียวกับที่คุณระบุไว้ใน
คำถาม
คำค้นหาตัวอย่างนี้จะเลือกข้อมูลกลุ่มโฆษณาและเรียงลำดับผลลัพธ์จากน้อยไปมาก เรียงลำดับตามชื่อแคมเปญ จากนั้นเรียงลำดับจากมากไปหาน้อยตามจำนวนการแสดงผล และ จากนั้นจัดเรียงตามจำนวนคลิกจากมากไปน้อย ดังนี้
SELECT
campaign.name,
ad_group.name,
metrics.impressions,
metrics.clicks
FROM ad_group
ORDER BY
campaign.name,
metrics.impressions DESC,
metrics.clicks DESC
รวมการสั่งซื้อและขีดจำกัด
คุณสามารถใช้วลี ORDER BY
ร่วมกับวลี LIMIT
เพื่อ
ปรับแต่งผลลัพธ์ของคุณ
คำค้นหาตัวอย่างนี้ส่งคืนแคมเปญ 5 รายการที่มีการแสดงผลสูงสุดมากกว่า 30 วันที่ผ่านมา:
SELECT
campaign.id,
campaign.name,
metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5
การสั่งซื้อที่ไม่ได้รับอนุญาต
ไม่อนุญาตให้สั่งซื้อ:
- ตามแอตทริบิวต์ของทรัพยากรที่ไม่ได้เลือก
- ตามเมตริกที่ไม่ได้เลือก
- ตามกลุ่มที่ไม่ได้เลือก
- สำหรับช่องประเภทเหล่านี้
MESSAGE
- ฟิลด์ที่ซ้ำได้
- แอตทริบิวต์ของช่องที่ซ้ำได้
LIMIT ข้อความ
วรรค LIMIT
:
- เป็นอนุประโยคที่ไม่บังคับในการค้นหา
- ช่วยให้คุณจำกัดจำนวนผลลัพธ์ที่การค้นหาจะแสดง
วลีนี้มีประโยชน์ ตัวอย่างเช่น หากคุณสนใจเฉพาะตัวอย่างหรือ สรุปของผลลัพธ์
การค้นหาตัวอย่างนี้จำกัดจำนวนผลลัพธ์ทั้งหมดไว้ที่ 50 รายการ
SELECT
campaign.name,
ad_group.name,
segments.device,
metrics.impressions
FROM ad_group
ORDER BY metrics.impressions DESC
LIMIT 50
วลี PARAMETERS
คำสั่ง PARAMETERS
ให้คุณระบุพารามิเตอร์เมตาสำหรับคำขอ
รวมฉบับร่าง
พารามิเตอร์ include_drafts
ควบคุมว่าจะรวมเอนทิตีฉบับร่างหรือไม่
ผลลัพธ์ โดยมีค่าเริ่มต้นเป็น false
ตั้งค่าเป็น true
เพื่อรวมเอนทิตีฉบับร่าง
คำค้นหาตัวอย่างนี้ส่งคืนทั้งแคมเปญร่างและแคมเปญปกติ
SELECT campaign.name
FROM campaign
PARAMETERS include_drafts=true
ยกเลิกการเลือก resource_name
แล้ว
พารามิเตอร์ omit_unselected_resource_names
ทำให้คุณสามารถยกเว้น
resource_name
ของทรัพยากรทั้งหมดที่ไม่ได้มีการขออย่างชัดเจนใน
SELECT
วรรค โดยมีค่าเริ่มต้นเป็น false
หากคุณตั้งค่าพารามิเตอร์นี้เป็น true
เราจะ
ขอแนะนำให้คุณขอชื่อทรัพยากรของทรัพยากรหลักอย่างชัดแจ้ง
และทรัพยากรที่มีการระบุแหล่งที่มาในวรรค SELECT
คำค้นหาตัวอย่างนี้จะไม่แสดงทั้ง campaign.resource_name
และ
customer.resource_name
เนื่องจากไม่รวมอยู่ใน SELECT
วรรค:
SELECT
campaign.name,
customer.id
FROM campaign
PARAMETERS omit_unselected_resource_names = true
การค้นหาตัวอย่างนี้แสดงฟิลด์ campaign.resource_name
เนื่องจาก
มีการขออย่างชัดแจ้งในวรรคเงื่อนไข SELECT
:
SELECT
campaign.name,
campaign.resource_name
FROM campaign
PARAMETERS omit_unselected_resource_names = true
เปลี่ยนสกุลเงินที่ใช้ในเมตริก
พารามิเตอร์ metrics_currency
ช่วยให้คุณระบุสกุลเงินที่จะใช้ได้
เมื่อคำนวณเมตริกที่รวมอยู่ในอนุประโยค SELECT
ค่าเริ่มต้นคือใช้สกุลเงินท้องถิ่นสำหรับบัญชี หากตั้งค่านี้ไว้
คุณต้องใช้รหัสสกุลเงิน 3 อักขระตามมาตรฐาน ISO 4217
เช่น USD, EUR
คำค้นหาตัวอย่างนี้แสดงเมตริก cost_micros ในสกุลเงินท้องถิ่นของ ของคุณได้
SELECT
campaign.name,
metrics.cost_micros
FROM campaign
WHERE segments.date >= "2018-08-15"
AND segments.date < "2018-08-16"
ตัวอย่างการค้นหานี้จะแสดงเมตริก cost_micros เป็นเปโซชิลี (CLP)
SELECT
campaign.name,
metrics.cost_micros
FROM campaign
WHERE segments.date >= "2018-08-15"
AND segments.date < "2018-08-16"
PARAMETERS metrics_currency = "CLP"