API Báo cáo Search Ads 360 cũ sẽ ngừng hoạt động và ngừng hoạt động từ ngày 30 tháng 6 năm 2024. Xin lưu ý rằng API Lượt chuyển đổi Search Ads 360 không bị ảnh hưởng và sẽ tiếp tục được hỗ trợ. Mọi hoạt động phát triển báo cáo mới đều phải sử dụng API Báo cáo Search Ads 360 mới.

Kể từ tháng 4 năm 2024, hệ thống sẽ trả về lỗi supportedApiVersion trong khi yêu cầu báo cáo. Xem chi tiết tại đây.

Bạn cũng nên di chuyển mọi hoạt động triển khai Search Ads 360 hiện có sang API mới. Hãy xem Bắt đầu và Hướng dẫn di chuyển API Báo cáo Search Ads 360 mới để biết thêm thông tin.

Trang này được dịch bởi Cloud Translation API.

Báo cáo gia tăng

API Báo cáo Search Ads 360 mới hiện đã ra mắt. API mới mang đến khả năng linh hoạt hơn nữa trong việc xây dựng các báo cáo tuỳ chỉnh và tích hợp dữ liệu vào các ứng dụng và quy trình báo cáo. Hãy tìm hiểu thêm về việc di chuyển sang và sử dụng API Báo cáo Search Ads 360 mới.

Thay vì nhận được tệp kết xuất mọi dữ liệu mỗi khi yêu cầu báo cáo, bạn có thể chỉ yêu cầu định kỳ dữ liệu đã thay đổi kể từ báo cáo gần đây nhất. Những báo cáo gia tăng này có thể sẽ nhỏ hơn đáng kể so với một báo cáo đầy đủ.

Nếu bạn yêu cầu báo cáo gia tăng, bạn cần lưu ý những điều sau:

Bạn vẫn nên thỉnh thoảng yêu cầu nhận báo cáo đầy đủ, phòng khi một số thay đổi gia tăng bị mất. Ví dụ: nếu yêu cầu báo cáo gia tăng hằng tuần trong tháng 1, thì vào cuối tháng 2, bạn nên yêu cầu báo cáo đầy đủ cho tháng 1 để đảm bảo nhận được tất cả dữ liệu của tháng 1.
Vì không phải lúc nào cũng có thể xác định xem một số thực thể đã thay đổi hay chưa, nên báo cáo gia tăng sẽ chứa một thực thể nếu Search Ads 360 nghi ngờ thực thể đó đã thay đổi. Điều này có nghĩa là các báo cáo gia tăng có thể chứa dữ liệu không thay đổi.

Để yêu cầu một báo cáo gia tăng, hãy chỉ định một trong các thuộc tính Reports.request.timeRange sau:

changedMetricsSinceTimestamp=timestamp

Yêu cầu những chỉ số đã thay đổi kể từ dấu thời gian được chỉ định. Vì các chỉ số được lưu trữ ở độ chi tiết hằng ngày và có thể thay đổi trong một ngày nhưng không thay đổi trong ngày khác, nên các yêu cầu như vậy phải được phân đoạn theo ngày (phải có cột date). Ví dụ: báo cáo keyword có các cột clicks, actions và date sẽ trả về một hàng cho từng từ khoá và ngày mà số lượt nhấp hoặc hành động được ghi nhận đã thay đổi kể từ dấu thời gian đã cho.

Dấu thời gian không được sớm hơn 8 ngày trước thời điểm yêu cầu. Để nắm bắt toàn bộ các chỉ số thay đổi, hãy nhớ gửi yêu cầu changedMetricsSinceTimestamp ít nhất 7 ngày một lần và tạo báo cáo đầy đủ cho mỗi ngày sau khi các chỉ số này ổn định (an toàn hơn nếu bạn nên chờ ít nhất 7 ngày). Ví dụ về cách tạo 2 báo cáo mỗi ngày: một báo cáo gia tăng cho những chỉ số đã thay đổi trong 36 giờ qua và một báo cáo đầy đủ cho những chỉ số xảy ra cách đây 8 ngày.

changedAttributesSinceTimestamp=timestamp

Yêu cầu các thuộc tính đã thay đổi kể từ dấu thời gian nhất định. Yêu cầu changedAttributesSinceTimestamp chỉ có thể bao gồm các cột thuộc tính (không có cột chỉ số hoặc phân đoạn) và không hoạt động đối với các báo cáo sự kiện chưa qua xử lý như báo cáo conversion. Ví dụ: báo cáo campaign có các cột dailyBudget và campaignStartDate sẽ trả về một hàng cho mỗi chiến dịch có ngân sách hằng ngày hoặc ngày bắt đầu đã thay đổi kể từ dấu thời gian đã cho.

Xin lưu ý rằng những thay đổi đối với thuộc tính gốc không được ghi lại trong báo cáo changedAttributesSinceTimestamp. Ví dụ: một từ khoá có thể kế thừa chiến lược giá thầu của nhóm quảng cáo gốc. Ngay cả khi nhóm quảng cáo được chỉ định một chiến lược giá thầu mới, từ khoá này có thể sẽ không xuất hiện trong báo cáo. Các cột thuộc tính có giá trị phụ thuộc vào các thực thể mẹ (và do đó có thể thay đổi mà không cần được báo cáo changedAttributesSinceTimestamp chọn) thường có tiền tố "có hiệu lực", chẳng hạn như effectiveLabelIds hoặc effectiveBidStartegy.