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

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

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

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

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

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

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

ดูผลลัพธ์

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

Preview

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

BigQuery

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

ชีตและ Data Studio

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