Báo cáo dàn xếp trình bày dữ liệu về hiệu suất của bên thứ ba. Nếu bạn chưa hiểu rõ về báo cáo dàn xếp, hãy xem bài viết này trên Trung tâm trợ giúp.
Kích thước
Trong báo cáo, các phương diện được dùng để nhóm các phương diện. Nếu không có phương diện nào được chỉ định, báo cáo sẽ trả về một hàng các chỉ số được yêu cầu cho toàn bộ tài khoản. Mỗi báo cáo có nhiều phương diện, hãy xem báo cáo mạng và các phương diện báo cáo dàn xếp để biết thêm thông tin chi tiết.
Loại quảng cáo (ví dụ: "văn bản" hoặc "hình ảnh").
Chỉ số
Chỉ số đại diện cho các phép đo khác nhau mà bạn có thể thực hiện trên dữ liệu đó. Khi có yêu cầu báo cáo, chỉ số sẽ được tính theo các phương diện đã chọn. Một báo cáo phải có ít nhất một chỉ số. Mỗi báo cáo có nhiều chỉ số, hãy xem báo cáo mạng
và các chỉ số báo cáo dàn xếp
để biết thêm thông tin chi tiết.
Tỷ lệ quảng cáo được hiển thị trên số quảng cáo được trả về, được xác định bằng số lượt hiển thị / số yêu cầu đã so khớp. Giá trị này là số thập phân có độ chính xác kép (gần đúng).
Bộ lọc
Bộ lọc cho phép bạn giới hạn các hàng có trong báo cáo bằng cách chỉ định phương diện cần lọc và biểu thức lọc.
Ví dụ: bạn có thể áp dụng bộ lọc bên dưới cho một báo cáo dàn xếp để xem hiệu suất của Meta Audience Network. Hãy xem danh sách đầy đủ các nguồn quảng cáo
mà bạn có thể xem trong báo cáo dàn xếp.
Báo cáo có giới hạn là 100.000 hàng. Khi một báo cáo có hơn 100.000 hàng được yêu cầu, báo cáo đó sẽ bị cắt bớt và 100.000 hàng đầu tiên sẽ được trả về. Hãy xem nội dung phản hồi báo cáo để biết thêm thông tin về định dạng phản hồi.
Để đảm bảo bạn nhận được tất cả các hàng, hãy thử giảm kích thước của báo cáo bằng cách:
Giảm phạm vi ngày trong yêu cầu.
Giảm số lượng phương diện vì các phương diện này đóng vai trò là hệ số. Khi thêm một phương diện, số lượng hàng sẽ được nhân lên, trong khi việc thêm chỉ số mới vào báo cáo sẽ tạo ra một cột mới.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eThe AdMob API offers Network and Mediation reports to provide insights into ad performance and third-party network data.\u003c/p\u003e\n"],["\u003cp\u003eReports utilize dimensions for grouping data and metrics for measuring performance, with customizable options for filtering and reducing report size.\u003c/p\u003e\n"],["\u003cp\u003eNew user roles and permissions will impact the data returned by the AdMob API, requiring users to review updated documentation.\u003c/p\u003e\n"],["\u003cp\u003eReports are limited to 100,000 rows, and users can adjust date ranges and dimensions to retrieve complete data.\u003c/p\u003e\n"]]],["The AdMob API generates network and mediation reports. Reports utilize dimensions for grouping data; without them, a single row with metrics is returned. Metrics are measurements calculated based on chosen dimensions; at least one is required per report. Filters, like `AD_SOURCE`, restrict rows based on a dimension. Reports are limited to 100,000 rows. To manage this limit you can reduce the number of dimensions, or shorten the date range. Note that new user roles will impact data returned by the API.\n"],null,["# Reporting\n\n| **Important:** New user roles and permissions will affect data returned by the AdMob API. [Learn more](//support.google.com/admob/answer/2784628)\n\nThe AdMob API has the ability to generate the following reports:\n\nNetwork report\n: The network report provides data on AdMob's performance and generates the\n same data found in the\n [AdMob UI network report](//support.google.com/admob/answer/9005740).\n\nMediation report\n: The mediation report includes third-party performance. If you are unfamiliar\n with the mediation report, take a look at the\n [Help Center article](//support.google.com/admob/answer/9005741).\n\nDimensions\n----------\n\n| **Note:** Some dimensions and metrics are incompatible and will cause a conflict to arise in a single report. For additional information, see the [report reference documentation](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#dimension).\n\nIn reports, dimensions are used for grouping purposes, and if no dimensions are\nspecified, the report returns a single row of the requested metrics for the\nentire account. Each report has various dimensions, see [network report](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#dimension)\nand [mediation report dimensions](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimension)\nfor more details.\n\nExamples:\n\n| Report type | Dimension | Description |\n|------------------|------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|\n| Mediation report | [AD_SOURCE](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimension) | The unique ID of the ad source (for example, \"5450213213286189855\" and \"AdMob Network\" as label value). |\n| Network report | [AD_TYPE](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#dimension) | Type of the ad (for example, \"text\" or \"image\"). |\n\nMetrics\n-------\n\nMetrics represent the different measurements you can make on that data. When a\nreport is requested, the metrics are calculated according to the chosen\ndimensions. A report must include at least one metric. Each report has various\nmetrics, see [network report](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#metric)\nand [mediation report metrics](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#metric)\nfor more details.\n\nExamples:\n\n| Report type | Metric | Description |\n|------------------|----------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Mediation report | [OBSERVED_ECPM](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimension) | The third-party ad network's estimated average eCPM. |\n| Network report | [SHOW_RATE](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#metric) | The ratio of ads that are displayed over ads that are returned, defined as impressions / matched requests. The value is a double precision (approximate) decimal value. |\n\nFilters\n-------\n\nFilters allow you to restrict the rows that get included in the report by\nspecifying a [dimension to filter](/admob/api/v1/reference/rest/v1/accounts.mediationReport/generate#dimensionfilter) on and the filter expression.\n\nFor example, the filter below can be applied to a mediation report to view\nMeta Audience Network's performance. Take a look at the complete [list of ad sources](/admob/api/v1/ad-sources-reference)\nthat can be viewed in the mediation report.\n\n| Dimension Filter | Filter Expression | Description |\n|------------------|-------------------------------------|-------------------------------------------------------------------------------|\n| AD_SOURCE | matchesAny = {10568273599589928883} | Filters report rows based on [ad source](/admob/api/v1/ad-sources-reference). |\n\nReduce report limits\n--------------------\n\nReports have a limit of 100,000 rows. When a report with over 100,000 rows is\nrequested, the report will be truncated and the first 100,000 rows will be\nreturned. See the [report response body](/admob/api/v1/reference/rest/v1/accounts.networkReport/generate#response-body)\nfor additional information on the response format.\n\nTo ensure you are receiving all rows, try reducing the size of the report by:\n\n- Reducing the date range in the request.\n- Reducing the number of dimensions as they act as a multiplier. Adding a dimension multiplies the number of rows, whereas adding a new metric to a report produces a new column."]]
