Google Ad Manager는 LineItems와 같은 트래피킹 항목을 보고하고 조작할 수 있는 SOAP API를 제공합니다.
클라이언트 라이브러리는 여러 언어로 제공됩니다. AdX Seller API와 마찬가지로 Ad Manager API는 인증에 OAuth2를 사용합니다.
첫 번째 API 요청을 시작하려면 시작하기를 참고하세요.
Ad Manager API의 보고
Ad Manager API ReportService는 보고서를 실행하고 다운로드하는 두 가지 방법을 제공합니다.
- UI에서 쿼리를 만들고 ID를 기반으로 실행합니다.
- ReportQuery를 임시로 구성합니다.
두 옵션 모두 API 워크플로는 다음 네 단계로 구성됩니다.
- I can call runReportJob.
- getReportJobStatus를 사용하여 보고서 상태를 폴링합니다.
- getReportDownloadUrlWithOptions를 사용하여 완료된 보고서의 URL을 가져옵니다.
- 반환된 URL에서 보고서를 다운로드합니다.
자세한 내용은 보고 가이드를 참고하세요.
보고 시간대
Ad Exchange Seller REST API와 달리 Ad Manager API 보고서는 기본적으로 네트워크의 시간대를 사용합니다. 이를 변경하려면 TimeZoneType 필드를 설정합니다.
AdX에서 Ad Manager로의 측정항목 및 측정기준 매핑
지원되는 모든 Ad Exchange Seller 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 | 대역폭 |
| 월 | 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 | 가격 책정 규칙 |