หลังจากตั้งค่าแอปไคลเอ็นต์ตามที่อธิบายไว้ในแอปแรกของฉันแล้ว คุณจะใช้ Search Ads 360 API เพื่อขอและดาวน์โหลดรายงานได้ คุณจะส่งคำขอประเภทใดก็ได้ต่อไปนี้
- ซิงโครนัส
ต้องการเพียงคำขอเดียวและแสดงผลรายงานในการตอบสนองรูปแบบ JSON คำขอแบบซิงโครนัส:
- แสดงผลได้เฉพาะรายงานผู้ลงโฆษณาและบัญชีเครื่องมือค้นหาเท่านั้น
- บล็อกลูกค้าจนกว่า Search Ads 360 จะสร้างรายงาน
หากคุณกำลังขอรายงานขนาดใหญ่จากผู้ลงโฆษณาหรือบัญชีเครื่องมือค้นหา เราขอแนะนำวิธีแบบไม่พร้อมกัน
- อะซิงโครนัส
กำหนดให้คุณต้องส่งคำขอเริ่มต้นที่ระบุข้อมูลที่ต้องการในรายงาน จากนั้นคุณส่งคำขอเพิ่มเติมไปยังแบบสำรวจของ 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