- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- MediationReportSpec
- Kích thước
- Chỉ số
- DimensionFilter
- SortCondition (Tình trạng sắp xếp)
- Ví dụ
- Hãy làm thử!
Tạo báo cáo Dàn xếp AdMob dựa trên đặc tả báo cáo được cung cấp. Trả về kết quả của một RPC truyền trực tuyến phía máy chủ. Kết quả sẽ được trả về theo một chuỗi phản hồi.
Yêu cầu HTTP
POST https://admob.googleapis.com/v1/{parent=accounts/*}/mediationReport:generate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số | |
---|---|
parent |
Tên tài nguyên của tài khoản để tạo báo cáo. Ví dụ: accounts/pub-9876543210987654 |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"reportSpec": {
object ( |
Trường | |
---|---|
reportSpec |
Quy cách báo cáo mạng. |
Nội dung phản hồi
Phản hồi theo luồng cho báo cáo Dàn xếp AdMob, trong đó phản hồi đầu tiên chứa tiêu đề báo cáo, sau đó là luồng phản hồi theo hàng và cuối cùng là chân trang làm thông báo phản hồi cuối cùng.
Ví dụ:
[{
"header": {
"dateRange": {
"startDate": {"year": 2018, "month": 9, "day": 1},
"endDate": {"year": 2018, "month": 9, "day": 1}
},
"localizationSettings": {
"currencyCode": "USD",
"languageCode": "en-US"
}
}
},
{
"row": {
"dimensionValues": {
"DATE": {"value": "20180918"},
"APP": {
"value": "ca-app-pub-8123415297019784~1001342552",
"displayLabel": "My app name!"
}
},
"metricValues": {
"ESTIMATED_EARNINGS": {"decimal_value": "1324746"}
}
}
},
{
"footer": {"matchingRowCount": 1}
}]
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp payload . Mỗi thông báo phản hồi theo luồng chứa một loại tải trọng. payload chỉ có thể là một trong những trạng thái sau: |
|
header |
Chế độ cài đặt tạo báo cáo mô tả nội dung báo cáo, chẳng hạn như phạm vi ngày báo cáo và chế độ cài đặt bản địa hoá. |
row |
Dữ liệu báo cáo thực tế. |
footer |
Thông tin bổ sung về báo cáo đã tạo, chẳng hạn như cảnh báo về dữ liệu. |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau đây:
https://www.googleapis.com/auth/admob.readonly
https://www.googleapis.com/auth/admob.report
Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
MediationReportSpec
Thông số kỹ thuật để tạo báo cáo Dàn xếp AdMob. Ví dụ: thông số kỹ thuật để quan sát được ECPM (CPM mục tiêu) được quan sát được chia theo nguồn quảng cáo và ứng dụng cho các quốc gia "Hoa Kỳ" và "Trung Quốc" có thể giống như ví dụ sau:
{
"dateRange": {
"startDate": {"year": 2021, "month": 9, "day": 1},
"endDate": {"year": 2021, "month": 9, "day": 30}
},
"dimensions": ["AD_SOURCE", "APP", "COUNTRY"],
"metrics": ["OBSERVED_ECPM"],
"dimensionFilters": [
{
"dimension": "COUNTRY",
"matchesAny": {"values": [{"value": "US", "value": "CN"}]}
}
],
"sortConditions": [
{"dimension":"APP", order: "ASCENDING"}
],
"localizationSettings": {
"currencyCode": "USD",
"languageCode": "en-US"
}
}
Để hiểu rõ hơn, bạn có thể xem nội dung đặc tả kỹ thuật trước đó như SQL giả sau đây:
SELECT AD_SOURCE, APP, COUNTRY, OBSERVED_ECPM
FROM MEDIATION_REPORT
WHERE DATE >= '2021-09-01' AND DATE <= '2021-09-30'
AND COUNTRY IN ('US', 'CN')
GROUP BY AD_SOURCE, APP, COUNTRY
ORDER BY APP ASC;
Biểu diễn dưới dạng JSON |
---|
{ "dateRange": { object ( |
Trường | |
---|---|
dateRange |
Phạm vi ngày tạo báo cáo. |
dimensions[] |
Danh sách các phương diện của báo cáo. Sự kết hợp giá trị của các phương diện này sẽ xác định hàng của báo cáo. Nếu bạn không chỉ định phương diện nào, báo cáo sẽ trả về một hàng chỉ số được yêu cầu cho toàn bộ tài khoản. |
metrics[] |
Danh sách các chỉ số của báo cáo. Một báo cáo phải chỉ định ít nhất một chỉ số. |
dimensionFilters[] |
Mô tả hàng báo cáo cần so khớp dựa trên giá trị phương diện. |
sortConditions[] |
Mô tả cách sắp xếp các hàng báo cáo. Thứ tự của điều kiện trong danh sách sẽ xác định mức độ ưu tiên của điều kiện đó. Điều kiện càng sớm thì mức độ ưu tiên càng cao. Nếu bạn không chỉ định điều kiện sắp xếp nào, thì thứ tự hàng không được xác định. |
localizationSettings |
Chế độ cài đặt bản địa hoá của báo cáo. |
maxReportRows |
Số hàng dữ liệu báo cáo tối đa cần trả về. Nếu giá trị không được đặt, API sẽ trả về nhiều hàng nhất có thể, tối đa 100000 hàng. Các giá trị có thể chấp nhận là toàn bộ các giá trị từ 1 đến 100.000. Các giá trị lớn hơn 100.000 sẽ trả về lỗi. |
timeZone |
Múi giờ báo cáo. Chấp nhận các giá trị tên TZ của IANA, chẳng hạn như "America/Thu_Angeles". Nếu bạn không xác định múi giờ, chế độ mặc định của tài khoản sẽ có hiệu lực. Hãy kiểm tra giá trị mặc định bằng thao tác lấy tài khoản. Cảnh báo: Hiện tại, giá trị " America/Thu_Angeles" là giá trị duy nhất được hỗ trợ. |
Phương diện
Các phương diện của báo cáo dàn xếp. Phương diện là các thuộc tính dữ liệu để chia nhỏ hoặc tinh chỉnh các phép đo định lượng (chỉ số) theo một số thuộc tính nhất định, chẳng hạn như định dạng quảng cáo hoặc nền tảng mà người dùng đã xem quảng cáo.
Enum | |
---|---|
DIMENSION_UNSPECIFIED |
Giá trị mặc định cho một trường chưa được đặt. Không được dùng. |
DATE |
Ngày ở định dạng YYYYMMDD (ví dụ: "20210701"). Các yêu cầu có thể chỉ định tối đa một phương diện thời gian. |
MONTH |
Tháng ở định dạng YYYYMM (ví dụ: "202107"). Các yêu cầu có thể chỉ định tối đa một phương diện thời gian. |
WEEK |
Ngày đầu tiên trong một tuần ở định dạng YYYYMMDD (ví dụ: "20210701"). Các yêu cầu có thể chỉ định tối đa một phương diện thời gian. |
AD_SOURCE |
Mã nhận dạng duy nhất của nguồn quảng cáo (ví dụ: giá trị nhãn là "5450213213286189855" và "Mạng AdMob"). |
AD_SOURCE_INSTANCE |
Mã nhận dạng duy nhất của phiên bản nguồn quảng cáo (ví dụ: "ca-app-pub-1234:asi:5678" và "AdMob (mặc định)" dưới dạng giá trị nhãn). |
AD_UNIT |
Mã nhận dạng duy nhất của đơn vị quảng cáo (ví dụ: "ca-app-pub-1234/8790"). Nếu bạn chỉ định phương diện AD_UNIT, thì APP sẽ tự động được đưa vào. |
APP |
Mã nhận dạng duy nhất của ứng dụng di động (ví dụ: "ca-app-pub-1234~1234"). |
MEDIATION_GROUP |
Mã nhận dạng duy nhất của nhóm dàn xếp (ví dụ: "ca-app-pub-1234:mg:1234" và "AdMob (mặc định)" dưới dạng giá trị nhãn). |
COUNTRY |
Mã quốc gia CLDR của nơi diễn ra lượt xem/lượt nhấp vào quảng cáo (ví dụ: "US" hoặc "FR"). Đây là một phương diện địa lý. |
FORMAT |
Định dạng của đơn vị quảng cáo (ví dụ: "biểu ngữ", "gốc"), phương diện phân phối quảng cáo. |
PLATFORM |
Nền tảng hệ điều hành di động của ứng dụng (ví dụ: "Android" hoặc "iOS"). |
MOBILE_OS_VERSION |
Phiên bản hệ điều hành trên thiết bị di động, ví dụ: "iOS 13.5.1". |
GMA_SDK_VERSION |
Phiên bản GMA SDK, ví dụ: "iOS 7.62.0". |
APP_VERSION_NAME |
Đối với Android, bạn có thể tìm thấy tên phiên bản ứng dụng trong versionName của PackageInfo. Đối với iOS, bạn có thể tìm thấy tên phiên bản ứng dụng trong CFBundleShortVersionString. |
SERVING_RESTRICTION |
Chế độ hạn chế đối với việc phân phát quảng cáo (ví dụ: "Quảng cáo không được cá nhân hoá"). |
Chỉ số
Các chỉ số của báo cáo dàn xếp. Chỉ số là các phép đo định lượng cho biết tình hình hoạt động kinh doanh của nhà xuất bản. Hệ thống tổng hợp các chỉ số này từ từng sự kiện quảng cáo và nhóm theo các phương diện báo cáo. Giá trị chỉ số là số nguyên hoặc số thập phân (không làm tròn).
Enum | |
---|---|
METRIC_UNSPECIFIED |
Giá trị mặc định cho một trường chưa được đặt. Không được dùng. |
AD_REQUESTS |
Số lượng yêu cầu. Giá trị là một số nguyên. |
CLICKS |
Số lần người dùng nhấp vào một quảng cáo. Giá trị là một số nguyên. |
ESTIMATED_EARNINGS |
Thu nhập ước tính của nhà xuất bản AdMob. Đơn vị tiền tệ (USD, EUR hoặc đơn vị tiền tệ khác) của các chỉ số thu nhập được xác định theo chế độ cài đặt bản địa hoá đơn vị tiền tệ. Số lượng được tính bằng phần triệu. Ví dụ: $6, 5 sẽ được biểu diễn là 6500000. Kể từ ngày 20 tháng 10 năm 2019, chúng tôi hỗ trợ thu nhập ước tính trên mỗi nhóm dàn xếp và mỗi cấp bản sao nguồn quảng cáo. Thu nhập ước tính của bên thứ ba sẽ hiển thị bằng 0 đối với các ngày trước ngày 20 tháng 10 năm 2019. |
IMPRESSIONS |
Tổng số quảng cáo đã hiển thị cho người dùng. Giá trị là một số nguyên. |
IMPRESSION_CTR |
Tỷ lệ số lượt nhấp so với số lượt hiển thị. Giá trị này là một giá trị thập phân có độ chính xác kép (gần đúng). |
MATCHED_REQUESTS |
Số lần quảng cáo được trả về theo yêu cầu. Giá trị là một số nguyên. |
MATCH_RATE |
Tỷ lệ yêu cầu quảng cáo được so khớp trên tổng số yêu cầu quảng cáo. Giá trị này là một giá trị thập phân có độ chính xác kép (gần đúng). |
OBSERVED_ECPM |
eCPM trung bình ước tính của mạng quảng cáo bên thứ ba. Đơn vị tiền tệ (USD, EUR hoặc đơn vị tiền tệ khác) của các chỉ số thu nhập được xác định theo chế độ cài đặt bản địa hoá đơn vị tiền tệ. Số lượng được tính bằng phần triệu. Ví dụ: $2, 3 sẽ được biểu diễn là 2300000. Chúng tôi hỗ trợ eCPM trung bình ước tính cho mỗi nhóm dàn xếp và cấp phiên bản nguồn quảng cáo kể từ ngày 20 tháng 10 năm 2019. eCPM trung bình ước tính của bên thứ ba sẽ hiển thị bằng 0 đối với những ngày trước ngày 20 tháng 10 năm 2019. |
DimensionFilter
Mô tả hàng báo cáo cần so khớp dựa trên giá trị phương diện.
Biểu diễn dưới dạng JSON |
---|
{ "dimension": enum ( |
Trường | |
---|---|
dimension |
Áp dụng tiêu chí lọc cho phương diện được chỉ định. |
Trường hợp operator . Toán tử lọc sẽ được áp dụng. operator chỉ có thể là một trong những trạng thái sau: |
|
matchesAny |
So khớp một hàng nếu giá trị của hàng đó cho phương diện được chỉ định thuộc một trong các giá trị được chỉ định trong điều kiện này. |
SortCondition
Hướng sắp xếp sẽ được áp dụng cho một phương diện hoặc một chỉ số.
Biểu diễn dưới dạng JSON |
---|
{ "order": enum ( |
Trường | |
---|---|
order |
Thứ tự sắp xếp của phương diện hoặc chỉ số. |
Trường hợp sort_on . Xác định các giá trị để sắp xếp. sort_on chỉ có thể là một trong những trạng thái sau: |
|
dimension |
Sắp xếp theo phương diện đã chỉ định. |
metric |
Sắp xếp theo chỉ số được chỉ định. |