보고

AdSense Management API를 사용하면 새 AdMob 계정의 보고서를 실행할 수 있습니다.

개념

다음은 AdMob에 적용되는 몇 가지 중요한 컨셉입니다.

계정
애드센스 계정에는 pub-xxxxxxxxxxxxxxxx 형식의 ID가 있습니다. AdSense Management API 참조에 기재된 대부분의 엔드포인트에 액세스하려면 이 ID가 필요합니다. AdMob UI에 접속한 후 설정 페이지의 계정 정보에서 게시자 ID를 찾을 수 있습니다.
광고 클라이언트
광고 클라이언트는 광고와 제품 간의 관계를 지정합니다. 새 AdMob 계정은 ca-app-pub-xxxxxxxxxxxxxxxx 형식의 광고 클라이언트 ID와 함께 제공됩니다. AdSense Management API의 Accounts.adclients.list를 호출하면 광고 클라이언트를 가져올 수 있습니다. AdMob 보고가 필요할 때 항상 이 광고 클라이언트 ID를 사용하세요.
광고 단위

광고 단위는 광고의 개별 자리표시자를 정의합니다. AdSense Management API에서 사용하려면 ca-app-pub-xxxxxxxxxxxxxxxx:nnnnnnnnnn을 변경하세요. AdMob UI에 접속한 후 앱 > 내 앱 > 광고 단위 > 광고 단위 ID에서 광고 단위 ID를 확인할 수 있습니다.

API에서 Accounts.adunits.list 호출을 사용해 광고 단위를 가져올 수도 있습니다.

AdSense Management API 설명서에는 참고할 수 있는 다양한 샘플이 있습니다.

측정기준

다음 측정기준은 AdMob에만 해당합니다.

AdSense API 및 해당 AdMob 측정기준
AD_CLIENT_ID 게시자 ID

광고 클라이언트의 ID

예: ca-app-pub-1234567890123456

AD_UNIT_CODE 광고 단위 ID

광고 단위의 코드. 이 값은 광고 클라이언트마다 고유하지 않을 수 있습니다.

예: 1234567890

AD_UNIT_NAME 광고 단위 이름

광고 단위의 이름

예: '내 배너 이름'

AD_UNIT_SIZE_CODE 형식(코드)

광고 단위의 형식

예: banner, native

AD_UNIT_SIZE_NAME 형식(이름)

광고 단위의 형식 이름

예: Banner, Native advanced

APP_NAME

앱의 이름. 이 필드에는 최대 80자까지만 표시되며, 앱 스토어에서 앱 이름이 변경되어도 업데이트되지 않습니다.

예: Line Up, Flood-It!

APP_ID Google Play ID/iOS 번들 ID

앱의 Google Play ID(접두사: 2:) 또는 iOS 번들 ID(접두사: 1:)

예: 2:com.labpixies.lineup, 1:476954712

APP_PLATFORM 플랫폼

앱 플랫폼

예: Android, iOS

BID_TYPE_CODE

입찰 유형(코드)

입찰가의 유형

예: cpc, cpm

BID_TYPE_NAME 입찰 유형(이름)

입찰 유형 이름

예: CPC bids, CPM bids

COUNTRY_CODE

국가(코드)

CLDR 지역 코드

예: US, FR

COUNTRY_NAME

국가(이름)

지역 이름

예: United States, France

DATE

날짜

날짜 형식(YYYYMMDD)

MONTH

월 형식(YYYYMM)

PLATFORM_TYPE_CODE 기기(코드)

플랫폼 유형 코드

예: HighEndMobile, Tablet

PLATFORM_TYPE_NAME 기기(이름)

플랫폼 유형 이름

예: High-end mobile devices, Tablets

PRODUCT_NAME 제품

제품 이름

예: AdMob (Mobile Applications), AdSense for Search

WEEK

일주일에서 첫 번째 날의 날짜의 형식(YYYYMMDD)

통계

AdMob에서 사용되는 측정항목은 다음과 같습니다.

AdSense API 및 해당 AdMob 측정항목
EARNINGS AdMob 네트워크 예상 수입

태평양 표준시(PT)를 기준으로 지금까지 발생한 수입입니다. 이 금액은 예상 금액이므로 월말에 확정되는 최종 수입과 다를 수 있습니다.

REACHED_AD_REQUESTS AdMob 네트워크 요청수

실제 광고 게재 요청을 전송하는 앱 요청의 총 수입니다.

최대 게재빈도 설정이나 사용자 타겟팅과 같은 특정 플랫폼 기능으로 필터링되는 광고 요청은 여기에 합산되지 않습니다.

MATCHED_REACHED_AD_REQUESTS 게재된 요청수

앱의 요청에 따라 광고가 게재된 횟수입니다.

VIEWED_IMPRESSIONS 노출수

내 앱의 사용자에게 광고가 게재된 총 횟수입니다.

CLICKS 클릭수

사용자가 광고를 클릭한 횟수입니다.

REACHED_AD_REQUESTS_MATCH_RATE 일치율

광고가 게재된 광고 요청의 비율입니다. 이 값을 구하는 공식은 '게재된 요청수/AdMob 네트워크 요청수'입니다.

예: 앱의 게재된 요청수가 40회이고 해당 앱에 대한 총 AdMob 네트워크 요청수가 50회이면 앱의 일치율은 80%입니다.

REACHED_AD_REQUESTS_SHOW_RATE 노출률

앱에서 사용자에게 게재된 광고의 비율입니다. 구하는 공식은 '노출수/게재된 요청수'입니다.

예: 총 게재된 요청수가 80회이지만 이중 60회에서만 앱에 광고가 게재되었으면 앱의 노출률은 75%입니다.

AdMob 수익만 확인하려면 AdMob 계정 ID로 필터를 설정하세요. 예를 들면 다음과 같습니다.

filter: "AD_CLIENT_ID==ca-app-pub-xxxxxxxxxxxxxxxx"
    

마찬가지로 앱 하나의 수익을 확인하려는 경우에도 앱 ID를 사용해 필터를 설정하세요. 예를 들면 다음과 같습니다.

filter: "APP_ID==2:com.labpixies.lineup"