Method: accounts.campaignReport.generate

Tạo Báo cáo chiến dịch dựa trên thông số được cung cấp.

Yêu cầu HTTP

POST https://admob.googleapis.com/v1beta/{parent=accounts/*}/campaignReport:generate

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
parent

string

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 (CampaignReportSpec)
  }
}
Các trường
reportSpec

object (CampaignReportSpec)

Quy cách báo cáo chiến dịch.

Nội dung phản hồi

Phản hồi API Báo cáo chiến dịch.

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 
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
Các trường
rows[]

object (ReportRow)

Dữ liệu báo cáo chiến dịch từ nhà xuất bản được chỉ định. API sẽ trả về tối đa 100.000 hàng.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • 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.

CampaignReportSpec

Thông số kỹ thuật để tạo báo cáo Chiến dịch. Ví dụ: thông số kỹ thuật để nhận được Tham gia và LƯỢT NHẤP được phân chia theoCAMPAIGN_ID có thể giống như ví dụ sau:

{
  "dateRange": {
    "startDate": {"year": 2021, "month": 12, "day": 1},
    "endDate": {"year": 2021, "month": 12, "day": 30}
  },
  "dimensions": ["CAMPAIGN_ID"],
  "metrics": ["IMPRESSIONS", "CLICKS"],
}
Biểu diễn dưới dạng JSON 
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "languageCode": string
}
Các trường
dateRange

object (DateRange)

Phạm vi ngày tạo báo cáo. Phạm vi tối đa là 30 ngày.
dimensions[]

enum (Dimension)

Danh sách các phương diện của báo cáo. 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[]

enum (Metric)

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ố.
languageCode

string

Ngôn ngữ được dùng cho văn bản đã bản địa hoá, chẳng hạn như một số giá trị phương diện có thể áp dụng. Thẻ ngôn ngữ được xác định trong BCP47 của IETF. Giá trị mặc định là "en-US" nếu không được chỉ định hoặc không hợp lệ.

Phương diện

Các phương diện của báo cáo chiến dịch.

Enum
DIMENSION_UNSPECIFIED Giá trị mặc định của phương diện không xác định. Không được dùng.
DATE Ngày ở định dạng YYYYMMDD (ví dụ: "20210701").
CAMPAIGN_ID Mã nhận dạng duy nhất của chiến dịch (ví dụ: "123456789") nhất quán với mã chiến dịch trong API danh sách chiến dịch.
CAMPAIGN_NAME Tên của chiến dịch.
AD_ID Mã nhận dạng duy nhất của quảng cáo, ví dụ: "123456789".
AD_NAME Tên quảng cáo, có thể không phải là duy nhất.
PLACEMENT_ID Mã nhận dạng duy nhất theo nhà cung cấp cụ thể của ứng dụng đặt quảng cáo. Ví dụ: com.goog.bar cho Android và 123456789 cho ứng dụng iOS.
PLACEMENT_NAME Tên của ứng dụng đặt quảng cáo.
PLACEMENT_PLATFORM Nền tảng của ứng dụng nơi đặt quảng cáo.
COUNTRY Tên của quốc gia được nhắm đến.
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.

Chỉ số

Các chỉ số của báo cáo chiến dịch.

Enum
METRIC_UNSPECIFIED Giá trị mặc định cho trường chưa được đặt. Không được dùng.
IMPRESSIONS Số lần một quảng cáo hiển thị cho người dùng.
CLICKS Số lần người dùng nhấp vào một quảng cáo.
CLICK_THROUGH_RATE Số lượt nhấp mà một quảng cáo nhận được chia cho số lần quảng cáo đó hiển thị.
INSTALLS Số lần ứng dụng được tải xuống thiết bị.
ESTIMATED_COST Chi phí ước tính để phân phát quảng cáo trong chiến dịch thay vì một quảng cáo kiếm được doanh thu. Đơn vị tiền tệ là đơn vị tiền tệ báo cáo cho chiến dịch.
AVERAGE_CPI Chi phí trung bình cho mỗi lượt cài đặt. Đây là số tiền trung bình bạn đã chi tiêu để thu nạp một người dùng mới. Đơn vị tiền tệ là đơn vị tiền tệ báo cáo cho chiến dịch.
INTERACTIONS Số lần một người dùng tương tác với quảng cáo. Chỉ số này bao gồm lượt nhấp và lượt tương tác.