Google Ad Manager는 LineItems과 같은 트래피킹 엔티티를 보고 및 조작하기 위한 SOAP API를 제공합니다.
클라이언트 라이브러리는 여러 언어로 제공됩니다. AdX 판매자 API와 마찬가지로, Ad Manager API는 인증에 OAuth2를 사용합니다.
첫 번째 API 요청을 시작하려면 시작하기를 참조하세요.
Ad Manager API의 보고
Ad Manager API ReportService는 두 가지 방법으로 보고서를 실행하고 다운로드할 수 있도록 지원합니다.
- UI에서 쿼리를 만들고 ID를 기반으로 실행
- 임시 ReportQuery 구성
어느 방법을 사용하든 API 워크플로는 다음 네 단계로 구성됩니다.
- runReportJob을 호출합니다.
- getReportJobStatus를 사용하여 보고서 상태를 폴링합니다.
- getReportDownloadUrlWithOptions를 사용하여 완료된 보고서의 URL을 가져옵니다.
- 반환된 URL에서 보고서를 다운로드합니다.
자세한 내용은 보고 가이드를 참고하세요.
보고 시간대
Ad Exchange 판매자 REST API와 달리 Ad Manager API 보고서는 기본적으로 네트워크의
시간대로 설정됩니다. 이를 변경하려면 TimeZoneType 필드를 설정합니다.
AdX에서 Ad Manager로 측정항목 및 측정기준 매핑
지원되는 모든 Ad Exchange 판매자 REST API 측정항목 및 측정기준이 이제 Ad Manager Reporting API에서 제공됩니다. 일부 이름은 변경되었으며 일부는 지원 중단되었습니다. 자세한 내용은 아래 표를 참고하세요.
측정항목 / 열
이 표는 AdX 측정항목과 Ad Manager 열을 보여줍니다.
| AdX 측정항목 | Ad Manager 열 | Ad Manager 검색어 도구 이름 |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Active View 대상 노출수 |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Active View 측정 노출수 |
| ACTIVE_VIEW_MEASURABLE_RATIO | (지원 중단됨) | (지원 중단됨) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | Active View 조회 노출수 |
| ACTIVE_VIEW_VIEWABLE_RATIO | (지원 중단됨) | (지원 중단됨) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | 평균 조회 가능 시간 (초) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | 광고 노출수 |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | 광고 eCPM |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | 광고 요청 |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | 범위 |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | 광고 요청 CTR |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | 광고 요청 eCPM |
| 클릭수 | AD_EXCHANGE_CLICKS | 클릭수 |
| COST_PER_CLICK | AD_EXCHANGE_CPC | CPC |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | 거래 광고 요청 |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | 거래 입찰 응답 |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | 거래 일치율 |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | 거래 게재된 요청 |
| 수익 | AD_EXCHANGE_ESTIMATED_REVENUE | 예상 수익 |
| INDIVIDUAL_AD_IMPRESSIONS | (지원 중단됨) | (지원 중단됨) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | 광고 클릭률(CTR) |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (새 권장사항) AD_EXCHANGE_AD_ECPM | (새 추천) 광고 eCPM |
| LIFT_RATE | AD_EXCHANGE_LIFT | 올리기 |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | 게재된 요청 |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | 일치하는 eCPM |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | 동영상 이탈률 |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | 동영상 감소율 |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | 동영상 1사분위 |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | 동영상 3사분위 |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | TrueView 건너뛰기 비율 |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | TrueView 조회수 |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | TrueView VTR |
크기
이 표는 AdX 측정기준과 Ad Manager 측정기준을 매핑한 것입니다.
| AdX 측정기준 | Ad Manager 측정기준 | Ad Manager 검색어 도구 이름 |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | 웹 속성 |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | 광고 위치 |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | 태그 |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (사용할 수 없음) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | 인벤토리 크기 |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | 광고주 도메인 |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | 광고주 |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | 광고주 카테고리 |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | 대행사 |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (사용할 수 없음) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | 브랜드 |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (사용할 수 없음) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | 브랜드 유형 |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (사용할 수 없음) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | 구매자 네트워크 |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (사용할 수 없음) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | 국가 |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | 광고 소재 크기 |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (사용할 수 없음) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (사용할 수 없음) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | 채널 |
| 날짜 | AD_EXCHANGE_DATE | 일 |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | 거래 ID |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | 거래 이름 |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (사용할 수 없음) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | DFP 광고 단위 |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | 요청 소스 |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | 사이트 도구 |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | DSP |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | 확장형 유형 |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | 인벤토리 소유권 |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | 네트워크 파트너 이름 |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | 앱 이름 |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | 이동통신사 이름 |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | 기기 |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | 인벤토리 유형 |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | 운영체제 |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | 대역폭 |
| MONTH | AD_EXCHANGE_MONTH | 개월 |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | 기기 카테고리 |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (사용할 수 없음) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | 제품 |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (사용할 수 없음) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | 타겟팅 유형 |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (사용할 수 없음) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | 거래 유형 |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (사용할 수 없음) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URL |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (사용할 수 없음) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | 동영상 광고 길이 |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | 동영상 광고 유형 |
| WEEK | AD_EXCHANGE_WEEK | 주 |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (사용할 수 없음) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | 가격 책정 규칙 |