โครงสร้างและวรรคของคําค้นหา

ข้อความค้นหาประกอบด้วยวลีต่อไปนี้ 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"

ดูข้อมูลเพิ่มเติม