ขอรายงาน

Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว โดย API ใหม่นี้จะช่วยเพิ่มความยืดหยุ่นในการสร้างรายงานที่กำหนดเองและผสานรวมข้อมูลเข้ากับแอปพลิเคชันและกระบวนการรายงาน ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลรวมถึงการใช้ Search Ads 360 Reporting API เวอร์ชันใหม่

หลังจากตั้งค่าแอปไคลเอ็นต์ตามที่อธิบายไว้ในแอปแรกของฉันแล้ว คุณจะใช้ Search Ads 360 API เพื่อขอและดาวน์โหลดรายงานได้ คุณจะส่งคำขอประเภทใดก็ได้ต่อไปนี้

ซิงโครนัส

ต้องการเพียงคำขอเดียวและแสดงผลรายงานในการตอบสนองรูปแบบ JSON คำขอแบบซิงโครนัส:

หากคุณกำลังขอรายงานขนาดใหญ่จากผู้ลงโฆษณาหรือบัญชีเครื่องมือค้นหา เราขอแนะนำวิธีแบบไม่พร้อมกัน

อะซิงโครนัส

กำหนดให้คุณต้องส่งคำขอเริ่มต้นที่ระบุข้อมูลที่ต้องการในรายงาน จากนั้นคุณส่งคำขอเพิ่มเติมไปยังแบบสำรวจของ Search Ads 360 เมื่อ Search Ads 360 สร้างรายงานเสร็จแล้ว คุณจะส่งคำขอดาวน์โหลดรายงานเป็นไฟล์อย่างน้อย 1 ไฟล์ คำขอแบบอะซิงโครนัส:

  • สามารถแสดงผลประเภทรายงานใดก็ได้
  • ชาร์ดรายงานขนาดใหญ่มากไปยังหลายไฟล์
  • จัดรูปแบบรายงานเป็น CSV หรือ TSV

โมเดลข้อมูล: แถวและคอลัมน์

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

ลักษณะการทำงานของคอลัมน์

ลักษณะการทำงานของคอลัมน์ขึ้นอยู่กับประเภทข้อมูลที่คอลัมน์มี (ข้อมูลอ้างอิงประเภทรายงานแสดงลักษณะการทำงานของแต่ละคอลัมน์) ดังนี้

  • คอลัมน์แอตทริบิวต์ คอลัมน์แอตทริบิวต์มีข้อมูลที่กำหนดค่าหรือระบุเอนทิตีในแคมเปญ เช่น ชื่อแคมเปญหรือราคาเสนอระดับคีย์เวิร์ด Search Ads 360 API จะแสดงค่าปัจจุบันสำหรับคอลัมน์แอตทริบิวต์เสมอ โดยไม่คำนึงถึงวันที่หรือช่วงวันที่ที่ระบุในคำขอ ตัวอย่างเช่น หากคุณเปลี่ยนแปลงราคาเสนอของคีย์เวิร์ดจาก 2.00 เป็น 1.50 เมื่อวาน แล้วขอรายงานข้อมูลของเดือนที่แล้ว รายงานจะแสดงค่าการเสนอราคาระดับคีย์เวิร์ด 1.50

  • คอลัมน์เมตริก คอลัมน์เมตริกมีข้อมูลเกี่ยวกับประสิทธิภาพของแคมเปญ เช่น จำนวนการคลิกโฆษณา จำนวนการเข้าชมที่แท็ก Floodlight บันทึกไว้ หรือรายได้ API จะแสดงค่ารวมสำหรับคอลัมน์เมตริก เว้นแต่คุณจะระบุช่วงเวลาของวันเดียว เช่น หากคุณขอรายงานข้อมูลของเดือนที่แล้ว API จะแสดงจำนวนคลิกรวมของเดือนที่แล้ว

  • แบ่งกลุ่มคอลัมน์ คอลัมน์กลุ่มจะแบ่งข้อมูลออกเป็นแถวๆ แยกต่างหาก เช่น date เป็นคอลัมน์กลุ่มที่คุณระบุรายงานได้หลายประเภท หากคุณระบุคอลัมน์ date ในรายงานคีย์เวิร์ดโดยใช้ช่วงวันที่ 2013-01-01 ถึง 07-01-2013 API จะแสดงแถว 7 แถวสําหรับคีย์เวิร์ดแต่ละรายการ โดยแต่ละรายการแสดงเป็นเวลา 1 วัน และแสดงเมตริกของวันนั้น ดูรายงานที่แบ่งกลุ่ม

สกุลเงิน

คำขอรายงานของคุณต้องระบุสกุลเงินของข้อมูลเงิน (ทั้งแอตทริบิวต์ เช่น dailyBudget และเมตริก เช่น cost) คุณระบุอย่างใดอย่างหนึ่งต่อไปนี้ได้

  • สกุลเงินของเอเจนซี หากรายงานกำหนดขอบเขตเป็นเอเจนซี ผู้ลงโฆษณา หรือบัญชีเครื่องมือค้นหา
  • สกุลเงินของผู้ลงโฆษณา หากรายงานมุ่งเน้นไปที่ผู้ลงโฆษณาหรือบัญชีเครื่องมือค้นหา
  • สกุลเงินของบัญชีเครื่องมือค้นหา หากรายงานมีขอบเขตอยู่ในบัญชีเครื่องมือค้นหา
  • USD

ใช้พร็อพเพอร์ตี้คำขอ Reports.request.statisticsCurrency เพื่อระบุสกุลเงิน

ตัวรายงานเองจะระบุสกุลเงินในพร็อพเพอร์ตี้ Reports.statisticsCurrencyCode

เขตเวลา

เมตริก Search Ads 360 จัดเก็บเป็นวันที่ที่ไม่มีเขตเวลา วันที่เหล่านี้สอดคล้องกับเขตเวลาของบัญชีเครื่องมือค้นหาสำหรับเมตริกเครื่องมือค้นหา (เช่น คลิก การแสดงผล และการเข้าชม) และเขตเวลาของเครือข่าย Campaign Manager สำหรับเมตริก Conversion (เช่น การกระทำ ธุรกรรม และรายได้) เมื่อทุกเมตริกในรายงานมาจากเขตเวลาเดียวกัน ระบบจะส่งเขตเวลานั้นในคำขอ มิฉะนั้น จะไม่มีการแสดงเขตเวลา คำขอของคุณอาจตั้งค่า Reports.request.verifySingleTimeZone: true เป็นรายงานที่แสดงเมตริกจากเขตเวลามากกว่า 1 เขตเวลาไม่ได้

หากเมตริกทั้งหมดที่แสดงในรายงานมาจากเขตเวลาเดียว ระบบจะแสดงเขตเวลานั้นใน Reports.statisticsTimeZoneReports