Method: accounts.campaignReport.generate

제공된 사양을 기반으로 캠페인 보고서를 생성합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
parent

string

보고서를 생성할 계정의 리소스 이름입니다. 예: accounts/pub-9876543210987654

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "reportSpec": {
    object (CampaignReportSpec)
  }
}
필드
reportSpec

object (CampaignReportSpec)

캠페인 보고서 사양

응답 본문

Campaign Report API 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
필드
rows[]

object (ReportRow)

지정된 게시자의 캠페인 보고서 데이터입니다. API에서 최대 100,000개의 행이 반환됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/admob.readonly
  • https://www.googleapis.com/auth/admob.report

자세한 내용은 OAuth 2.0 개요를 참고하세요.

CampaignReportSpec

캠페인 보고서 생성을 위한 사양입니다. 예를 들어 CAMPAIGN_ID로 분할한 IMPRESSIONS 및 클릭수를 가져오는 사양은 다음 예와 같습니다.

{
  "dateRange": {
    "startDate": {"year": 2021, "month": 12, "day": 1},
    "endDate": {"year": 2021, "month": 12, "day": 30}
  },
  "dimensions": ["CAMPAIGN_ID"],
  "metrics": ["IMPRESSIONS", "CLICKS"],
}
JSON 표현 
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "languageCode": string
}
필드
dateRange

object (DateRange)

보고서가 생성되는 기간입니다. 최대 기간은 30일입니다.
dimensions[]

enum (Dimension)

보고서의 측정기준 목록입니다. 이러한 측정기준의 값 조합에 따라 보고서의 행이 결정됩니다. 측정기준을 지정하지 않으면 보고서는 계정 전체에 대해 요청된 측정항목의 단일 행을 반환합니다.
metrics[]

enum (Metric)

보고서의 측정항목 목록입니다. 보고서에서는 측정항목을 1개 이상 지정해야 합니다.
languageCode

string

현지화된 텍스트에 사용되는 언어입니다(예: 적용 가능한 특정 측정기준 값). 언어 태그는 IETF BCP47에 정의되어 있습니다. 지정되지 않거나 유효하지 않은 경우 기본값은 'en-US'입니다.

측정기준

캠페인 보고서의 측정기준입니다.

열거형
DIMENSION_UNSPECIFIED 지정되지 않은 측정기준의 기본값입니다. 사용하지 않습니다.
DATE YYYYMMDD 형식의 날짜입니다 (예: '20210701').
CAMPAIGN_ID 캠페인의 고유 ID입니다(예: '123456789'). campaign list API의 캠페인 ID와 일치합니다.
CAMPAIGN_NAME 캠페인의 이름입니다.
AD_ID 광고의 고유 ID입니다(예: '123456789').
AD_NAME 광고의 이름으로, 고유하지 않을 수 있습니다.
PLACEMENT_ID 광고가 게재되는 앱의 공급업체별 고유 ID입니다. 예를 들어 Android의 경우 com.goog.bar, iOS 앱의 경우 123456789입니다.
PLACEMENT_NAME 광고가 배치된 앱의 이름입니다.
PLACEMENT_PLATFORM 광고가 게재되는 앱의 플랫폼입니다.
COUNTRY 타겟 국가의 이름입니다.
FORMAT 광고 단위의 형식 (예: '배너', '네이티브')이며 광고 게재 측정기준입니다.

측정항목

캠페인 보고서의 측정항목입니다.

열거형
METRIC_UNSPECIFIED 설정되지 않은 필드의 기본값입니다. 사용하지 않습니다.
IMPRESSIONS 광고가 사용자에게 표시된 횟수입니다.
CLICKS 사용자가 광고를 클릭한 횟수입니다.
CLICK_THROUGH_RATE 광고 클릭수를 광고가 게재된 횟수로 나눈 값입니다.
INSTALLS 앱이 기기에 다운로드된 횟수입니다.
ESTIMATED_COST 수익이 발생하는 광고 대신 캠페인 광고를 게재하는 데 드는 예상 비용입니다. 통화는 캠페인의 보고 통화입니다.
AVERAGE_CPI 평균 설치당비용(CPI) 신규 사용자를 획득하는 데 지출한 평균 금액을 의미합니다. 통화는 캠페인의 보고 통화입니다.
INTERACTIONS 사용자가 광고와 상호작용한 횟수입니다. 클릭수 및 사용자 참여수로 구성됩니다.