เขียนและเรียกใช้การค้นหา

สร้างคำค้นหา

หมายเหตุ: ผู้ใช้บางรายจะสร้างและแก้ไขคำค้นหาไม่ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการควบคุม การเข้าถึงใน Ads Data Hub

1. ไปที่แท็บข้อความค้นหาใน Ads Data Hub
2. คลิก + สร้างคําค้นหา หน้าเทมเพลตการค้นหาการวิเคราะห์จะเปิดขึ้น
3. ไม่บังคับ: ดูตัวอย่าง SQL ของเทมเพลตโดยคลิก ขยาย
4. เลือกเทมเพลตที่ต้องการใช้โดยคลิกใช้เทมเพลต หรือคลิกว่างเพื่อเริ่มต้นจากศูนย์
5. ป้อนชื่อรายงาน
6. เขียนหรือแก้ไขการค้นหาโดยใช้ SQL ที่เข้ากันได้กับ BigQuery คุณสามารถค้นหาตารางและฟิลด์ที่ใช้ได้ แล้วแทรกลงใน SQL จากแท็บตาราง Google
7. ไม่บังคับ: กำหนดค่าพารามิเตอร์
8. ไม่บังคับ: กำหนดค่าสรุปแถวที่กรองแล้ว
9. คลิกบันทึก

พารามิเตอร์

พารามิเตอร์ทำให้การค้นหามีความยืดหยุ่นมากขึ้น เช่น คุณอาจต้องการเรียกใช้ การค้นหาเดียวกันในแคมเปญต่างๆ แทนที่จะทําการค้นหาที่ซ้ำกันหรือฮาร์ดโค้ดรหัสแคมเปญก่อนการดําเนินการแต่ละครั้ง คุณสามารถกําหนดค่าพารามิเตอร์ที่ยอมรับรหัสแคมเปญอย่างน้อย 1 รายการเพื่อป้อนจาก การ์ดเรียกใช้เมื่อเรียกใช้การค้นหา การใช้พารามิเตอร์จะช่วยให้โค้ดของคุณสะอาด ลดโอกาสที่จะเกิดข้อผิดพลาดจากการแก้ไข และช่วยให้ นำคำค้นหาไปใช้ซ้ำได้โดยไม่ต้องแก้ไข พารามิเตอร์มีขอบเขตเป็นการค้นหาที่สร้างขึ้น ดังนั้นคุณจึงนำชื่อพารามิเตอร์ไปใช้ซ้ำในการค้นหาอื่นได้

ประเภทพารามิเตอร์

ระบบอนุญาตให้ใช้พารามิเตอร์ประเภทต่อไปนี้

• int64
• float64
• bool
• string
• date
• timestamp
• arrayในประเภทที่อนุญาต

สร้างพารามิเตอร์

1. เปิดคำค้นหาที่บันทึกไว้หรือสร้างคำค้นหาใหม่
2. คลิกพร็อพเพอร์ตี้ > พารามิเตอร์ > เพิ่มพารามิเตอร์
3. ป้อนชื่อในช่องชื่อ คุณจะใช้ชื่อนี้เพื่ออ้างอิง พารามิเตอร์ในข้อความค้นหา
4. ใช้เมนูแบบเลื่อนลงเพื่อเลือกประเภทพารามิเตอร์
   • หากเลือกอาร์เรย์ เมนูแบบเลื่อนลงเพิ่มเติมจะปรากฏขึ้น เลือก ประเภทอาร์เรย์ในเมนูแบบเลื่อนลง
5. ไม่บังคับ: ทำขั้นตอนที่ 2-4 ซ้ำจนกว่าจะเพิ่มพารามิเตอร์ที่ต้องการทั้งหมด
6. คลิก "บันทึก"

ใช้พารามิเตอร์

ในข้อความการค้นหา ให้ใช้รูปแบบพารามิเตอร์ SQL มาตรฐาน ซึ่งคือการใส่ @ ไว้หน้าชื่อพารามิเตอร์ ในตัวอย่างต่อไปนี้ คำค้นหา มีพารามิเตอร์ชื่อ @campaign_ids

  /* Parameters:
  * @campaign_ids (ARRAY of INT64): A list of campaign IDs
  *   to conduct analysis on */

  WITH user_reach AS (
  SELECT 
    user_id,
    count(*) AS num_views
  FROM 
    adh.google_ads_impressions
  WHERE 
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY 
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM 
    user_reach

เมื่อเรียกใช้การค้นหา กล่องโต้ตอบงานใหม่จะมีช่องพารามิเตอร์ ป้อนค่าสําหรับพารามิเตอร์แต่ละรายการที่คุณกําหนด

นำพารามิเตอร์ออก

1. เปิดคำค้นหาที่มีพารามิเตอร์ที่ต้องการลบ
2. เปิดแท็บพร็อพเพอร์ตี้
3. ในการ์ดพารามิเตอร์ ให้คลิก ลบ ลบข้างพารามิเตอร์ที่ต้องการลบ
4. คลิกบันทึก

พารามิเตอร์ที่สงวนไว้

ตารางต่อไปนี้แสดงพารามิเตอร์ที่ Ads Data Hub สงวนไว้ คุณใช้พารามิเตอร์เหล่านี้ในการค้นหาได้ แต่จะสร้างพารามิเตอร์ที่มีชื่อเดียวกับพารามิเตอร์ที่สงวนไว้ไม่ได้

start_date	date วันที่เริ่มต้น (รวม) สำหรับงานการค้นหา ระบบจะละเว้นพารามิเตอร์ที่ผู้ใช้กำหนด ซึ่งมีชื่อนี้และแทนที่ด้วยค่าที่ตั้งไว้ใน กล่องโต้ตอบงานใหม่
end_date	date วันที่สิ้นสุด (รวม) ของงานการค้นหา ระบบจะละเว้นพารามิเตอร์ที่ผู้ใช้กำหนด ซึ่งมีชื่อนี้และแทนที่ด้วยค่าที่ตั้งไว้ใน กล่องโต้ตอบงานใหม่
time_zone	string เขตเวลาของงานการค้นหา ระบบจะละเว้นพารามิเตอร์ที่ผู้ใช้กำหนดซึ่งมีชื่อนี้ และแทนที่ด้วยค่าที่ตั้งไว้ในกล่องโต้ตอบงานใหม่ เคล็ดลับ: หากต้องการป้องกันความคลาดเคลื่อนเมื่อใช้เขตเวลาในคำค้นหา เช่น ในคําสั่ง WHERE คุณสามารถใช้ time_zone เพื่อให้ตรงกับเขตเวลาที่ตั้งค่าไว้ในงานใหม่ นอกจากนี้ คุณควรใช้เขตเวลาเดียวกันกับแหล่งข้อมูลด้วย
params	string เนมสเปซสำหรับการตั้งชื่อตารางที่ส่งออก ใช้รูปแบบต่อไปนี้เพื่อ สร้างตัวยึดตำแหน่งในการค้นหา จากนั้นระบุชื่อตารางเมื่อคุณ เรียกใช้รายงาน: params.TABLE_NAME (อย่าใช้ @ ที่นำหน้าซึ่งพารามิเตอร์อื่นๆ ใช้) ดูข้อมูลเพิ่มเติมและตัวอย่างการใช้พารามิเตอร์นี้ได้ที่ ส่งออกหลายตาราง โดยใช้การค้นหาเดียว

ข้อมูลสรุปแถวที่กรอง

สรุปแถวที่กรองจะรวบรวมข้อมูลที่กรองเนื่องจากการตรวจสอบความเป็นส่วนตัว ระบบจะรวมข้อมูลจากแถวที่กรองแล้วและเพิ่มลงในแถวที่ครอบคลุมทั้งหมด แม้ว่าจะวิเคราะห์ข้อมูลที่กรองแล้วเพิ่มเติมไม่ได้ แต่ข้อมูลนี้จะแสดงสรุปของปริมาณข้อมูลที่กรองออกจากผลลัพธ์

หมายเหตุ: ข้อกำหนดในการรวบรวมมีผลกับสรุปแถวที่กรองแล้วด้วย หากข้อมูลสรุปแถวที่กรองแล้วต่ำกว่าข้อกำหนดในการรวม ระบบจะกรองข้อมูลสรุปแถวที่กรองแล้วเอง

แก้ไขคำค้นหา

1. ไปที่แท็บข้อความค้นหาใน Ads Data Hub
2. คลิกชื่อคำค้นหาที่ต้องการแก้ไข
3. แก้ไขคำค้นหา
4. คลิกบันทึก

ดำเนินการค้นหา

ประเด็นสำคัญ: คุณควรเขียนและทดสอบการค้นหาโดยใช้แซนด์บ็อกซ์ก่อนที่จะเรียกใช้ในการค้นหาข้อมูลจริง ดูข้อมูลเพิ่มเติม แนวทางปฏิบัติแนะนำสำหรับการเขียนคําค้นหาใน Ads Data Hub

ก่อนเรียกใช้การค้นหา โปรดตรวจสอบว่าคุณได้ให้สิทธิ์dataEditorบัญชีบริการแก่ชุดข้อมูลที่จะมีเอาต์พุตของการ รวมแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับการควบคุมการเข้าถึงใน BigQuery

1. ไปที่แท็บข้อความค้นหาใน Ads Data Hub
2. คลิกชื่อการค้นหาที่ต้องการเรียกใช้
3. คลิก เรียกใช้
   • จำนวนไบต์ที่คาดว่าการค้นหาจะใช้จะแสดงที่ด้านบนของหน้า
4. เลือกรหัสในช่องข้อมูลโฆษณาจาก ควรกรอกรหัสบัญชี ที่เชื่อมโยงกับข้อมูลโฆษณาที่คุณต้องการค้นหา (หากต้องการค้นหาข้อมูลแซนด์บ็อกซ์ ให้เลือกลูกค้าแซนด์บ็อกซ์ของ ADH)
5. หากใช้ตารางการจับคู่ ให้เลือกตารางการจับคู่ในช่องตารางการจับคู่จาก
6. เลือกโหมดความเป็นส่วนตัว ดูข้อมูลเพิ่มเติมเกี่ยวกับโหมด ความเป็นส่วนตัว
7. ระบุตำแหน่งที่จะบันทึกผลการค้นหาในฟิลด์ตารางปลายทาง
8. ป้อนวันที่เริ่มต้นและวันที่สิ้นสุดเพื่อกำหนดช่วงวันที่ของการค้นหา
9. ป้อนเขตเวลา ซึ่งควรตรงกับเขตเวลาของช่องทางการซื้อ
10. ไม่บังคับ: ป้อนค่าสำหรับพารามิเตอร์
11. คลิกเรียกใช้

ดูผลลัพธ์

หลังจากที่คําค้นหาทํางานเสร็จแล้ว คุณจะดูตัวอย่างผลลัพธ์ได้ในหน้า "งาน" นอกจากนี้ คุณยังสำรวจข้อมูลใน BigQuery, ชีต หรือ Data Studio ได้ด้วย

Preview

คลิกแสดงตัวอย่างในงานที่เสร็จแล้ว ผลลัพธ์ 20 รายการแรกจะปรากฏ ใต้ชื่องาน

BigQuery

ระบบจะส่งออกผลลัพธ์ไปยัง BigQuery โดยค่าเริ่มต้น คลิกดูตารางเพื่อเปิด BigQuery ในหน้าต่างใหม่

ชีตและ Data Studio

เปิดเมนูแบบเลื่อนลงสำรวจ แล้วเลือกสำรวจด้วยชีตหรือ สำรวจด้วย Data Studio จากตัวเลือก ซึ่งจะเปิดข้อมูลในหน้าต่างใหม่