Google Ad Manager cung cấp API SOAP cho 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 hỗ trợ một số ngôn ngữ. Giống như API người bán AdX, API Ad Manager sử dụng OAuth2 để xác thực.
Để bắt đầu với yêu cầu API đầu tiên của bạn, hãy xem phần Bắt đầu.
Báo cáo trong API Ad Manager
ReportService 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 đó.
- Xây dựng một ReportQuery đặc biệt.
Dù chọn cách nào, quy trình làm việc của API sẽ bao gồm bốn bước:
- Gọi runReportJob.
- Thăm dò trạng thái báo cáo bằng getReportJobStatus.
- Lấy URL đến báo cáo hoàn chỉnh 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, hãy xem hướng dẫn về báo cáo.
Múi giờ báo cáo
Không giống như API REST người bán trên Ad Exchange, trong API Ad Manager, báo cáo được đặt mặc định theo múi giờ trong mạng của bạn. Để thay đổi điều này, hãy đặt trường TimeZoneType.
Liên kết phương diện và chỉ số AdX đến Ad Manager
Tất cả các chỉ số và phương diện API REST người bán trên Ad Exchange được hỗ trợ hiện đều có trong API báo cáo Ad Manager. Một số tên đã thay đổi và ngừng sử dụng một vài tên. 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ác cột trên Ad Manager.
| Chỉ số AdX | Cột Ad Manager | Tên công cụ truy vấn Ad Manager |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Hiển thị được bật trong chế độ xem đang kích hoạt |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Hiển thị được đo lường trong chế độ xem đang kích hoạt |
| 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 | Hiển thị được xem trong chế độ xem đang kích hoạt |
| 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ượt 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 | Số 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 | eCPM của yêu cầu quảng cáo |
| SỐ LƯỢT NHẤP | AD_EXCHANGE_CLICKS | 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 | Yêu cầu đã 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 | Nâng lên |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | Số yêu cầu đã 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 | Lượt xem 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 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 Ad Manager |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | Thuộc tính 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 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 |
| NGÀY | AD_EXCHANGE_DATE | Ngày |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | Mã giao dịch |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | Tên ưu đãi |
| 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 | Trang web |
| 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 nhà mạng |
| 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 | Băng 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 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á |