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

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

หมายเหตุ: ผู้ใช้บางคนอาจสร้างและแก้ไขคำค้นหาไม่ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการควบคุมการเข้าถึงใน 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 เพื่อจับคู่เขตเวลาที่ตั้งไว้ในงานใหม่ได้ นอกจากนี้ คุณยังควรใช้เขตเวลาเดียวกันกับแหล่งข้อมูลด้วย

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

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

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

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

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

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

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

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

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

ดูผลลัพธ์

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

Preview

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

BigQuery

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

ชีตและ Data Studio

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