AdSense Management API มีการเรียกเพื่อสร้างรายงานใหม่และรายงานที่บันทึกไว้ แพลตฟอร์มเหล่านี้อาจมีข้อมูลวิเคราะห์ง่ายๆ เช่น รายได้ต่อวันหรือตารางอัตราการคลิกผ่านที่ซับซ้อนมากต่อแชแนลที่กำหนดเองต่อประเทศ คู่มือนี้จะแสดงรายการกรณีที่เป็นปัญหาที่สุดซึ่งควรได้รับการจัดการอย่างถูกต้องเพื่อการผสานรวมที่มีประสิทธิภาพกับ API
โครงสร้างรายงาน
ผลลัพธ์ของรายงานจะแสดงเป็นออบเจ็กต์ ReportResult
ดูข้อมูลอ้างอิงการตอบกลับของรายงานสำหรับการแจกแจงข้อมูลทั้งหมด
การใช้มิติข้อมูลที่เรียงตามลำดับเวลา ได้แก่ DATE, WEEK และ MONTH
รายงานอาจว่างเปล่าหรือมีช่องว่าง
หากไม่มีกิจกรรมในระยะเวลาที่ระบุไว้ในคําขอ ระบบจะไม่สร้างคําขอโฆษณาและบริการรายงานจะไม่แสดงแถวสําหรับระยะเวลาเหล่านั้น ซึ่งสำคัญมาก เช่น ถ้าคุณกำลังพล็อตกราฟ
ดูข้อมูลเพิ่มเติมได้ในคู่มือการกรอกวันที่
ขอมิติข้อมูล MONTH และ WEEK ในรายงานเดียวกัน
รายงานนี้อาจส่งผลในแง่ลบหรือไม่คาดคิด ถ้าสัปดาห์หนึ่งมี 2 เดือนที่ต่างกัน ระบบจะแสดงแถว 2 แถวในสัปดาห์เดียวกัน โดยแสดง 1 แถวสำหรับแต่ละเดือน
ตัวอย่าง
ขนาด | เมตริก | วันที่เริ่มต้น | End date |
---|---|---|---|
WEEK MONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
ส่งคืน:
MONTH | WEEK * | CLICKS |
---|---|---|
2014-04 | 2014-04-27 | 50 |
2014-05 | 2014-04-27 | 43 |
* วันแรกของสัปดาห์
โซลูชัน
นํา MONTH
ออกจากรายงาน
WEEK | CLICKS |
---|---|
2014-04-27 | 93 |
ค่ามิติข้อมูลการตรวจเทียบ
เมื่อขอมิติข้อมูลอย่างเช่นมิติข้อมูลที่เกี่ยวข้อง เช่น แพลตฟอร์ม (เดสก์ท็อป อุปกรณ์เคลื่อนที่ระดับไฮเอนด์ ฯลฯ) ระบบจะแสดงเฉพาะแพลตฟอร์มที่มีกิจกรรมเท่านั้น หากวัน สัปดาห์ หรือเดือนใดไม่มีการเข้าชมจากอุปกรณ์เคลื่อนที่ระดับไฮเอนด์ ก็จะไม่มีข้อมูลในหมวดหมู่นั้น
ตัวอย่าง
ขนาด | เมตริก | วันที่เริ่มต้น | End date |
---|---|---|---|
PLATFORM_TYPE_NAME MONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
ส่งคืน:
เดือน | PLATFORM_TYPE_NAME | AD_REQUESTS |
---|---|---|
2014-03 | เดสก์ท็อป | 100 |
2014-03 | อุปกรณ์เคลื่อนที่ระดับไฮเอนด์ | 5 |
2014-04 | เดสก์ท็อป | 75 |
โซลูชัน
เมื่อประมวลผลผลลัพธ์ของรายงาน ให้สมมติว่าค่ามิติข้อมูลที่ไม่ปรากฏในผลลัพธ์มีค่าเป็น 0 ดังนี้
เดือน | PLATFORM_TYPE_NAME | AD_REQUESTS |
---|---|---|
2014-03 | เดสก์ท็อป | 100 |
2014-03 | อุปกรณ์เคลื่อนที่ระดับไฮเอนด์ | 5 |
2014-04 | เดสก์ท็อป | 75 |
2014-04 | อุปกรณ์เคลื่อนที่ระดับไฮเอนด์ | 0 |
การรวมรายงานที่ต่อเนื่องกันหลายฉบับ
บางครั้งรายงานมีขนาดใหญ่เกินกว่าที่จะสร้างได้ในครั้งเดียวและต้องแบ่งเป็นกลุ่ม หากแอปทำเช่นนี้ โปรดพิจารณากรณีต่อไปนี้
- หากคุณใช้มิติข้อมูล
WEEK
หรือMONTH
และกําลังแยกรายงานในช่วงกลางสัปดาห์หรือเดือน แต่ละรายงานจะมีรายการที่ซ้ำกันซึ่งมีข้อมูลต่างกัน - ตรวจสอบว่ารายงานทั้งหมดมีเมตริกและมิติข้อมูลเดียวกัน เนื่องจากข้อมูลอาจนำมารวมกันไม่ได้โดยใช้มิติข้อมูลที่แตกต่างกัน
บัญชีพิเศษ
ผู้ใช้บางรายอาจมีบัญชี AdSense ที่มีแอตทริบิวต์ซึ่งคุณไม่ต้องการหรือไม่ทราบ โปรดคำนึงถึงสิ่งต่อไปนี้
- ผู้เผยแพร่โฆษณาที่มีโดเมนหรือเว็บไซต์หลายพันรายการ
- ผู้เผยแพร่โฆษณาที่มีหน่วยโฆษณาหรือแชแนลที่กำหนดเองหลายพันรายการ
- ผู้เผยแพร่โฆษณาที่ต้องการรายงานเกี่ยวกับไคลเอ็นต์โฆษณาหลายโปรแกรม (AdSense สำหรับ Search, AdSense for Video ฯลฯ)
หลายบัญชี
ผู้ใช้สามารถเข้าถึงบัญชี AdSense ได้มากกว่า 1 บัญชี คุณต้องระบุรหัสบัญชีสำหรับการเรียก API ทุกครั้งด้วยเหตุผลนี้ การเรียกไปยัง accounts.list
จะดึงรายการบัญชี และกล่องโต้ตอบตัวเลือกบัญชีผู้ใช้ควรจะแสดงให้ผู้ใช้เห็น ซึ่งข้ามได้ถ้าจำนวน
บัญชีที่ดึงข้อมูลมีจำนวนเท่ากับ 1 บัญชี
การเปลี่ยนแปลงเขตเวลา
ผู้เผยแพร่โฆษณา AdSense สามารถเปลี่ยนเขตเวลาของตนได้ตลอดเวลา ซึ่งอาจส่งผลให้รายงานมีความกระฉับกระเฉงหรือลดลงอย่างรวดเร็ว อ่านข้อมูลเพิ่มเติมได้ในคู่มือเกี่ยวกับการรายงานเขตเวลาท้องถิ่น