API Quản lý AdSense có các lệnh gọi để tạo báo cáo mới và đã lưu. Chúng có thể chứa các số liệu phân tích đơn giản như thu nhập mỗi ngày hoặc các bảng tỷ lệ nhấp rất phức tạp trên mỗi kênh tuỳ chỉnh ở mỗi quốc gia. Hướng dẫn này trình bày danh sách các trường hợp hiếm gặp cần được xử lý chính xác để tích hợp hiệu quả với các API.
Cấu trúc báo cáo
Kết quả báo cáo được trả về dưới dạng đối tượng ReportResult. Hãy xem tài liệu tham khảo về phản hồi báo cáo để biết thông tin chi tiết đầy đủ.
Sử dụng phương diện theo trình tự thời gian: DATE, WEEK và MONTH
Báo cáo có thể bị trống hoặc có khoảng trống
Nếu không có hoạt động nào trong khoảng thời gian đã chỉ định trong yêu cầu, thì sẽ không có yêu cầu quảng cáo nào được tạo và dịch vụ báo cáo sẽ không hiển thị các hàng trong khoảng thời gian đó. Điều này rất quan trọng nếu bạn đang vẽ đồ thị chẳng hạn.
Hãy xem hướng dẫn Điền ngày để biết thêm thông tin.
Yêu cầu phương diện MONTH và WEEK trong cùng một báo cáo
Báo cáo này có thể gây ra hậu quả tiêu cực hoặc không mong muốn. Nếu một tuần thuộc về hai tháng khác nhau, hệ thống sẽ hiển thị hai hàng trong cùng một tuần, mỗi tháng một hàng.
Ví dụ:
| Kích thước | Chỉ số | Ngày bắt đầu | Ngày kết thúc |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
Trả về:
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | 2014-04-27 | 43 |
* ngày đầu tiên trong tuần
Giải pháp
Xoá MONTH khỏi báo cáo.
WEEK | CLICKS |
|---|---|
| 2014-04-27 | 93 |
Thu thập các giá trị phương diện
Khi yêu cầu các phương diện như các phương diện liên quan, ví dụ: nền tảng (máy tính, thiết bị di động cao cấp, v.v.), chỉ các nền tảng có hoạt động mới được hiển thị. Nếu một ngày, tuần hoặc tháng nhất định không có lượt truy cập nào từ các thiết bị di động cao cấp, thì danh mục đó sẽ không có thông tin.
Ví dụ:
| Kích thước | Chỉ số | Ngày bắt đầu | Ngày kết thúc |
|---|---|---|---|
PLATFORM_TYPE_NAMEMONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
Trả về:
| THÁNG | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Máy tính | 100 |
| 2014-03 | Điện thoại di động cao cấp | 5 |
| 2014-04 | Máy tính | 75 |
Giải pháp
Khi xử lý kết quả báo cáo, hãy giả định một giá trị bằng 0 cho mọi giá trị phương diện không xuất hiện trong kết quả:
| THÁNG | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Máy tính | 100 |
| 2014-03 | Điện thoại di động cao cấp | 5 |
| 2014-04 | Máy tính | 75 |
| 2014-04 | Thiết bị di động cao cấp | 0 |
Kết hợp nhiều báo cáo liền nhau
Đôi khi, một báo cáo có kích thước quá lớn nên không thể được tạo cùng một lúc và phải gộp nhóm lại. Nếu ứng dụng của bạn làm như vậy, hãy xem xét các trường hợp sau:
- Nếu bạn đang sử dụng phương diện
WEEKhoặcMONTHvà bạn sẽ chia tách báo cáo vào giữa một tuần hoặc một tháng, mỗi báo cáo sẽ có các mục trùng lặp với dữ liệu khác nhau. - Hãy đảm bảo tất cả báo cáo đều có chỉ số và phương diện giống nhau, vì không thể kết hợp dữ liệu bằng các phương diện khác nhau.
Tài khoản đặc biệt
Một số người dùng của bạn có thể sở hữu tài khoản AdSense với các thuộc tính mà bạn không mong đợi hoặc không biết. Hãy nhớ lưu ý những điều sau:
- Nhà xuất bản có hàng nghìn miền hoặc trang web
- Nhà xuất bản có hàng nghìn đơn vị quảng cáo hoặc kênh tuỳ chỉnh
- Nhà xuất bản muốn báo cáo về nhiều ứng dụng quảng cáo (AdSense cho Tìm kiếm, AdSense cho Video, v.v.)
Nhiều tài khoản
Người dùng có thể có quyền truy cập vào nhiều tài khoản AdSense. Vì lý do này, bạn phải chỉ định mã tài khoản cho mỗi lệnh gọi đến API. Lệnh gọi đến accounts.list tìm nạp danh sách tài khoản và hộp thoại trình chọn tài khoản sẽ hiển thị cho người dùng. Phương thức này có thể bị bỏ qua nếu số lượng tài khoản được tìm nạp là 1.
Thay đổi múi giờ
Nhà xuất bản AdSense có thể thay đổi múi giờ của họ bất cứ lúc nào và điều này có thể tạo ra mức tăng hoặc giảm đột biến trong báo cáo. Hãy đọc hướng dẫn về Báo cáo múi giờ địa phương để biết thêm thông tin.