Báo cáo gia tăng
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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=timestampYê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=timestampYê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.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2023-12-14 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2023-12-14 UTC."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data into your workflows.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports allow you to retrieve only the data that has changed since your last request, making reports smaller and more efficient.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to periodically request full reports in addition to incremental reports to ensure all data is captured.\u003c/p\u003e\n"],["\u003cp\u003eIncremental reports can be requested based on either changed metrics or changed attributes using specific time range properties.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003echangedAttributesSinceTimestamp\u003c/code\u003e requests provide efficient updates for attributes, changes to parent attributes might not be reflected, necessitating awareness of potential data discrepancies.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows users to build custom reports and integrate data into their applications. It offers incremental reports, which retrieve only data that has changed since the last request, reducing report size. Users can request changes in metrics (`changedMetricsSinceTimestamp`) or attributes (`changedAttributesSinceTimestamp`). Full reports are still recommended periodically to ensure no data is missed. For `changedMetricsSinceTimestamp`, data must be segmented by day and should be requested every seven days. Changed attributes only report changes to the attribute itself, not inherited changes from parent.\n"],null,["# Incremental Reports\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\nInstead of receiving a dump of all data every time you request a report, you can\nperiodically request only the data that has changed since your last report. These\nincremental reports will likely be significantly smaller than a full report.\n\nIf you request incremental reports, you should be aware of the following:\n\n- It's still a good idea to request a full report every once in a while, just in case some incremental changes are lost. For example, if you request weekly incremental reports during January, at the end of February you should request a full report for January to make sure you get all of the January data.\n- Since it isn't always possible to determine if some entities have changed, an incremental report will contain an entity if Search Ads 360 even *suspects* that the entity has changed. This means that incremental reports might contain data that hasn't changed.\n\n\nTo request an incremental report, specify one of the following ` `[Reports.request.timeRange](/search-ads/v2/reference/reports#request.timeRange)`\n` properties:\n\n`changedMetricsSinceTimestamp=`*timestamp*\n\n: Requests metrics that have changed since the specified timestamp. Because metrics are\n stored at a daily granularity and might change for one day but not another, such\n requests must be segmented by day (the `date` column must be present). For\n example, a `keyword` report with the columns\n `clicks`, `actions`, and `date`, would\n return a row for each keyword and date in which the recorded number of\n clicks or actions has changed since the given timestamp.\n\n\n The timestamp must be no earlier than 8 days before the time of request. To capture\n all of the changing metrics, be sure to make a `changedMetricsSinceTimestamp`\n request at least once every 7 days, and make a full report for each date\n once the metrics have settled (it is safer to wait at least 7 days). An\n example pattern is to create two reports every day: an incremental\n report for metrics that have changed in the last 36 hours, and a full\n report for metrics that occurred 8 days ago.\n\n`changedAttributesSinceTimestamp=`*timestamp*\n\n: Requests attributes that have changed since the given timestamp. A\n `changedAttributesSinceTimestamp` request can only include\n attribute columns (no metric or segment columns), and does not work for\n raw event reports such as\n [`conversion`](/search-ads/v2/report-types/conversion) reports. For example, a\n `campaign` report with the columns `dailyBudget`\n and `campaignStartDate` would return a row for each campaign\n whose daily budget or start date has changed since the given timestamp.\n\n\n Note that changes to parent attributes are not captured in `changedAttributesSinceTimestamp` reports. For example a keyword may inherit its bid strategy from the parent ad group. Even if the ad group is assigned a new bid strategy, this keyword might not appear in the report. Attribute columns whose value depends on parent entities (and therefore could change without getting picked up by `changedAttributesSinceTimestamp` reports) usually have the prefix \"effective\", such as `effectiveLabelIds` or `effectiveBidStartegy`.\n\n \u003cbr /\u003e"]]
