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

คำสำคัญ: ตอนนี้การค้นหาเปลี่ยนชื่อเป็นรายงาน คุณอาจเห็นการใช้คำเหล่านี้สลับกันใน UI และเอกสารในระหว่างการเปลี่ยนไปใช้รายงาน

สร้างรายงาน

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

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

พารามิเตอร์

พารามิเตอร์ทำให้รายงานมีความยืดหยุ่นมากขึ้น ตัวอย่างเช่น คุณอาจต้องการเรียกใช้รายงานเดียวกันในหลายๆ แคมเปญ แทนที่จะสร้างรายงานซ้ำหรือฮาร์ดโค้ดรหัสแคมเปญก่อนดำเนินการแต่ละครั้ง คุณสามารถกำหนดค่าพารามิเตอร์ที่ยอมรับรหัสแคมเปญอย่างน้อย 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. คลิกบันทึก

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

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