광고 활동 보고서는 광고 실적을 한곳에서 확인할 수 있습니다. 데이터, 측정항목, 미디에이션 보고서 API의 측정기준 및 입찰 데이터를 하나의 통합 보고서로 얻을 수 있습니다.
광고 활동 보고서 API를 통해 미디에이션 기능이 더욱 향상됨 Report API 및 Network Report API는 아래 표에 나와 있습니다.
| 네트워크 보고서 API | 미디에이션 보고서 API | 광고 활동 보고서 API | |
|---|---|---|---|
| 네트워크 성능 | ✅ | ✅ | ✅ |
| 폭포식 구조 성능 | ✅ | ✅ | |
| 입찰 실적 | ✅ | ||
| 미디에이션 A/B 실험 실적 | ✅ | ||
| 시간별 보고 | ✅ | ||
| 보고서 크기 | 10만 | 10만 | 50만 |
측정항목, 측정기준, 측정기준 필터
다음 측정항목이 네트워크 보고서 API 및 미디에이션 보고서 API
| 측정항목 | 설명 |
|---|---|
| BID_REQUEST | 입찰 광고 소스에 대한 요청 수입니다. |
| BIDS_IN_AUCTION | 입찰 경매에 참여한 광고 소스가 제출한 입찰 수입니다. |
| WINNING_BIDS | 입찰 경매에서 낙찰된 입찰의 수입니다. |
Ads Activity Report API에는 다음과 같은 새로운 측정기준이 포함됩니다.
| 측정기준 | 설명 |
|---|---|
| WEEK | 한 주의 첫째 날 (영어로 되어 있는 YYYYMMDD 형식( 예: '20210701') 요청은 DATE, WEEK 또는 MONTH 중 하나만 지정할 수 있습니다. 시간 측정기준입니다. |
| HOUR | 태평양 표준시 기준 HH 형식의 시간입니다. 예: '05' 오전 5시(PST), '13' 오후 1시(태평양 표준시)에 이용할 수 있습니다. DATE 측정기준도 요청에 지정해야 합니다. 가 HOUR 측정기준이 지정된 경우 최대 28일간의 데이터가 반환됩니다. 현재 날짜로부터 28일 이상 이전인 기간 시작일 오류가 반환됩니다. |
| MEDIATION_AB_TEST (실험 이름) | 미디에이션 A/B 테스트별로 실적을 표시합니다. 이 매개변수는 반드시 VARIANT 차원이 지정된 경우 |
| MEDIATION_AB_TEST_VARIANT (대안 A, 대안 B) | 미디에이션 A/B 테스트 대안별로 실적을 확인하세요. |
| 미디에이션 보고서 API의 측정기준 이름 | Ads Activity Report API의 측정기준 이름 | 설명 |
|---|---|---|
| 광고_단위1 | AD_UNIT_ID | 광고 단위의 고유 ID입니다 (예: '123456789'). |
| AD_UNIT_NAME | 광고 단위의 이름입니다. | |
| 앱1 | APP_ID | 모바일 애플리케이션의 고유 ID입니다 (예: '1234567890'). |
| APP_NAME | 앱 이름입니다. | |
| 광고 소스1 | AD_SOURCE_ID | 광고 소스의 고유 ID입니다 (예: '1234567890123456789'). |
| AD_SOURCE_NAME | 광고 소스의 이름입니다 (예: 'AdMob 네트워크'). | |
| AD_소스_인스턴스1 | AD_SOURCE_INSTANCE_ID | 광고 소스 인스턴스의 고유 ID입니다 (예: '123456789012'). |
| AD_SOURCE_INSTANCE_NAME | 광고 소스 인스턴스의 이름입니다 (예: 'AdMob (기본)'). | |
| 미디어 그룹1 | MEDIATION_GROUP_ID | 미디에이션 그룹의 고유 ID입니다 (예: '1234567890'). |
| MEDIATION_GROUP_NAME | 미디에이션 그룹의 고유 ID입니다 (예: 'AdMob (기본)'). |
1: 자세한 내용은 Scalars를 참조하세요.
다음 측정기준의 형식이 업데이트되었습니다.
| 미디에이션 보고서 API의 측정기준 이름 | 미디에이션 보고서 API의 설명 | Ads Activity Report API의 설명 |
|---|---|---|
| ESTIMATED_EARNINGS | AdMob 게시자의 예상 수입입니다. 통화 단위 (USD,
EUR 또는 기타)은 현지화에 따라 결정됩니다.
통화 설정입니다. 금액은 마이크로 단위입니다. 예를 들어 6.50달러는
6500000으로 표시됩니다
미디에이션 그룹 및 광고 소스 인스턴스 수준당 예상 수입: 2019년 10월 20일부터 지원됩니다 서드 파티 예상 수입은 2019년 10월 20일 이전의 날짜는 0으로 표시됩니다. |
AdMob 게시자의 예상 수입입니다. 통화 단위 (USD, EUR 또는 기타)은 현지화에 따라 결정됩니다. 통화 설정입니다. |
| OBSERVED_ECPM | 제3자 광고 네트워크의 예상 평균 eCPM입니다. 통화 단위
수익 측정항목의 (USD, EUR 등)은 현지화에 따라 결정됩니다.
통화 설정입니다. 금액은 마이크로 단위입니다. 예를 들어 2.30달러는
2300000으로 표시됩니다.
미디에이션 그룹 및 광고 소스 인스턴스 수준당 예상 평균 eCPM 2019년 10월 20일부터 지원됩니다 서드 파티 예상 평균 2019년 10월 20일 이전의 eCPM은 0으로 표시됩니다. |
모든 광고의 평균 eCPM입니다. 통화 단위 (USD, EUR 또는 기타)
수입 측정항목은 통화의 현지화 설정에 따라 결정됩니다.
미디에이션 그룹 및 광고 소스 인스턴스 수준당 평균 eCPM은 다음과 같습니다. 2019년 10월 20일부터 지원됩니다 OBSERVED_ECPM은 날짜에 0으로 표시됩니다. 2019년 10월 20일 이전까지 확인할 수 있습니다 |
스칼라
아래 측정기준은 Ads Activity Report API에서 다음과 같이 업데이트되었습니다. 스칼라 값을 사용합니다. 그러면 응답이 단순해지고 있습니다.
Mediation Report API 및 Network Report API에서 영향을 받는 측정기준은 다음과 같습니다.
AD_UNITAPPAD_SOURCEAD_SOURCE_INSTANCEMEDIATION_GROUP
| 샘플 보고서 응답 데이터 | |
|---|---|
| 미디에이션 / 네트워크 API 측정기준 형식 | "AD_UNIT": {
"value":"ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY",
"displayLabel": "Test ad unit name"
} |
| AAR API 측정기준 형식 | "AD_UNIT_NAME": "Test ad unit name", "AD_UNIT_ID": "ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY" |
시간별 보고
이제 AdMob API에서 시간별로 실적을 확인할 수 있습니다. 시간별 보고 최대 28일 동안 사용할 수 있습니다
시간별 데이터를 가져오려면 요청에 DATE 측정기준도 지정해야 합니다. 데이터를 수집하는 데 사용됩니다 HOUR 측정기준이 다음과 같은 경우 최대 28일간의 데이터가 반환됩니다. 지정합니다. 기간의 시작일은 현재 날짜가 오류를 반환합니다.
보고서 크기 확대
Ads Activity Report API를 사용하면 총 500,000개의 행을 검색할 수 있습니다. 대상 자세한 내용은 할당량 가이드를 참조하세요.
요청하기
요청하려면 다음 단계를 따르세요.
curl (명령줄)
curl을 사용하는 요청
클라이언트 보안 비밀 파일을 로드하고 승인 사용자 인증 정보를 생성합니다.
이 단계를 처음 수행하면 확인 메시지가 표시됩니다. 수락하기 전에 다음 사항을 확인하세요. AdMob API에 액세스할 수 있는 Google 계정으로 로그인해야 합니다. 내 애플리케이션은 어떤 경우에든 대신하여 데이터에 액세스할 수 있도록 승인됩니다. 계정이 현재 로그인되어 있습니다.
인증 및 승인에는 oauth2l, Google OAuth 2.0을 사용할 수 있습니다 oauth2l을 설치하고 아래 명령어로 path_to_credentials_json를 경로로 바꿉니다. 등록 시 다운로드하는
credentials.json파일에 추가하세요. 살펴보겠습니다 첫 번째 실행의 경우, 명령어는 OAuth 2.0 승인 흐름 후속 실행에서는 토큰이 새로고침됩니다. 자동으로 확장 및 축소할 수 있습니다~/go/bin/oauth2l header --json path_to_credentials_json \ https://www.googleapis.com/auth/admob.readonly광고 활동 보고서를 생성합니다.
curl -X POST https://admob.googleapis.com/v1alpha/accounts/pub-XXXXXXXXXXXXXXXX/adsActivityReport:generate \ -H "Content-Type: application/json" \ -H "$(~/go/bin/oauth2l header --json path_to_credentials_json https://www.googleapis.com/auth/admob.readonly)" --data @- << EOF { "report_spec": { "date_range": { "start_date": {"year": 2023, "month": 1, "day": 1}, "end_date": {"year": 2023, "month": 1, "day": 2} }, "dimensions": ["DATE", "HOUR", "MEDIATION_AB_TEST", "VARIANT", "AD_SOURCE_ID", "AD_SOURCE_NAME"], "metrics": ["CLICKS", "BID_REQUEST","WINNING_BIDS", "IMPRESSIONS", "ESTIMATED_EARNINGS" ], "dimension_filters": [{"dimension": "COUNTRY", "matches_any": {"values": ["US"]}}], "sort_conditions": [{"metric":"CLICKS", "order": "DESCENDING"}], "localization_settings": {"currency_code": "USD", "language_code": "en-US"} } } EOF샘플 응답:
{ "rows": [ { "dimensionValues": { "DATE": { "value": "20221102" }, "HOUR": { "value": "23" }, "MEDIATION_AB_TEST": { "value": "Mediation AB Test" }, "VARIANT": { "value": "Variant A" }, "AD_SOURCE_ID": { "value": "5450213213286189855" }, "AD_SOURCE_NAME": { "value": "AdMob Network" } }, "metricValues": { "CLICKS": { "doubleValue": 0 }, "BID_REQUEST": { "integerValue": "27" }, "WINNING_BIDS": { "doubleValue": 0.1111111111111111 }, "IMPRESSIONS": { "integerValue": "2" }, "ESTIMATED_EARNINGS": { "doubleValue": 0 } } }, { "dimensionValues": { "DATE": { "value": "20221102" }, "HOUR": { "value": "23" }, "MEDIATION_AB_TEST": { "value": "Mediation AB Test" }, "VARIANT": { "value": "Variant B" }, "AD_SOURCE_ID": { "value": "5450213213286189855" }, "AD_SOURCE_NAME": { "value": "AdMob Network" } }, "metricValues": { "CLICKS": { "doubleValue": 1 }, "BID_REQUEST": { "integerValue": "6" }, "WINNING_BIDS": { "doubleValue": 1 }, "IMPRESSIONS": { "integerValue": "3" }, "ESTIMATED_EARNINGS": { "doubleValue": 0.000427519 } } } ]}