Google Ad Manager cung cấp một API SOAP cho cả việc báo cáo và thao tác với các thực thể quản lý quảng cáo, chẳng hạn như LineItems.
Thư viện ứng dụng có sẵn bằng nhiều ngôn ngữ. Giống như AdX Seller API, Ad Manager API sử dụng OAuth2 để xác thực.
Để bắt đầu với yêu cầu API đầu tiên, hãy xem phần Bắt đầu.
Báo cáo trong API Ad Manager
ReportService của API Ad Manager cung cấp hai cách chạy và tải báo cáo xuống:
- Tạo một truy vấn trong giao diện người dùng và chạy truy vấn đó dựa trên mã nhận dạng của truy vấn.
- Tạo một ReportQuery theo nhu cầu.
Với một trong hai lựa chọn này, quy trình API bao gồm 4 bước:
- Gọi runReportJob.
- Lấy trạng thái báo cáo bằng cách sử dụng getReportJobStatus.
- Lấy URL của báo cáo đã hoàn tất bằng cách sử dụng getReportDownloadUrlWithOptions.
- Tải báo cáo xuống từ URL được trả về.
Để biết thêm thông tin chi tiết, hãy xem hướng dẫn báo cáo.
Múi giờ báo cáo
Không giống như Ad Exchange Seller REST API, trong Ad Manager API, báo cáo mặc định sẽ theo múi giờ của mạng. Để thay đổi chế độ này, hãy đặt trường TimeZoneType.
Mối liên kết giữa chỉ số và phương diện của AdX với Ad Manager
Tất cả các chỉ số và phương diện được hỗ trợ trong Ad Exchange Seller API REST hiện đều có trong Ad Manager Reporting API. Một số tên đã thay đổi và một số tên đã ngừng hoạt động. Vui lòng xem các bảng bên dưới để biết thông tin chi tiết.
Chỉ số / Cột
Bảng này liên kết các Chỉ số AdX với Cột Ad Manager.
| Chỉ số AdX | Cột Ad Manager | Tên Công cụ truy vấn của Ad Manager |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Số lượt hiển thị được bật trong chế độ xem đang kích hoạt |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Số lượt hiển thị được đo lường bằng Active View |
| ACTIVE_VIEW_MEASURABLE_RATIO | (không dùng nữa) | (không dùng nữa) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | Số lượt hiển thị được xem theo Active View |
| ACTIVE_VIEW_VIEWABLE_RATIO | (không dùng nữa) | (không dùng nữa) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | Thời gian trung bình có thể xem (giây) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | Số lần hiển thị quảng cáo |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | eCPM của quảng cáo |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | Yêu cầu quảng cáo |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | Phạm vi tổng hợp dữ liệu |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | CTR yêu cầu quảng cáo |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | RPM yêu cầu quảng cáo |
| SỐ NHẤP CHUỘT | AD_EXCHANGE_CLICKS | Số lượt nhấp |
| COST_PER_CLICK | AD_EXCHANGE_CPC | CPC |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | Yêu cầu quảng cáo của giao dịch |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | Phản hồi giá thầu của giao dịch |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | Tỷ lệ khớp của giao dịch |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Số yêu cầu được so khớp của giao dịch |
| THU NHẬP | AD_EXCHANGE_ESTIMATED_REVENUE | Doanh thu ước tính |
| INDIVIDUAL_AD_IMPRESSIONS | (không dùng nữa) | (không dùng nữa) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | CTR của Quảng Cáo |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (đề xuất mới) AD_EXCHANGE_AD_ECPM | (đề xuất mới) eCPM của quảng cáo |
| LIFT_RATE | AD_EXCHANGE_LIFT | Tăng lên |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | Yêu cầu được so khớp |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | eCPM được khớp |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | Tỷ lệ bỏ ngang video |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | Tỷ lệ bỏ qua video |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | Phần tư video 1 |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | Phần tư video 3 |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | Tỷ lệ bỏ qua TrueView |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | Số lượt xem theo TrueView |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | VTR TrueView |
Kích thước
Bảng này liên kết các phương diện AdX với các phương diện Ad Manager .
| Phương diện AdX | Phương diện Ad Manager | Tên Công cụ truy vấn của Ad Manager |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | Tài sản web |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | Vị trí quảng cáo |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | Thẻ |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (Không có) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | Kích thước khoảng không quảng cáo |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | Các miền của nhà quảng cáo |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | Nhà quảng cáo |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | Ngành dọc của nhà quảng cáo |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | Đại lý |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (Không có) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | Thương hiệu |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (Không có) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | Loại xây dựng thương hiệu |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (Không có) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | Mạng người mua |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (Không có) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | Quốc gia |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | Kích thước mẫu quảng cáo |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (Không có) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (Không có) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | Kênh |
| DATE | AD_EXCHANGE_DATE | Ngày |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | Mã giao dịch |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | Tên giao dịch |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (Không có) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | Đơn vị quảng cáo DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | Nguồn yêu cầu |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | Sites |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | DSP |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | Các loại có thể mở rộng |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | Quyền sở hữu khoảng không quảng cáo |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | Tên đối tác mạng |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | Tên ứng dụng |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | Tên hãng vận chuyển |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | Thiết bị |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | Các loại khoảng không quảng cáo |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | Hệ điều hành |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | Dải thông |
| THÁNG | AD_EXCHANGE_MONTH | Tháng |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | Danh mục thiết bị |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (Không có) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | Sản phẩm |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (Không có) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | Loại nhắm mục tiêu |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (Không có) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | Loại giao dịch |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (Không có) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URL |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (Không có) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | Thời lượng quảng cáo dạng video |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | Loại quảng cáo dạng video |
| TUẦN | AD_EXCHANGE_WEEK | Tuần |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (Không có) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | Quy tắc đặt giá |