สร้างและเรียกใช้รายงาน

คู่มือนี้จะสอนวิธีสร้างและเรียกใช้รายงาน รวมถึงวิธีดูผลลัพธ์

สร้างรายงาน

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

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

พารามิเตอร์

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

ในตัวอย่างต่อไปนี้ รายงานมีพารามิเตอร์ชื่อ campaign_ids ซึ่งยอมรับ array ของรหัสแคมเปญ int64

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

  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

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

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

  • int64
  • float64
  • bool
  • string
  • date
  • timestamp
  • array (ประเภทใดก็ได้ที่ได้รับอนุญาต)

เพิ่มพารามิเตอร์ลงในรายงาน

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

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

  1. เปิดรายงานที่มีการกำหนดค่าพารามิเตอร์
  2. ในแผงการตั้งค่า ให้ป้อนค่าสําหรับพารามิเตอร์แต่ละรายการที่คุณกําหนด
  3. คลิกบันทึกเพื่อเก็บค่าพารามิเตอร์ไว้

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

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

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

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

start_date date

วันที่เริ่มต้น (รวม) สำหรับงานรายงาน ระบบจะละเว้นพารามิเตอร์ที่ผู้ใช้กำหนด ซึ่งมีชื่อนี้และแทนที่ด้วยค่าที่ตั้งไว้ใน กล่องโต้ตอบงานใหม่
end_date date

วันที่สิ้นสุด (รวม) สำหรับงานรายงาน ระบบจะละเว้นพารามิเตอร์ที่ผู้ใช้กำหนด ซึ่งมีชื่อนี้และแทนที่ด้วยค่าที่ตั้งไว้ใน กล่องโต้ตอบงานใหม่
time_zone string

เขตเวลาสำหรับงานรายงาน ระบบจะละเว้นพารามิเตอร์ที่ผู้ใช้กำหนดซึ่งมีชื่อนี้ และแทนที่ด้วยค่าที่ตั้งไว้ในกล่องโต้ตอบงานใหม่
params string

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

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

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

แก้ไขรายงาน

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

เรียกใช้รายงาน

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

  1. ใน Ads Data Hub ให้เปิดหน้ารายงาน
  2. คลิกชื่อรายงานที่ต้องการเรียกใช้
  3. คลิกเรียกใช้

เรียกใช้รายงานตามกำหนดการ

  1. ใน Ads Data Hub ให้เปิดหน้ารายงาน
  2. คลิกชื่อรายงานที่ต้องการตั้งค่ากำหนดเวลา
    • หากต้องการตั้งเวลารายงานใหม่ ให้สร้างรายงาน แล้วคลิกบันทึก
  3. คลิก + ตั้งเวลา
  4. ในแผงกำหนดเวลา ให้คลิกปุ่มเปิด/ปิดกำหนดเวลารายงานนี้ให้ทำงานโดยมีรายละเอียดด้านล่างเพื่อเปิดใช้
  5. ในส่วนความถี่ ให้เลือกช่วงเวลาและเวลาของวัน จากนั้นป้อนเขตเวลา
    • หากต้องการใช้นิพจน์ Cron แทน ให้คลิกปุ่มเปิด/ปิดกำหนดเวลาโดยใช้นิพจน์ Cron เพื่อเปิด แล้วป้อนนิพจน์ใน ช่อง
  6. คลิกเสร็จสิ้น
  7. คลิกบันทึกเพื่อบันทึกการเปลี่ยนแปลงในรายงาน

หากต้องการแสดงงานที่กำหนดเวลาไว้ในหน้าหน้าแรก ให้เลือกทุกคนจากรายการตัวกรองเจ้าของ

ดูผลลัพธ์

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

Preview

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

BigQuery

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

ชีตและ Data Studio

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